DAODispatcher (Hibernate Generic DAO - DAO Hibernate 1.2.0 API)

java.lang.Object
- com.googlecode.genericdao.dao.BaseDAODispatcher
- - com.googlecode.genericdao.dao.hibernate.DAODispatcher

All Implemented Interfaces:

GeneralDAO
```
public class DAODispatcher
extends BaseDAODispatcher
implements GeneralDAO
```
This is an implementation of GeneralDAO that delegates to other DAOs depending on what entity class is being processed.
Set the specificDAOs Map in order to configure which DAO will be used for which entity class. If the map contains no entry for a given class, the generalDAO is used.
For example to dispatch operation on com.myproject.model.Customer to a DAO called customerDAO, set the map like this. (Of course tools like Spring can be used to do this configuration more elequently.)
```
 Map specificDAOs = new HashMap();
 specificDAOs.put("com.myproject.model.Customer", customerDAO);
 
 DAODispatcher dispatcher = new DAODispatcher();
 dispatcher.setSpecificDAOs(specificDAOs);
 
```
Author:

dwolverton

Field Summary

Fields
Modifier and Type Field and Description

protected GeneralDAO generalDAO
- Fields inherited from class com.googlecode.genericdao.dao.BaseDAODispatcher
  specificDAOs

Fields
Modifier and Type	Field and Description
`protected GeneralDAO`	`generalDAO`

Constructor Summary

Constructors
Constructor and Description

DAODispatcher()

Constructors
Constructor and Description
`DAODispatcher()`

Method Summary

Methods
Modifier and Type	Method and Description
`int`	`count(ISearch search)` Returns the total number of results that would be returned using the given `ISearch` if there were no paging or maxResults limits.
`<T> T[]`	`find(Class<T> type, Serializable... ids)` Get all entities of the specified type from the datastore that have one of these ids.
`<T> T`	`find(Class<T> type, Serializable id)` Get the entity with the specified type and id from the datastore.
`<T> List<T>`	`findAll(Class<T> type)` Get a list of all the objects of the specified type.
`void`	`flush()` Deprecated. use flush(Class)
`void`	`flush(Class<?> klass)`
`Filter`	`getFilterFromExample(Object example)` Generates a search filter from the given example using default options.
`Filter`	`getFilterFromExample(Object example, ExampleOptions options)` Generates a search filter from the given example using the specified options.
`<T> T`	`getReference(Class<T> type, Serializable id)` Get a reference to the entity with the specified type and id from the datastore.
`<T> T[]`	`getReferences(Class<T> type, Serializable... ids)` Get a reference to the entities of the specified type with the given ids from the datastore.
`boolean`	`isAttached(Object entity)` Returns `true` if the object is connected to the current Hibernate session.
`void`	`refresh(Object... entities)` Refresh the content of the given entity from the current datastore state.
`void`	`remove(Object... entities)` Remove all of the specified entities from the datastore.
`boolean`	`remove(Object entity)` Remove the specified entity from the datastore.
`boolean`	`removeById(Class<?> type, Serializable id)` Remove the entity with the specified type and id from the datastore.
`void`	`removeByIds(Class<?> type, Serializable... ids)` Remove all the entities of the given type from the datastore that have one of these ids.
`boolean[]`	`save(Object... entities)` For each entity, if the id of the entity is null or zero, add it to the datastore and assign it an id; otherwise, update the corresponding entity in the datastore with the properties of this entity.
`boolean`	`save(Object entity)` If the id of the entity is null or zero, add it to the datastore and assign it an id; otherwise, update the corresponding entity in the datastore with the properties of this entity.
`List`	`search(ISearch search)` Search for objects given the search parameters in the specified `ISearch` object.
`SearchResult`	`searchAndCount(ISearch search)` Returns a `SearchResult` object that includes both the list of results like `search()` and the total length like `count()`.
`Object`	`searchUnique(ISearch search)` Search for a single result using the given parameters.
`void`	`setGeneralDAO(GeneralDAO generalDAO)` GeneralDAO has default implementations for the standard DAO methods.

Methods inherited from class com.googlecode.genericdao.dao.BaseDAODispatcher
callMethod, callMethod, getSpecificDAO, getTypeFromArray, getUniformArrayType, setSpecificDAOs

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - generalDAO
```
protected GeneralDAO generalDAO
```
- Constructor Detail
  - DAODispatcher
```
public DAODispatcher()
```
- Method Detail
  - setGeneralDAO
```
public void setGeneralDAO(GeneralDAO generalDAO)
```
    GeneralDAO has default implementations for the standard DAO methods. Which model class it uses is specified when calling the particular method.
  - count
```
public int count(ISearch search)
```
    Description copied from interface: GeneralDAO
    
    Returns the total number of results that would be returned using the given ISearch if there were no paging or maxResults limits.
    
    Specified by:
    
    count in interface GeneralDAO
  - find
```
public <T> T find(Class<T> type,
         Serializable id)
```
    Description copied from interface: GeneralDAO
    
    Get the entity with the specified type and id from the datastore.
    If none is found, return null.
    
    Specified by:
    
    find in interface GeneralDAO
  - find
```
public <T> T[] find(Class<T> type,
           Serializable... ids)
```
    Description copied from interface: GeneralDAO
    
    Get all entities of the specified type from the datastore that have one of these ids. An array of entities is returned that matches the same order of the ids listed in the call. For each entity that is not found in the datastore, a null will be inserted in its place in the return array.
    
    Specified by:
    
    find in interface GeneralDAO
  - findAll
```
public <T> List<T> findAll(Class<T> type)
```
    Description copied from interface: GeneralDAO
    
    Get a list of all the objects of the specified type.
    
    Specified by:
    
    findAll in interface GeneralDAO
  - flush
