rs.data.impl.dao

Class AbstractDAO<K extends Serializable,T extends GeneralDTO<K>,B extends AbstractBO<K,T>,C extends GeneralBO<K>>

java.lang.Object

rs.data.impl.dao.AbstractGeneralDAO<K,B,C>

rs.data.impl.dao.AbstractDAO<K,T,B,C>

Type Parameters:

K - type of primary key

T - type of Transfer Object

B - type of Business Object Implementation

C - type of Business Object Interface

All Implemented Interfaces:

GeneralDAO<K,C>, rsbaselib.configuration.Configurable

public abstract class AbstractDAO<K extends Serializable,T extends GeneralDTO<K>,B extends AbstractBO<K,T>,C extends GeneralBO<K>>
extends AbstractGeneralDAO<K,B,C>
implements GeneralDAO<K,C>

Abstract Implementation for Data Access Objects.

Author:

ralph

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	AbstractDAO.BusinessIterator Wrapping all DTOs into BOs when returning.

Field Summary

Fields inherited from class rs.data.impl.dao.AbstractGeneralDAO

log

Constructor Summary

Constructors

Constructor and Description
AbstractDAO() Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	_create(B object) Creates the object.
protected abstract void	_create(T object) Creates the object.
protected void	_delete(B object) Deletes the object.
protected abstract void	_delete(T object) Deletes the object.
protected abstract int	_deleteAll() Deletes all objects.
protected abstract int	_deleteDefaultAll() Deletes all objects.
protected abstract List<T>	_findAll(int firstResult, int maxResults) Returns a subset of all objects.
protected abstract T	_findById(K id) Find the object in underlying store.
protected abstract List<T>	_findDefaultAll(int firstResult, int maxResults) Returns a subset of domain objects with default criteria.
protected abstract Iterator<T>	_iterateAll(int firstResult, int maxResults) Returns a subset of all objects
protected abstract Iterator<T>	_iterateDefaultAll(int firstResult, int maxResults) Returns a subset of domain objects with default criteria.
protected void	_save(B object) Saves the object.
protected abstract void	_save(T object) Saves the object.
int	deleteAll() Deletes all objects.
int	deleteDefaultAll() Deletes all objects.
List<C>	findAll(int firstResult, int maxResults) Returns a subset of all objects.
C	findById(K id) Find the given object in model.
List<C>	findDefaultAll(int firstResult, int maxResults) Returns domain objects with default criteria.
C	getBusinessObject(T object) Returns the business objects for the transfer object.
protected CID	getCID(T object) Returns the CID for this object.
protected Class<T>	getTransferClass() Returns the dtoInterfaceClass.
protected void	init() Initializes / called from constructor.
DaoIterator<C>	iterateAll(int firstResult, int maxResults) Returns a subset of all objects
DaoIterator<C>	iterateDefaultAll(int firstResult, int maxResults) Returns a subset of domain objects with default criteria.
protected void	wrap(Collection<C> rc, Collection<T> collection) Wraps the collection into business objects.
protected DaoIterator<C>	wrap(Iterator<T> i) Returns the wrapper for DTO iterators.

Methods inherited from class rs.data.impl.dao.AbstractGeneralDAO

addCached, addDaoListener, afterConfiguration, afterCreate, afterDelete, afterNewInstance, afterSave, beforeConfiguration, beforeCreate, beforeDelete, beforeSave, configure, create, create, createObject, createObject, delete, deleteObject, findAll, findDefaultAll, fireAllDefaultDeleted, fireAllDeleted, fireDaoEvent, fireObjectCreated, fireObjectDeleted, fireObjectUpdated, getBoImplementationClass, getBoInterfaceClass, getCached, getDaoMaster, getFactory, getKeyClass, getLog, iterateAll, iterateDefaultAll, newInstance, removeDaoListener, save, save, saveObject, saveObject, setDaoMaster, setFactory

Methods inherited from class java.lang.Object

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

Methods inherited from interface rs.data.api.dao.GeneralDAO

addDaoListener, create, create, createObject, createObject, delete, deleteObject, findAll, findDefaultAll, getDaoMaster, getDefaultObjectCount, getFactory, getObjectCount, iterateAll, iterateDefaultAll, newInstance, removeDaoListener, save, save, saveObject, saveObject, setDaoMaster, setFactory

Constructor Detail

AbstractDAO

public AbstractDAO()

Constructor.

Method Detail

init

protected void init()

Initializes / called from constructor.

Overrides:

init in class AbstractGeneralDAO<K extends Serializable,B extends AbstractBO<K,T>,C extends GeneralBO<K>>

getTransferClass

protected Class<T> getTransferClass()

Returns the dtoInterfaceClass.

Returns:

the dtoInterfaceClass

getBusinessObject

public C getBusinessObject(T object)

Returns the business objects for the transfer object.

getCID

protected CID getCID(T object)

Returns the CID for this object.

Parameters:

object - object

Returns:

CID

wrap

protected void wrap(Collection<C> rc,
        Collection<T> collection)

Wraps the collection into business objects.

Parameters:

rc - the collection where to store the BO.

collection - collection of DTO to be wrapped.

wrap

protected DaoIterator<C> wrap(Iterator<T> i)

