eu.etaxonomy.cdm.persistence.dao.common

Interface IAnnotatableDao<T extends AnnotatableEntity>

All Superinterfaces:

ICdmEntityDao<T>, IVersionableDao<T>

All Known Subinterfaces:

IAgentDao, IAmplificationDao, IAnnotationDao, IClassificationDao, ICollectionDao, IDefinedTermDao, IDescriptionDao, IDescriptionElementDao, IDescriptiveDataSetDao, IEventBaseDao, IIdentifiableDao<T>, ILanguageStringBaseDao<T>, ILanguageStringDao, IMediaDao, IOccurrenceDao, IPolytomousKeyDao, IPrimerDao, IReferenceDao, IRegistrationDao, IRepresentationDao, IRightsDao, ISequenceDao, ISingleReadDao, ITaxonDao, ITaxonNameDao, ITaxonNodeDao, ITermTreeDao, ITermVocabularyDao

All Known Implementing Classes:

AgentDaoImpl, AmplificationDaoHibernateImpl, AnnotatableDaoImpl, AnnotationDaoImpl, ClassificationDaoHibernateImpl, CollectionDaoHibernateImpl, DefinedTermDaoImpl, DescriptionDaoImpl, DescriptionElementDaoImpl, DescriptiveDataSetDao, EventBaseDaoImpl, IdentifiableDaoBase, LanguageStringBaseDaoImpl, LanguageStringDaoImpl, MediaDaoHibernateImpl, OccurrenceDaoHibernateImpl, PolytomousKeyDaoImpl, PrimerDaoHibernateImpl, ReferenceDaoHibernateImpl, RegistrationDaoHibernateImpl, RepresentationDaoImpl, RightsDaoImpl, SequenceDaoHibernateImpl, SingleReadDaoHibernateImpl, TaxonDaoHibernateImpl, TaxonNameDaoHibernateImpl, TaxonNodeDaoHibernateImpl, TermTreeDaoImpl, TermVocabularyDaoImpl

public interface IAnnotatableDao<T extends AnnotatableEntity>
extends IVersionableDao<T>

Since:

24.09.2008

Author:

n.hoffmann

Method Summary

Modifier and Type	Method and Description
long	countAnnotations(T annotatableEntity, MarkerType status) Returns a count of Annotations belonging to the supplied AnnotatableEntity
int	countMarkers(java.lang.Class<? extends T> clazz, java.lang.Boolean technical) returns a count of all markers belonging to that clazz, optionally filtered to include only technical or only non-technical markers.
long	countMarkers(T annotatableEntity, java.lang.Boolean technical) Returns a count of Markers belonging to the supplied AnnotatableEntity
java.util.List<Annotation>	getAnnotations(T annotatableEntity, MarkerType status, java.lang.Integer pageSize, java.lang.Integer pageNumber, java.util.List<OrderHint> orderHints, java.util.List<java.lang.String> propertyPaths) Returns a List of Annotations belonging to the supplied AnnotatableEntity
java.util.List<Marker>	getMarkers(T annotatableEntity, java.lang.Boolean technical, java.lang.Integer pageSize, java.lang.Integer pageNumber, java.util.List<OrderHint> orderHints, java.util.List<java.lang.String> propertyPaths)
java.util.List<java.lang.Object[]>	groupMarkers(java.lang.Class<? extends T> clazz, java.lang.Boolean technical, java.lang.Integer pageSize, java.lang.Integer pageNumber, java.util.List<java.lang.String> propertyPaths) Returns a list of arrays representing counts of entities of type clazz, grouped by their markerTypes.

Methods inherited from interface eu.etaxonomy.cdm.persistence.dao.common.IVersionableDao

countAuditEvents, countAuditEvents, getAuditEvents, getAuditEvents, getNextAuditEvent, getPreviousAuditEvent

Methods inherited from interface eu.etaxonomy.cdm.persistence.dao.common.ICdmEntityDao