```
public void flush()
```
    Deprecated. use flush(Class)
    
    Description copied from interface: GeneralDAO
    
    Flushes changes in the Hibernate session to the datastore.
    
    Specified by:
    
    flush in interface GeneralDAO
  - flush
```
public void flush(Class<?> klass)
```
  - getReference
```
public <T> T getReference(Class<T> type,
                 Serializable id)
```
    Description copied from interface: GeneralDAO
    
    Get a reference to the entity with the specified type and id from the datastore.
    This does not require a call to the datastore and does not populate any of the entity's values. Values may be fetched lazily at a later time. This increases performance if a another entity is being saved that should reference this entity but the values of this entity are not needed.
    
    Specified by:
    
    getReference in interface GeneralDAO
  - getReferences
```
public <T> T[] getReferences(Class<T> type,
                    Serializable... ids)
```
    Description copied from interface: GeneralDAO
    
    Get a reference to the entities of the specified type with the given ids from the datastore. An array of entities is returned that matches the same order of the ids listed in the call.
    This does not require a call to the datastore and does not populate any of the entities' values. Values may be fetched lazily at a later time. This increases performance if a another entity is being saved that should reference these entities but the values of these entities are not needed.
    
    Specified by:
    
    getReferences in interface GeneralDAO
  - isAttached
```
public boolean isAttached(Object entity)
```
    Description copied from interface: GeneralDAO
    
    Returns true if the object is connected to the current Hibernate session.
    
    Specified by:
    
    isAttached in interface GeneralDAO
  - refresh
```
public void refresh(Object... entities)
```
    Description copied from interface: GeneralDAO
    
    Refresh the content of the given entity from the current datastore state.
    
    Specified by:
    
    refresh in interface GeneralDAO
  - remove
```
public boolean remove(Object entity)
```
    Description copied from interface: GeneralDAO
    
    Remove the specified entity from the datastore.
    
    Specified by:
    
    remove in interface GeneralDAO
    
    Returns:
    true if the entity is found in the datastore and removed, false if it is not found.
  - remove
```
public void remove(Object... entities)
```
    Description copied from interface: GeneralDAO
    
    Remove all of the specified entities from the datastore.
    
    Specified by:
    
    remove in interface GeneralDAO
  - removeById
```
public boolean removeById(Class<?> type,
                 Serializable id)
```
    Description copied from interface: GeneralDAO
    
    Remove the entity with the specified type and id from the datastore.
    
    Specified by:
    
    removeById in interface GeneralDAO
    
    Returns:
    true if the entity is found in the datastore and removed, false if it is not found.
  - removeByIds
```
public void removeByIds(Class<?> type,
               Serializable... ids)
```
    Description copied from interface: GeneralDAO
    
    Remove all the entities of the given type from the datastore that have one of these ids.
    
    Specified by:
    
    removeByIds in interface GeneralDAO
  - save
```
public boolean save(Object entity)
```
    Description copied from interface: GeneralDAO
    
    If the id of the entity is null or zero, add it to the datastore and assign it an id; otherwise, update the corresponding entity in the datastore with the properties of this entity. In either case the entity passed to this method will be attached to the session.
    If an entity to update is already attached to the session, this method will have no effect. If an entity to update has the same id as another instance already attached to the session, an error will be thrown.
    
    Specified by:
    
    save in interface GeneralDAO
    
    Returns:
    true if create; false if update.
  - save
```
public boolean[] save(Object... entities)
```
    Description copied from interface: GeneralDAO
    
    For each entity, if the id of the entity is null or zero, add it to the datastore and assign it an id; otherwise, update the corresponding entity in the datastore with the properties of this entity. In either case the entity passed to this method will be attached to the session.
    If an entity to update is already attached to the session, this method will have no effect. If an entity to update has the same id as another instance already attached to the session, an error will be thrown.
    
    Specified by:
    
    save in interface GeneralDAO
  - search
```
public List search(ISearch search)
```
    Description copied from interface: GeneralDAO
    
    Search for objects given the search parameters in the specified ISearch object.
    
    Specified by:
    
    search in interface GeneralDAO
  - searchAndCount
```
public SearchResult searchAndCount(ISearch search)
```
    Description copied from interface: GeneralDAO
    
    Returns a SearchResult object that includes both the list of results like search() and the total length like count().
    
    Specified by:
    
    searchAndCount in interface GeneralDAO
  - searchUnique
```
public Object searchUnique(ISearch search)
```
    Description copied from interface: GeneralDAO
    
    Search for a single result using the given parameters.
    
    Specified by:
    
    searchUnique in interface GeneralDAO
  - getFilterFromExample
```
public Filter getFilterFromExample(Object example)
```
    Description copied from interface: GeneralDAO
    
    Generates a search filter from the given example using default options.
    
    Specified by:
    
    getFilterFromExample in interface GeneralDAO
  - getFilterFromExample
```
public Filter getFilterFromExample(Object example,
                          ExampleOptions options)
```
    Description copied from interface: GeneralDAO
    
    Generates a search filter from the given example using the specified options.
    
    Specified by:
    
    getFilterFromExample in interface GeneralDAO

Class DAODispatcher

Field Summary

Fields inherited from class com.googlecode.genericdao.dao.BaseDAODispatcher

Constructor Summary

Method Summary

Methods inherited from class com.googlecode.genericdao.dao.BaseDAODispatcher

Methods inherited from class java.lang.Object

Field Detail

generalDAO

Constructor Detail

DAODispatcher

Method Detail

setGeneralDAO

count

find

find

findAll

flush

flush

getReference

getReferences

isAttached

refresh

remove

remove

removeById

removeByIds

save

save

search

searchAndCount

searchUnique

getFilterFromExample

getFilterFromExample