org.nuiton.topia.persistence

Interface TopiaDAO<E extends TopiaEntity>

Type Parameters:

E - the entity type managed by the dao

All Superinterfaces:

TopiaDAODeprecated<E>

All Known Implementing Classes:

TopiaDAOImpl, TopiaDAOLegacy

public interface TopiaDAO<E extends TopiaEntity>
extends TopiaDAODeprecated<E>

TopiaDAO is used to manipulate entities corresponding to E type : create, delete, update or find entities.

This interface is implemented by TopiaDAOImpl overridden by generation from EntityDAOTransformer.

Version:

$Id: TopiaDAO.java 2636 2012-08-19 15:11:52Z tchemit $

Author:

bpoussin , fdesbois , tchemit

Method Summary

Methods

Modifier and Type	Method and Description
void	addTopiaEntityListener(TopiaEntityListener listener)
void	addTopiaEntityVetoable(TopiaEntityVetoable vetoable)
void	computeAndAddRecordsToPager(String hql, TopiaFilterPagerUtil.FilterPagerBean pager, Object... params) Execute the count hql query and then synch the pager to this result (says fill the PagerUtil.PagerBean.records field and then adapt the number of pages available and the current number page).
long	count() Count the number of existing entities.
long	countByQuery(String hql, Object... params) Count the number of entities based on a hql.
E	create(E e) Permet de sauver un object instancié sans le DAO.
E	create(Map<String,Object> properties) Construit une nouvelle instance de l'objet géré par ce DAO
E	create(Object... properties) Construit une nouvelle instance de l'objet géré par ce DAO
void	delete(E e) Permet de supprimer une entite.
void	deleteAll(Iterable<E> entities) Permet de supprimer des entités.
boolean	existByProperties(String propertyName, Object propertyValue, Object... others) Check the existence of an entity with propertyName with propertyValue.
boolean	existByTopiaId(String id) Check the existence of an entity with technical id.
boolean	existsByQuery(String hql, Object... params) Check the existence of an entity using a hql query.
List<E>	findAll() Gets all entitys of the dao type in db.
List<E>	findAllByProperties(Map<String,Object> properties) Gets all entities of the dao type matching all the properties.
List<E>	findAllByProperties(String propertyName, Object value, Object... others) Gets all entities of the dao type matching the value for the given propertyName and others.
List<E>	findAllByProperty(String propertyName, Object value) Gets all entities of the dao type matching the value for the given propertyName.
<R> List<R>	findAllByQuery(Class<R> type, String hql, Object... params) Gets all entities when executing the given select query for the given type which may not be a entity type (int, long, map,...).
List<E>	findAllByQuery(String hql, Object... params) Gets all entities when executing the given select query for the dao entity type.
List<E>	findAllByQueryAndPager(String hql, TopiaFilterPagerUtil.FilterPagerBean pager, Object... params) Gets a page of entities of the given select hql query using the pager to obtain the window of entities to return.
List<E>	findAllByQueryWithBound(String hql, int startIndex, int endIndex, Object... params) Gets a page of entities when executing the given select query for the dao entity type (will only return the window of startIndex - endIndex entities).
List<E>	findAllContains(String propertyName, Object property) Récupère toutes les entités (du type géré par ce dao) dont la collection nommée propertyName contient la property donnée.
List<String>	findAllIds() Recuperation de tous les ids en base pour le type d'entite du dao.
Map<Class<? extends TopiaEntity>,List<? extends TopiaEntity>>	findAllUsages(E entity) Find all usages of the given entity.
List<E>	findAllWithOrder(String... propertyNames) Gets all entites for the dao entity type order by given propertyNames.
E	findByPrimaryKey(Map<String,Object> keys) Recherche la classe en utilisant la cle naturelle, chaque champs de la cle naturelle est une entre de la map passe en argument.
E	findByPrimaryKey(Object... k) Recherche la classe en utilisant la cle naturelle, si la cle naturelle est composé de plusieurs champs alors les arguments passés doivent être dans l'ordre de declaration dans le fichier de mapping
E	findByProperties(Map<String,Object> properties) Find an entity matching properties.
E	findByProperties(String propertyName, Object value, Object... others)
E	findByProperty(String propertyName, Object value) Find an entity matching value for the given propertyName.
<R> R	findByQuery(Class<R> type, String hql, Object... params) Execute une requête basé sur le type donné.
E	findByQuery(String hql, Object... params) Execute une requête basé sur l'entité du DAO.
E	findByTopiaId(String id) Find an entity corresponding to the id.
E	findContains(String propertyName, Object property) Récupère la première entité (du type géré par ce dao) dont la collection nommée propertyName contient la property donnée.
<R extends TopiaEntity> List<R>	findUsages(Class<R> type, E entity) Find usages of the given entity in the entities of the given type.
TopiaContextImplementor	getContext() Return context used by this DAO.
Class<E>	getEntityClass() Get the type of entity managed by this DAO.
List<Permission>	getRequestPermission(String topiaId, int actions) Retourne les permissions a verifier pour l'acces a l'entite pour le service Taas.
TopiaEntityEnum	getTopiaEntityEnum() Get the entityEnum of the type of entity managed by this DAO.
void	init(TopiaContextImplementor context, Class<E> entityClass) When TopiaContextImpl create the TopiaDAOHibernate, it must call this method just after.
E	newInstance() Create a new instance of managed entity not persisted.
void	removeTopiaEntityListener(TopiaEntityListener listener)
void	removeTopiaEntityVetoable(TopiaEntityVetoable vetoable)
E	update(E e) Permet d'ajouter ou de mettre a jour un objet.