clear, count, count, count, count, countByParam, countByParamWithRestrictions, delete, exists, findById, findByParam, findByParam, findByParamWithRestrictions, findByUuid, findByUuidWithoutFlush, flush, getSession, getType, group, list, list, list, list, list, list, list, list, list, load, load, load, loadList, lock, merge, merge, refresh, refresh, replace, save, saveAll, saveOrUpdate, saveOrUpdateAll, update

Method Detail

getAnnotations

java.util.List<Annotation> getAnnotations(T annotatableEntity,
                                          MarkerType status,
                                          java.lang.Integer pageSize,
                                          java.lang.Integer pageNumber,
                                          java.util.List<OrderHint> orderHints,
                                          java.util.List<java.lang.String> propertyPaths)

Returns a List of Annotations belonging to the supplied AnnotatableEntity

Parameters:

annotatableEntity - the entity which is annotated

status - The status of the annotations (null to return annotations regardless of status)

pageSize - The maximum number of annotations returned (can be null for all annotations)

pageNumber - The offset (in pageSize chunks) from the start of the result set (0 - based)

orderHints - may be null

propertyPaths - properties to initialize - see IBeanInitializer.initialize(Object, List)

Returns:

a List of Annotation instances

countAnnotations

long countAnnotations(T annotatableEntity,
                      MarkerType status)

Returns a count of Annotations belonging to the supplied AnnotatableEntity

Parameters:

annotatableEntity - the entity which is annotated

status - The status of the annotations (null to count all annotations regardless of status)

Returns:

a count of Annotation instances

countMarkers

long countMarkers(T annotatableEntity,
                  java.lang.Boolean technical)

Returns a count of Markers belonging to the supplied AnnotatableEntity

Parameters:

annotatableEntity - the entity which is marked

technical - The type of MarkerTypes to consider (null to count all markers, regardless of whether the makerType is technical or not)

Returns:

a count of Marker instances

getMarkers

java.util.List<Marker> getMarkers(T annotatableEntity,
                                  java.lang.Boolean technical,
                                  java.lang.Integer pageSize,
                                  java.lang.Integer pageNumber,
                                  java.util.List<OrderHint> orderHints,
                                  java.util.List<java.lang.String> propertyPaths)

Parameters:

annotatableEntity - the entity which is marked

technical - The type of MarkerTypes to consider (null to count all markers, regardless of whether the makerType is technical or not)

pageSize - The maximum number of markers returned (can be null for all markers)

pageNumber - The offset (in pageSize chunks) from the start of the result set (0 - based)

orderHints - may be null

propertyPaths - properties to initialize - see IBeanInitializer.initialize(Object, List)

Returns:

a List of Marker instances

groupMarkers

java.util.List<java.lang.Object[]> groupMarkers(java.lang.Class<? extends T> clazz,
                                                java.lang.Boolean technical,
                                                java.lang.Integer pageSize,
                                                java.lang.Integer pageNumber,
                                                java.util.List<java.lang.String> propertyPaths)

Returns a list of arrays representing counts of entities of type clazz, grouped by their markerTypes. The arrays have two elements. The first element is the MarkerType, initialized using the propertyPaths parameter. The second element is the count of all markers of Objects of type clazz with that MarkerType. The boolean technical can be used to choose only technical or only non-technical marker types. The list is sorted by titleCache of the markerType, in ascending order.

Parameters:

clazz - optionally restrict the markers to those belonging to this class

technical - The type of MarkerTypes to consider (null to count all markers, regardless of whether the makerType is technical or not)

pageSize - The maximum number of arrays returned (can be null for all arrays)

pageNumber - The offset (in pageSize chunks) from the start of the result set (0 - based)

propertyPaths - properties to initialize - see IBeanInitializer.initialize(Object, List)

Returns:

countMarkers

int countMarkers(java.lang.Class<? extends T> clazz,
                 java.lang.Boolean technical)

returns a count of all markers belonging to that clazz, optionally filtered to include only technical or only non-technical markers.

Parameters:

clazz - optionally restrict the markers to those belonging to this class

technical - The type of MarkerTypes to consider (null to count all markers, regardless of whether the makerType is technical or not)

Returns:

a count of markers