com.avaje.ebean

Class Finder<I,T>

java.lang.Object

com.avaje.ebean.Finder<I,T>

public class Finder<I,T>
extends Object

Intended to be used as a base class for 'Finder' implementations that can then be injected or used as public static fields on the associated entity bean.

These 'finders' are a place to organise all the finder methods for that bean type and specific finder methods are expected to be added (find by unique properties etc).

Testing

For testing the mocki-ebean project has the ability to replace the finder implementation

public class CustomerFinder extends Finder<Customer> {

  public CustomerFinder() {
    super(Customer.class);
  }

  // Add your customer finder methods ...

  public Customer byName(String name) {
    return query().eq("name", name).findUnique();
  }

  public List<Customer> findNew() {
    return query()
      .eq("status", Customer.Status.NEW)
      .orderBy("name")
      .findList()
  }
}

@Entity
public class Customer extends BaseModel {

  public static final CustomerFinder find = new CustomerFinder();
  ...

Constructor Summary

Constructors

Constructor and Description
Finder(Class<T> type) Create with the type of the entity bean.
Finder(Class<T> type, String serverName) Create with the type of the entity bean and specific server name.

Method Summary

Modifier and Type	Method and Description
List<T>	all() Retrieves all entities of the given type.
T	byId(I id) Retrieves an entity by ID.
EbeanServer	db() Return the underlying 'default' EbeanServer.
EbeanServer	db(String server) Return typically a different EbeanServer to the default.
void	deleteById(I id) Delete a bean by Id.
Query<T>	query() Creates a query.
T	ref(I id) Creates an entity reference for this ID.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Finder

public Finder(Class<T> type)

Create with the type of the entity bean.

public class CustomerFinder extends Finder<Customer> {

  public CustomerFinder() {
    super(Customer.class);
  }

  // ... add extra customer specific finder methods
}

@Entity
public class Customer extends BaseModel {

  public static final CustomerFinder find = new CustomerFinder();
  ...

Finder

public Finder(Class<T> type,
              String serverName)

Create with the type of the entity bean and specific server name.

Method Detail

db

public EbeanServer db()

Return the underlying 'default' EbeanServer.

This provides full access to the API such as explicit transaction demarcation etc.

db

public EbeanServer db(String server)

Return typically a different EbeanServer to the default.

This is equivalent to Ebean.getServer(String)

Parameters:

server - The name of the EbeanServer. If this is null then the default EbeanServer is returned.

ref

public T ref(I id)

Creates an entity reference for this ID.

Equivalent to EbeanServer.getReference(Class, Object)

byId

@Nullable
public T byId(I id)

Retrieves an entity by ID.

Equivalent to EbeanServer.find(Class, Object)

deleteById

public void deleteById(I id)

Delete a bean by Id.

Equivalent to EbeanServer.delete(Class, Object)

all

public List<T> all()

Retrieves all entities of the given type.

query

public Query<T> query()

Creates a query.

Equivalent to EbeanServer.find(Class)