Returns the wrapper for DTO iterators.

Parameters:

i - DTO iterator to be wrapped

Returns:

iterator on BOs

_create

protected void _create(B object)

Creates the object. This method assumes that the object does not exist.

Specified by:

_create in class AbstractGeneralDAO<K extends Serializable,B extends AbstractBO<K,T>,C extends GeneralBO<K>>

Parameters:

object - BO to be saved

See Also:

AbstractGeneralDAO.createObject(Object)

_create

protected abstract void _create(T object)

Creates the object. This method assumes that the object already exists.

Parameters:

object - DTO to be saved

See Also:

AbstractGeneralDAO.create(GeneralBO, boolean)

findById

public C findById(K id)

Find the given object in model.

Specified by:

findById in interface GeneralDAO<K extends Serializable,C extends GeneralBO<K>>

Parameters:

id - id of object

Returns:

object

_findById

protected abstract T _findById(K id)

Find the object in underlying store.

Parameters:

id - id of object

Returns:

DTO

findAll

public List<C> findAll(int firstResult,
              int maxResults)

Returns a subset of all objects.

Specified by:

findAll in interface GeneralDAO<K extends Serializable,C extends GeneralBO<K>>

Parameters:

firstResult - index of first result

maxResults - maximum number of results to return

Returns:

list of objects

_findAll

protected abstract List<T> _findAll(int firstResult,
               int maxResults)

Returns a subset of all objects.

Parameters:

firstResult - index of first result

maxResults - maximum number of results to return

Returns:

list of DTO

findDefaultAll

public List<C> findDefaultAll(int firstResult,
                     int maxResults)

Returns domain objects with default criteria. A default criteria could hide objects not needed regulary (e.g. deleted objects)

Specified by:

findDefaultAll in interface GeneralDAO<K extends Serializable,C extends GeneralBO<K>>

Returns:

list of all objects

_findDefaultAll

protected abstract List<T> _findDefaultAll(int firstResult,
                      int maxResults)

Returns a subset of domain objects with default criteria. A default criteria could hide objects not needed regulary (e.g. deleted objects)

Parameters:

firstResult - index of first result

maxResults - maximum number of results to return

Returns:

list of all DTO

iterateAll

public DaoIterator<C> iterateAll(int firstResult,
                        int maxResults)

Returns a subset of all objects

Specified by:

iterateAll in interface GeneralDAO<K extends Serializable,C extends GeneralBO<K>>

Parameters:

firstResult - index of first result

maxResults - maximum number of results to return

Returns:

iterator of BO

_iterateAll

protected abstract Iterator<T> _iterateAll(int firstResult,
                      int maxResults)

Returns a subset of all objects

Parameters:

firstResult - index of first result

maxResults - maximum number of results to return

Returns:

iterator of DTO

iterateDefaultAll

public DaoIterator<C> iterateDefaultAll(int firstResult,
                               int maxResults)

Returns a subset of domain objects with default criteria. A default criteria could hide objects not needed regulary (e.g. deleted objects)

Specified by:

iterateDefaultAll in interface GeneralDAO<K extends Serializable,C extends GeneralBO<K>>

Parameters:

firstResult - index of first result

maxResults - maximum number of results to return

Returns:

list of all objects

_iterateDefaultAll

protected abstract Iterator<T> _iterateDefaultAll(int firstResult,
                             int maxResults)

Returns a subset of domain objects with default criteria. A default criteria could hide objects not needed regulary (e.g. deleted objects)

Parameters:

firstResult - index of first result

maxResults - maximum number of results to return

Returns:

list of all objects

_save

protected void _save(B object)

Saves the object. This method assumes that the object already exists.

Specified by:

_save in class AbstractGeneralDAO<K extends Serializable,B extends AbstractBO<K,T>,C extends GeneralBO<K>>

Parameters:

object - BO to be saved

See Also:

AbstractGeneralDAO.create(GeneralBO, boolean)

_save

protected abstract void _save(T object)

Saves the object. This method assumes that the object already exists.

Parameters:

object - DTO to be saved

See Also:

AbstractGeneralDAO.save(GeneralBO, boolean)

_delete

protected void _delete(B object)

Deletes the object. This method assumes that the object existed before.

Specified by:

_delete in class AbstractGeneralDAO<K extends Serializable,B extends AbstractBO<K,T>,C extends GeneralBO<K>>

Parameters:

object - DTO to be deleted.

_delete

protected abstract void _delete(T object)

Deletes the object. This method assumes that the object existed before.

Parameters:

object - DTO to be deleted.

deleteAll

public int deleteAll()

Deletes all objects.

Specified by:

deleteAll in interface GeneralDAO<K extends Serializable,C extends GeneralBO<K>>

Returns:

number of object deleted

_deleteAll

protected abstract int _deleteAll()

Deletes all objects.

Returns:

number of object deleted

deleteDefaultAll

public int deleteDefaultAll()

Deletes all objects.

Specified by:

deleteDefaultAll in interface GeneralDAO<K extends Serializable,C extends GeneralBO<K>>

Returns:

number of object deleted

_deleteDefaultAll

protected abstract int _deleteDefaultAll()

Deletes all objects.

Returns:

number of object deleted