org.ow2.dragon.persistence.dao
Interface GenericUnifiedDAO<T,PK extends java.io.Serializable>

All Known Subinterfaces:

OrganizationUnitUnifiedDAO

All Known Implementing Classes:

GenericHibernateCompassDAOImpl, OrganizationUnitUnifiedDAOImpl

public interface GenericUnifiedDAO<T,PK extends java.io.Serializable>

An generic unified DAO that could be specialized to manage a specific Dragon entities. Unifies Compass and Hibernate apis. All method parameters must not be null by default.

Author:

ofabre - eBM Websourcing

Method Summary

int	count(com.trg.search.IMutableSearch search) Returns the total number of results that would be returned using the given ISearch if there were no paging or maxResult limits.
boolean	exists(PK id) Checks for existence of an object of type T using the id arg.
java.util.List<T>	findByNamedQuery(java.lang.String queryName, java.util.Map<java.lang.String,java.lang.Object> queryParams) Find a list of records by using a named query
T	get(PK id) Return the persistent instance of an entity with the given identifier, or null if not found.
java.util.List<T>	getAll() Generic method used to get all objects of a particular type.
java.util.List<T>	getAll(java.util.List<PK> ids) Retrieve a List of entities matching given ids
java.util.List<T>	getAll(java.util.List<PK> ids, RequestOptions requestOptions) Retrieve a List of entities matching given ids, sorted and paginated according to the given request options
java.util.List<T>	getAll(RequestOptions requestOptions) Generic method used to get all objects of a particular type, sorted and paginated according to the given request options.
java.util.List<T>	getAllDistinct() Gets all records without duplicates.
void	remove(PK id) Generic method to delete an object based on class and id
void	remove(T object) Generic method to delete an object
T	save(T object) Generic method to save an object - handles both update and insert.
java.util.List<T>	search(com.trg.search.IMutableSearch search) Search for objects based on the search parameters in the specified ISearch object.
java.util.List<T>	search(java.lang.String query) Return a List of entity managed by the Full Text Search Engine (Compass etc.).
com.trg.search.SearchResult<T>	searchAndCount(com.trg.search.IMutableSearch search) Returns a SearchResult object that includes the list of results like search() and the total length like searchLength.
java.util.List<T>	searchEquals(java.lang.String[] criteria, java.lang.String[] properties, RequestOptions requestOptions) This method allows to search Objects on String properties, fitting search criteria.
java.util.List<T>	searchLike(java.lang.String[] criteria, java.lang.String[] properties, RequestOptions requestOptions) This method allows to search Objects on String properties, fitting search criteria.
java.util.List<T>	searchORMResult(java.lang.String query) Process a research on Full Text Search Engine (Compass etc.) index and return a List of entity managed by the ORM engine (Hibernate, iBatis etc.).
java.util.List<T>	searchORMResult(java.lang.String[] criteria, java.lang.String[] searchedProperties) This method allows to search Objects on String properties, fitting search criteria.
java.util.List<T>	searchORMResult(java.lang.String[] criteria, java.lang.String[] searchedProperties, RequestOptions requestOptions) This method allows to search Objects on String properties, fitting search criteria.
java.util.List<T>	searchORMResult(java.lang.String query, RequestOptions requestOptions) Process a research on Full Text Search Engine (Compass etc.) index and return a List of entity managed by the ORM engine (Hibernate, iBatis etc.), sorted and paginated according to the given request options.
T	searchUnique(com.trg.search.IMutableSearch search) Search for a single result using the given parameters.

Method Detail

getAll

java.util.List<T> getAll(RequestOptions requestOptions)

Generic method used to get all objects of a particular type, sorted and paginated according to the given request options. This is the same as lookup up all rows in a table.

Parameters:

requestOptions - include sort order and pagination information, could be null

Returns:

List of populated objects

getAll

java.util.List<T> getAll()

Generic method used to get all objects of a particular type. This is the same as lookup up all rows in a table.

Returns:

List of populated objects

get

T get(PK id)

Return the persistent instance of an entity with the given identifier, or null if not found.

Parameters:

id - the identifier of the persistent instance

Returns:

the persistent instance, or null if not found

Throws:

org.springframework.dao.DataAccessException - in case of Hibernate errors

See Also:

Session.get(Class, java.io.Serializable)

exists

boolean exists(PK id)

Checks for existence of an object of type T using the id arg.

Parameters:

id - the id of the entity

Returns:

- true if it exists, false if it doesn't

save

T save(T object)

Generic method to save an object - handles both update and insert.

Parameters:

object - the object to save

Returns:

the persisted object

remove

void remove(PK id)

Generic method to delete an object based on class and id

Parameters:

id - the identifier (primary key) of the object to remove

remove

void remove(T object)

Generic method to delete an object

Parameters:

object - the object to remove

getAllDistinct

java.util.List<T> getAllDistinct()

Gets all records without duplicates.

Note that if you use this method, it is imperative that your model classes correctly implement the hashcode/equals methods

Returns:

List of populated objects

findByNamedQuery

java.util.List<T> findByNamedQuery(java.lang.String queryName,
                                   java.util.Map<java.lang.String,java.lang.Object> queryParams)

Find a list of records by using a named query