Methods inherited from interface org.nuiton.topia.persistence.TopiaDAODeprecated

countByQuery, createQuery, createQuery, existByQuery, findAllByQuery, findAllMappedByQuery, findAllMappedByQuery, findByQuery

Method Detail

newInstance

E newInstance()
                                  throws TopiaException

Create a new instance of managed entity not persisted.

Returns:

new entity instance

Throws:

TopiaException - if any pb while creating the entity

Since:

2.3.1

create

E create(Object... properties)
                             throws TopiaException

Construit une nouvelle instance de l'objet géré par ce DAO

Parameters:

properties - la liste des propriétés que doit avoir l'objet créé les arguments vont par paire (propertyName, value)

Returns:

un nouvel objet

Throws:

TopiaException - si un problème est rencontré durant l'instanciation

IllegalArgumentException - Si le nombre on le type des arguments n'est pas bon ou que le type ou le nom d'une propriété est fausse

create

E create(Map<String,Object> properties)
                             throws TopiaException

Construit une nouvelle instance de l'objet géré par ce DAO

Parameters:

properties - la liste des propriétés que doit avoir l'objet créé

Returns:

un nouvel objet

Throws:

TopiaException - si un problème est rencontré durant l'instanciation

IllegalArgumentException - Si le nombre on le type des arguments n'est pas bon ou que le type ou le nom d'une propriété est fausse

create

E create(E e)
                             throws TopiaException

Permet de sauver un object instancié sans le DAO. Utilisé notement dans le cas ou le DAO est situé derriere une couche de webservice et que l'appel à la methode create(Object...) serait trop couteux.

Parameters:

e - l'entité instanciée à sauver

Returns:

l'entité avec son topiaID valorisé

Throws:

TopiaException - if any pb while creating datas

Since:

2.3.1

update

E update(E e)
                             throws TopiaException

Permet d'ajouter ou de mettre a jour un objet. Cela permet d'ajouter par exemple un objet provenant d'un autre context mais du meme type de DAO.

Parameters:

e - l'entite a ajouter ou mettre a jour

Returns:

l'entity passé en paramètre.

Throws:

TopiaException - if any pb while updating datas

delete

void delete(E e)
            throws TopiaException

Permet de supprimer une entite.

Parameters:

e - l'entite a supprimer

