AbstractDAO (DellRoad Stuff Spring Classes 2.0.3 API)

java.lang.Object
- org.dellroad.stuff.spring.AbstractBean
- - org.dellroad.stuff.spring.AbstractDAO<T>

Type Parameters:
T - persistent instance type

All Implemented Interfaces:

DAO<T>, DisposableBean, InitializingBean
```
public abstract class AbstractDAO<T>
extends AbstractBean
implements DAO<T>
```
Support superclass for JPA DAO implementations.

See Also:
PersistenceExceptionTranslationPostProcessor

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected class`	`AbstractDAO.DAOCriteriaListCallback` Convenience subclass of `CriteriaCallback` for use by DAO subclasses when returning lists of persistent instances.
`protected class`	`AbstractDAO.DAOCriteriaUniqueCallback` Convenience subclass of `CriteriaCallback` for use by DAO subclasses when returning a single persistent instance.
`protected class`	`AbstractDAO.DAOQueryListCallback` Convenience subclass of `QueryCallback` for use by DAO subclasses when returning lists of persistent instances.
`protected class`	`AbstractDAO.DAOQueryUniqueCallback` Convenience subclass of `QueryCallback` for use by DAO subclasses when returning a single persistent instance.

Field Summary

Fields
Modifier and Type Field and Description

protected Class<T> type
Persistent instance type.
- Fields inherited from class org.dellroad.stuff.spring.AbstractBean
  log

Fields
Modifier and Type	Field and Description
`protected Class<T>`	`type` Persistent instance type.

Constructor Summary

Constructors
Modifier Constructor and Description

protected AbstractDAO(Class<T> type)
Constructor.

Constructors
Modifier	Constructor and Description
`protected`	`AbstractDAO(Class<T> type)` Constructor.

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`afterPropertiesSet()` Initialize bean.
`protected int`	`bulkUpdate(UpdateCallback callback)` Perform a bulk update.
`protected T`	`cast(Object obj)` Cast the given object to this instance's persistent instance type.
`protected List<T>`	`castList(List<?> list)` Cast the given list to a list of this instance's persistent instance type.
`void`	`clear()`
`boolean`	`contains(T obj)`
`void`	`delete(T obj)`
`void`	`detach(Object obj)`
`protected List<T>`	`find(String queryString, Object... params)` Find instances using a query string and query parameters.
`protected T`	`findUnique(String queryString, Object... params)` Find a unique instance using a query string and query parameters.
`void`	`flush()`
`List<T>`	`getAll()`
`protected <R> R`	`getBy(QueryCallback<R> callback)` Search using a `QueryCallback`.
`T`	`getById(long id)`
`protected EntityManager`	`getEntityManager()` Get the configured `EntityManager`.
`T`	`getReference(long id)`
`Class<T>`	`getType()`
`boolean`	`isReadOnly()`
`T`	`merge(T obj)`
`void`	`refresh(T obj)`
`void`	`save(T obj)`
`void`	`setEntityManager(EntityManager entityManager)` Set the configured `EntityManager`.
`void`	`setFlushMode(FlushModeType flushMode)`

Methods inherited from class org.dellroad.stuff.spring.AbstractBean
destroy

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

- Field Detail
  - type
```
protected final Class<T> type
```
    Persistent instance type.
- Constructor Detail
  - AbstractDAO
```
protected AbstractDAO(Class<T> type)
```
    Constructor.
    
    Parameters:
    type - persistent instance type
- Method Detail
  - getEntityManager
```
protected EntityManager getEntityManager()
```
    Get the configured EntityManager.
    
    Returns:
    this DAO's EntityManager
  - setEntityManager
```
public void setEntityManager(EntityManager entityManager)
```
    Set the configured EntityManager.
    This method has a @PersistenceContext annotation and normally would be invoked automatically by Spring.
    
    Parameters:
    entityManager - this DAO's EntityManager
  - afterPropertiesSet
```
public void afterPropertiesSet()
                        throws Exception