Parameters:

queryName - query name of the named query

queryParams - a map of the query names and the values

Returns:

a list of the records found

searchLike

java.util.List<T> searchLike(java.lang.String[] criteria,
                             java.lang.String[] properties,
                             RequestOptions requestOptions)

This method allows to search Objects on String properties, fitting search criteria. Properties can be direct object fields or fields of included objects (in this case, fields must be referenced by the doted notation like "foo.bar"). Use a like statement for each criteria on each property. Results are sorted and paginated in respect of the given request options.

Parameters:

criteria - the search criteria

properties - the searched properties

requestOptions - include sort order and pagination information, could be null

Returns:

a list of object matching the different criteria sorted and paginated

searchEquals

java.util.List<T> searchEquals(java.lang.String[] criteria,
                               java.lang.String[] properties,
                               RequestOptions requestOptions)

This method allows to search Objects on String properties, fitting search criteria. Properties can be direct object fields or fields of included objects (in this case, fields must be referenced by the doted notation like "foo.bar"). Use a equality statement for each criteria on each property. Results are sorted and paginated in respect of the given request options.

Parameters:

criteria - the search criteria

properties - the searched properties

requestOptions - include sort order and pagination information, could be null

Returns:

a list of object matching the different criteria sorted and paginated

search

java.util.List<T> search(java.lang.String query)

Return a List of entity managed by the Full Text Search Engine (Compass etc.). Only the search engine managed attributes of these entities are populated

Parameters:

query - a Lucene String query

Returns:

a List of entity managed by the Full Text Search Engine.

searchORMResult

java.util.List<T> searchORMResult(java.lang.String query)

Process a research on Full Text Search Engine (Compass etc.) index and return a List of entity managed by the ORM engine (Hibernate, iBatis etc.). All ORM managed attributes of these entities are populated.

Parameters:

query - a Lucene String query

Returns:

a List of entity managed by the ORM engine.

searchORMResult

java.util.List<T> searchORMResult(java.lang.String query,
                                  RequestOptions requestOptions)

Process a research on Full Text Search Engine (Compass etc.) index and return a List of entity managed by the ORM engine (Hibernate, iBatis etc.), sorted and paginated according to the given request options. All ORM managed attributes of these entities are populated.

Parameters:

query - a Lucene String query

requestOptions - include sort order and pagination information, could be null

Returns:

a List of entity managed by the ORM engine.

searchORMResult

java.util.List<T> searchORMResult(java.lang.String[] criteria,
                                  java.lang.String[] searchedProperties)
                                  throws DAOLayerException

This method allows to search Objects on String properties, fitting search criteria. Properties can be direct object fields or fields of included objects (in this case, fields must be referenced by the doted notation like "foo.bar"). Process a research on Full Text Search Engine (Compass etc.) index and return a List of entity managed by the ORM engine (Hibernate, iBatis etc.). All ORM managed attributes of these entities are populated.

Parameters:

criteria - the search criteria

properties - the searched properties

Returns:

a List of entity managed by the ORM engine.

Throws:

DAOLayerException

searchORMResult

java.util.List<T> searchORMResult(java.lang.String[] criteria,
                                  java.lang.String[] searchedProperties,
                                  RequestOptions requestOptions)
                                  throws DAOLayerException

This method allows to search Objects on String properties, fitting search criteria. Properties can be direct object fields or fields of included objects (in this case, fields must be referenced by the doted notation like "foo.bar"). Process a research on Full Text Search Engine (Compass etc.) index and return a List of entity managed by the ORM engine (Hibernate, iBatis etc.), sorted and paginated according to the given request options. All ORM managed attributes of these entities are populated.

Parameters:

criteria - the search criteria

properties - the searched properties

requestOptions - include sort order and pagination information, could be null

Returns:

a List of entity managed by the ORM engine.

Throws:

DAOLayerException - if criteria or searchedProperties are empty

getAll

java.util.List<T> getAll(java.util.List<PK> ids)

Retrieve a List of entities matching given ids

Parameters:

ids - a List of ids

Returns:

a List of entities matching ids, must be non null, could be empty

getAll

java.util.List<T> getAll(java.util.List<PK> ids,
                         RequestOptions requestOptions)

Retrieve a List of entities matching given ids, sorted and paginated according to the given request options

Parameters:

ids - a List of ids

requestOptions - include sort order and pagination information, could be null

Returns:

a sorted/paginated List of entities matching ids, must be non null, could be empty

search

java.util.List<T> search(com.trg.search.IMutableSearch search)

Search for objects based on the search parameters in the specified ISearch object.

See Also:

ISearch

count

int count(com.trg.search.IMutableSearch search)

Returns the total number of results that would be returned using the given ISearch if there were no paging or maxResult limits.

See Also:

ISearch

searchAndCount

com.trg.search.SearchResult<T> searchAndCount(com.trg.search.IMutableSearch search)

Returns a SearchResult object that includes the list of results like search() and the total length like searchLength.

See Also:

ISearch

searchUnique

T searchUnique(com.trg.search.IMutableSearch search)
               throws org.hibernate.NonUniqueResultException

Search for a single result using the given parameters.

Throws:

org.hibernate.NonUniqueResultException