Throws:

TopiaException - if any pb while deleting datas

deleteAll

void deleteAll(Iterable<E> entities)
               throws TopiaException

Permet de supprimer des entités.

Parameters:

entities - les entités à supprimer

Throws:

TopiaException - if any pb while deleting datas

findByTopiaId

E findByTopiaId(String id)
                                    throws TopiaException

Find an entity corresponding to the id. If the id is null, nothing will be searched.

Parameters:

id - topiaId of the entity to found

Returns:

the entity found or null if not

Throws:

TopiaException - for Topia errors on query

findByProperty

E findByProperty(String propertyName,
               Object value)
                                     throws TopiaException

Find an entity matching value for the given propertyName.

Parameters:

propertyName - property name to filter

value - value of the property to math

Returns:

the first entity matching the request

Throws:

TopiaException

findByProperties

E findByProperties(String propertyName,
                 Object value,
                 Object... others)
                                       throws TopiaException

Parameters:

propertyName - le nom de la propriété

value - la valeur à tester

others - les autres proprietes doivent aller par 2 propertyName, value

Returns:

l'entité trouvé

Throws:

TopiaException - if any pb while getting datas

findByProperties

E findByProperties(Map<String,Object> properties)
                                       throws TopiaException

Find an entity matching properties.

Parameters:

properties - les propriétés à matcher

Returns:

l'entité trouvé

Throws:

TopiaException - if any pb while getting datas

findByQuery

E findByQuery(String hql,
            Object... params)
                                  throws TopiaException

Execute une requête basé sur l'entité du DAO. Permet de récupérer une entité correspondant à la requête.

Parameters:

hql - la requête hql à executer

params - les paramètres de la requète

Returns:

l'entité correspondant à la recherche ou null si aucune entité n'a été trouvée

Throws:

TopiaException - if any pb while getting datas

Since:

2.6.12

findByQuery

<R> R findByQuery(Class<R> type,
                String hql,
                Object... params)
              throws TopiaException

Execute une requête basé sur le type donné.

Permet de récupérer une entité correspondant à la requête.

Parameters:

hql - la requête hql à executer

params - les paramètres de la requète

Returns:

l'entité correspondant à la recherche ou null si aucune entité n'a été trouvée

Throws:

TopiaException - if any pb while getting datas

Since:

2.6.12

findByPrimaryKey

E findByPrimaryKey(Map<String,Object> keys)
                                       throws TopiaException

Recherche la classe en utilisant la cle naturelle, chaque champs de la cle naturelle est une entre de la map passe en argument.

Parameters:

keys - la liste des champs de la cle naturelle avec leur valeur

Returns:

l'entite trouvé

Throws:

TopiaException - if any pb while getting datas

findByPrimaryKey

E findByPrimaryKey(Object... k)
                                       throws TopiaException

Recherche la classe en utilisant la cle naturelle, si la cle naturelle est composé de plusieurs champs alors les arguments passés doivent être dans l'ordre de declaration dans le fichier de mapping

Parameters:

k - l'objet cle naturelle de la classe

Returns:

l'entité trouvé

Throws:

TopiaException - if any pb while getting datas

findContains

E findContains(String propertyName,
             Object property)
                                   throws TopiaException

Récupère la première entité (du type géré par ce dao) dont la collection nommée propertyName contient la property donnée.

Parameters:

propertyName - le nom de la propriété

property - la propriété recherchée

Returns:

la première entité recherchée

Throws:

TopiaException - pour tout erreur lors de la recherche

Since:

2.5.4

findAll

List<E> findAll()
                                    throws TopiaException

Gets all entitys of the dao type in db.

Returns:

all entities of the dao type in db

Throws:

TopiaException

findAllIds

List<String> findAllIds()
                        throws TopiaException

Recuperation de tous les ids en base pour le type d'entite du dao.

Returns:

la liste de tous les ids

Throws:

TopiaException - si pb en base

findAllByProperty