```
    Description copied from class: AbstractBean
    
    Initialize bean.
    The implementation in AbstractBean does nothing.
    
    Specified by:
    
    afterPropertiesSet in interface InitializingBean
    
    Overrides:
    
    afterPropertiesSet in class AbstractBean
    
    Throws:
    
    Exception
  - getType
```
public Class<T> getType()
```
    Specified by:
    
    getType in interface DAO<T>
  - getById
```
public T getById(long id)
```
    Specified by:
    
    getById in interface DAO<T>
  - getAll
```
public List<T> getAll()
```
    Specified by:
    
    getAll in interface DAO<T>
  - getReference
```
public T getReference(long id)
```
    Specified by:
    
    getReference in interface DAO<T>
  - find
```
protected List<T> find(String queryString,
           Object... params)
```
    Find instances using a query string and query parameters.
    
    Parameters:
    queryString - JPQL query string
    params - query string parameters
    
    Returns:
    zero or more matching objects
  - findUnique
```
protected T findUnique(String queryString,
           Object... params)
```
    Find a unique instance using a query string and query parameters.
    
    Parameters:
    queryString - JPQL query string
    params - query string parameters
    
    Returns:
    unique instance found, or null if none was found
  - getBy
```
protected <R> R getBy(QueryCallback<R> callback)
```
    Search using a QueryCallback.
    
    Type Parameters:
    R - return type
    Parameters:
    callback - query callback
    
    Returns:
    result of query
  - bulkUpdate
```
protected int bulkUpdate(UpdateCallback callback)
```
    Perform a bulk update.
    
    Parameters:
    callback - query callback
    
    Returns:
    number of rows affected
  - save
```
public void save(T obj)
```
    Specified by:
    
    save in interface DAO<T>
  - delete
```
public void delete(T obj)
```
    Specified by:
    
    delete in interface DAO<T>
  - merge
```
public T merge(T obj)
```
    Specified by:
    
    merge in interface DAO<T>
  - refresh
```
public void refresh(T obj)
```
    Specified by:
    
    refresh in interface DAO<T>
  - detach
```
public void detach(Object obj)
```
    Specified by:
    
    detach in interface DAO<T>
  - flush
```
public void flush()
```
    Specified by:
    
    flush in interface DAO<T>
  - setFlushMode
```
public void setFlushMode(FlushModeType flushMode)
```
    Specified by:
    
    setFlushMode in interface DAO<T>
  - clear
```
public void clear()
```
    Specified by:
    
    clear in interface DAO<T>
  - isReadOnly
```
public boolean isReadOnly()
```
    Specified by:
    
    isReadOnly in interface DAO<T>
  - contains
```
public boolean contains(T obj)
```
    Specified by:
    
    contains in interface DAO<T>
  - cast
```
protected T cast(Object obj)
```
    Cast the given object to this instance's persistent instance type.
    
    Parameters:
    obj - object to cast
    
    Returns:
    obj cast to type T
  - castList
```
protected List<T> castList(List<?> list)
```
    Cast the given list to a list of this instance's persistent instance type. Does not actually inspect the contents of the list.
    
    Parameters:
    list - list of objects
    
    Returns:
    list cast to a list of T

Class AbstractDAO<T>

Nested Class Summary

Field Summary

Fields inherited from class org.dellroad.stuff.spring.AbstractBean

Constructor Summary

Method Summary

Methods inherited from class org.dellroad.stuff.spring.AbstractBean

Methods inherited from class java.lang.Object

Field Detail

type

Constructor Detail

AbstractDAO

Method Detail

getEntityManager

setEntityManager

afterPropertiesSet

getType

getById

getAll

getReference

find

findUnique

getBy

bulkUpdate

save

delete

merge

refresh

detach

flush

setFlushMode

clear

isReadOnly

contains

cast

castList