de.terrestris.shogun2.dao

Class GenericHibernateDao<E extends PersistentObject,ID extends Serializable>

java.lang.Object

de.terrestris.shogun2.dao.GenericHibernateDao<E,ID>

Direct Known Subclasses:

AbstractTokenDao, ApplicationDao, ExtentDao, FileDao, InterceptorRuleDao, LayerAppearanceDao, LayerDao, LayerDataSourceDao, LayoutDao, MapConfigDao, MapControlDao, ModuleDao, PermissionCollectionDao, PersonDao, RoleDao, TerritoryDao, TileGridDao, UserGroupDao

@Repository(value="genericDao")
public class GenericHibernateDao<E extends PersistentObject,ID extends Serializable>
extends Object

The superclass for all data access objects. Provides basic CRUD functionality and a logger instance for all subclasses.

Author:

Nils Bühner

Field Summary

Fields

Modifier and Type	Field and Description
protected org.apache.log4j.Logger	LOG The LOGGER instance (that will be available in all subclasses)

Constructor Summary

Constructors

Modifier	Constructor and Description
	GenericHibernateDao() Default constructor
protected	GenericHibernateDao(Class<E> clazz) Constructor

Method Summary

Modifier and Type	Method and Description
protected org.hibernate.Criteria	createDistinctRootEntityCriteria(org.hibernate.criterion.Criterion... criterion) Helper method: Creates a criteria for the entityClass of this dao.
void	delete(E e) Deletes the passed entity.
List<E>	findAll() Returns all Entities by calling findByCriteria(), i.e. without arguments.
Map<PersistentObject,PermissionCollection>	findAllUserGroupPermissionsOfUserGroup(UserGroup userGroup) This method returns a Map that maps PersistentObjects to PermissionCollections for the passed UserGroup.
Map<PersistentObject,PermissionCollection>	findAllUserPermissionsOfUser(User user) This method returns a Map that maps PersistentObjects to PermissionCollections for the passed User.
List<E>	findByCriteria(org.hibernate.criterion.Criterion... criterion) Gets the results, that match a variable number of passed criterions.
PagingResult<E>	findByCriteriaWithSortingAndPaging(Integer firstResult, Integer maxResults, List<org.hibernate.criterion.Order> sorters, org.hibernate.criterion.Criterion... criterion) Gets the results, that match a variable number of passed criterions, considering the paging- and sort-info at the same time.
E	findById(ID id) Return the real object from the database.
E	findByUniqueCriteria(org.hibernate.criterion.Criterion... criterion) Gets the unique result, that matches a variable number of passed criterions.
Class<E>	getEntityClass()
E	loadById(ID id) Return a proxy of the object (without hitting the database).
void	saveOrUpdate(E e) Saves or updates the passed entity.

Methods inherited from class java.lang.Object

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

Field Detail

LOG

protected final org.apache.log4j.Logger LOG

The LOGGER instance (that will be available in all subclasses)

Constructor Detail

GenericHibernateDao

public GenericHibernateDao()

Default constructor

GenericHibernateDao

protected GenericHibernateDao(Class<E> clazz)

Constructor

Parameters:

clazz -

Method Detail

findById

public E findById(ID id)

Return the real object from the database. Returns null if the object does not exist.

Parameters:

id -

Returns:

The object from the database or null if it does not exist

See Also:

http://www.mkyong.com/hibernate/different-between-session-get-and-session-load/

loadById

public E loadById(ID id)

Return a proxy of the object (without hitting the database). This should only be used if it is assumed that the object really exists and where non-existence would be an actual error.

Parameters:

id -

Returns:

See Also:

http://www.mkyong.com/hibernate/different-between-session-get-and-session-load/

findAll

public List<E> findAll()
                throws org.hibernate.HibernateException

Returns all Entities by calling findByCriteria(), i.e. without arguments.

Returns:

All entities

Throws:

org.hibernate.HibernateException

See Also:

findByCriteria(Criterion...)

saveOrUpdate

public void saveOrUpdate(E e)

Saves or updates the passed entity.

Parameters:

e - The entity to save or update in the database.

delete

public void delete(E e)

Deletes the passed entity.

Parameters:

e - The entity to remove from the database.

findByCriteria

public List<E> findByCriteria(org.hibernate.criterion.Criterion... criterion)
                       throws org.hibernate.HibernateException

Gets the results, that match a variable number of passed criterions. Call this method without arguments to find all entities.

Parameters:

criterion - A variable number of hibernate criterions

Returns:

Entities matching the passed hibernate criterions

Throws:

org.hibernate.HibernateException

findByUniqueCriteria

public E findByUniqueCriteria(org.hibernate.criterion.Criterion... criterion)
                       throws org.hibernate.HibernateException

Gets the unique result, that matches a variable number of passed criterions.

Parameters:

criterion - A variable number of hibernate criterions

Returns:

Entity matching the passed hibernate criterions

Throws:

org.hibernate.HibernateException - if there is more than one matching result

findByCriteriaWithSortingAndPaging

public PagingResult<E> findByCriteriaWithSortingAndPaging(Integer firstResult,
                                                          Integer maxResults,
                                                          List<org.hibernate.criterion.Order> sorters,
                                                          org.hibernate.criterion.Criterion... criterion)
                                                   throws org.hibernate.HibernateException

Gets the results, that match a variable number of passed criterions, considering the paging- and sort-info at the same time.

Parameters:

firstResult - Starting index for the paging request.

maxResults - Max number of result size.

criterion - A variable number of hibernate criterions

Returns:

Throws:

org.hibernate.HibernateException

findAllUserPermissionsOfUser

public Map<PersistentObject,PermissionCollection> findAllUserPermissionsOfUser(User user)

This method returns a Map that maps PersistentObjects to PermissionCollections for the passed User. I.e. the keySet of the map is the collection of all PersistentObjects where the user has at least one permission and the corresponding value contains the PermissionCollection for the passed user on the entity.

Parameters:

user -

Returns:

findAllUserGroupPermissionsOfUserGroup

public Map<PersistentObject,PermissionCollection> findAllUserGroupPermissionsOfUserGroup(UserGroup userGroup)

This method returns a Map that maps PersistentObjects to PermissionCollections for the passed UserGroup. I.e. the keySet of the map is the collection of all PersistentObjects where the user group has at least one permission and the corresponding value contains the PermissionCollection for the passed user group on the entity.

Parameters:

userGroup -

Returns:

createDistinctRootEntityCriteria

protected org.hibernate.Criteria createDistinctRootEntityCriteria(org.hibernate.criterion.Criterion... criterion)

Helper method: Creates a criteria for the entityClass of this dao. The query results will be handled with a DistinctRootEntityResultTransformer. The criteria will contain all passed criterions.

Returns:

getEntityClass

public Class<E> getEntityClass()

Returns:

the entityClass