List<E> findAllByProperty(String propertyName,
                        Object value)
                                              throws TopiaException

Gets all entities of the dao type matching the value for the given propertyName.

Parameters:

propertyName - property name to filter

value - value to match

Returns:

matching entities

Throws:

TopiaException - if any pb while getting datas

findAllByProperties

List<E> findAllByProperties(String propertyName,
                          Object value,
                          Object... others)
                                                throws TopiaException

Gets all entities of the dao type matching the value for the given propertyName and others.

Parameters:

propertyName - le nom de la propriété

value - la valeur à tester

others - les autres proprietes doivent aller par 2 propertyName, value

Returns:

matching entities

Throws:

TopiaException - if any pb while getting datas

findAllByProperties

List<E> findAllByProperties(Map<String,Object> properties)
                                                throws TopiaException

Gets all entities of the dao type matching all the properties.

Parameters:

properties - properties to match

Returns:

matching entities

Throws:

TopiaException - if any pb while getting datas

findAllByQuery

List<E> findAllByQuery(String hql,
                     Object... params)
                                           throws TopiaException

Gets all entities when executing the given select query for the dao entity type.

Parameters:

hql - hql query

params - query params

Returns:

entites of the query result

Throws:

TopiaException - if any pb while getting datas

Since:

2.6.12

findAllByQuery

<R> List<R> findAllByQuery(Class<R> type,
                         String hql,
                         Object... params)
                       throws TopiaException

Gets all entities when executing the given select query for the given type which may not be a entity type (int, long, map,...).

Parameters:

hql - hql query

params - query params

Returns:

entites of the query result

Throws:

TopiaException - if any pb while getting datas

Since:

2.6.12

findAllByQueryWithBound

List<E> findAllByQueryWithBound(String hql,
                              int startIndex,
                              int endIndex,
                              Object... params)
                                                    throws TopiaException

Gets a page of entities when executing the given select query for the dao entity type (will only return the window of startIndex - endIndex entities).

Parameters:

hql - hql query to execute

startIndex - first index of entity to return

endIndex - last index of entity to return

params - query params

Returns:

entites of the paginated query result

Throws:

TopiaException - if any pb while getting datas

Since:

2.6.12

findAllByQueryAndPager

List<E> findAllByQueryAndPager(String hql,
                             TopiaFilterPagerUtil.FilterPagerBean pager,
                             Object... params)
                                                   throws TopiaException

Gets a page of entities of the given select hql query using the pager to obtain the window of entities to return.

Parameters:

hql - hql query to execute

pager - pager to obtan the correct window of data

params - params of the query

Returns:

entities of the paginated query result

Throws:

TopiaException - if any pb while getting datas

Since:

2.6.12

See Also:

TopiaFilterPagerUtil.FilterPagerBean

findAllWithOrder

List<E> findAllWithOrder(String... propertyNames)
                                             throws TopiaException

Gets all entites for the dao entity type order by given propertyNames.

You can add on each property ASC ou DESC to fix order way (by default is ASC).

Parameters:

propertyNames - property names of order to apply

Returns:

all entities of the dao entity type with given order

Throws:

TopiaException - if any pb while getting datas

findAllContains

List<E> findAllContains(String propertyName,
                      Object property)
                                            throws TopiaException

Récupère toutes les entités (du type géré par ce dao) dont la collection nommée propertyName contient la property donnée.

Parameters:

propertyName - le nom de la propriété

property - la propriété recherchée

Returns:

toutes les entités recherchées

Throws:

TopiaException - pour tout erreur lors de la recherche

Since:

2.5.4

existByTopiaId

boolean existByTopiaId(String id)
                       throws TopiaException

Check the existence of an entity with technical id.

Parameters:

id - unique id of the entity to test existence.

Returns:

true if entity exists, false otherwise

Throws:

TopiaException - for Topia errors

Since:

2.3.4

existByProperties

boolean existByProperties(String propertyName,
                        Object propertyValue,
                        Object... others)
                          throws TopiaException

Check the existence of an entity with propertyName with propertyValue. others properties can be added to test existence.

Parameters:

propertyName - first property name to test existence

propertyValue - first property value to test existence

others - altern propertyName and propertyValue

Returns:

true if entity exists, false otherwise

Throws:

TopiaException - for Topia errors

Since:

2.3.4

existsByQuery

boolean existsByQuery(String hql,
                    Object... params)
                      throws TopiaException

Check the existence of an entity using a hql query.

Parameters:

hql - query used to test existence

params - params used by the query

Returns:

true if entity exists, false otherwise

Throws:

TopiaException

Since:

2.6.12

count

long count()
           throws TopiaException

Count the number of existing entities.

Returns:

number of total entities

Throws:

TopiaException - if any pb while getting datas

Since:

2.3.4

countByQuery

long countByQuery(String hql,
                Object... params)
                  throws TopiaException

Count the number of entities based on a hql.

Parameters:

hql - hql query to use

Returns:

number of entities filtered by the query

Throws:

TopiaException - if any pb while getting datas

Since:

2.6.12

findUsages

<R extends TopiaEntity> List<R> findUsages(Class<R> type,
                                         E entity)
                                       throws TopiaException

Find usages of the given entity in the entities of the given type.

Type Parameters:

R - type of entity to search

Parameters:

type - the type of entity to search

entity - the entity on which search is done

Returns:

the list of entities of the given type which uses the given entity

Throws:

TopiaException - if any problem while getting data

Since:

2.3.0

findAllUsages

Map<Class<? extends TopiaEntity>,List<? extends TopiaEntity>> findAllUsages(E entity)
                                                                            throws TopiaException

Find all usages of the given entity.

Parameters:

entity - the entity

Returns:

the dictionnary of usages of the given entities (keys are entity usage container, values are the list of this type of entity to use the given entity).

Throws:

TopiaException - if any pb while getting data

Since:

2.3.0

computeAndAddRecordsToPager

void computeAndAddRecordsToPager(String hql,
                               TopiaFilterPagerUtil.FilterPagerBean pager,
                               Object... params)
                                 throws TopiaException

Execute the count hql query and then synch the pager to this result (says fill the PagerUtil.PagerBean.records field and then adapt the number of pages available and the current number page).

Parameters:

hql - the count hql to execute

pager - the page to synch

params - params of the count query

Throws:

TopiaException - if any pb while getting datas

Since:

2.6.12

See Also:

TopiaFilterPagerUtil.FilterPagerBean

getTopiaEntityEnum

TopiaEntityEnum getTopiaEntityEnum()

Get the entityEnum of the type of entity managed by this DAO.

Returns:

entity type enum managed by this DAO

getEntityClass

Class<E> getEntityClass()

Get the type of entity managed by this DAO.

Returns:

entity type managed by this DAO

init

void init(TopiaContextImplementor context,
        Class<E> entityClass)
          throws TopiaException

When TopiaContextImpl create the TopiaDAOHibernate, it must call this method just after.

Parameters:

context - context

entityClass - entity class

Throws:

TopiaException - if any pb while init

getContext

TopiaContextImplementor getContext()

Return context used by this DAO.

Returns:

the context.

getRequestPermission

List<Permission> getRequestPermission(String topiaId,
                                    int actions)
                                      throws TopiaException

Retourne les permissions a verifier pour l'acces a l'entite pour le service Taas.

Parameters:

topiaId - topiaId d'une entite

actions - encoded actions

Returns:

la liste des permissions

Throws:

TopiaException - if any pb while getting datas

addTopiaEntityListener

void addTopiaEntityListener(TopiaEntityListener listener)

addTopiaEntityVetoable

void addTopiaEntityVetoable(TopiaEntityVetoable vetoable)

removeTopiaEntityListener

void removeTopiaEntityListener(TopiaEntityListener listener)

removeTopiaEntityVetoable

void removeTopiaEntityVetoable(TopiaEntityVetoable vetoable)