de.xima.fc.api.entity

Class AEntityAPI<T extends ITransferableEntity>

java.lang.Object

de.xima.fc.api.ASubAPI

de.xima.fc.api.entity.AEntityAPI<T>

Type Parameters:

T - Type of the entity, which inherits from AbstractLockableEntity.

Direct Known Subclasses:

AktionAPI, AppointmentAPI, AppointmentSlotAPI, AppointmentTemplateAPI, AppointmentTypeAPI, AttachmentAPI, BedingungAPI, BenutzerAPI, BenutzerGruppeAPI, DatenbankZugriffAPI, DatenquelleAPI, EntityberechtigungAPI, FormEingangAPI, FormElementAPI, FormVersionAPI, FrontendServerAPI, FSConnectionAPI, LDAPAbfrageAPI, LDAPGruppeAPI, LDAPZugriffAPI, MandantAPI, MandantFrontendServerAPI, MandantLdapDataAPI, MandantMailDataAPI, MandantRessourcenAPI, ModulAPI, PostfachAPI, ProjectAuthenticatorConfigAPI, ProjectDOIDataAPI, ProjektAPI, ProjektRessourcenAPI, ProjektZaehlerAPI, ProjektZaehlerDatenAPI, RolleAPI, StatusAPI, SystemPropertyAPI, TextbausteinAPI, VorgangAPI

public abstract class AEntityAPI<T extends ITransferableEntity>
extends ASubAPI

Abstract class with diffrent CRUD operations for entities of the type ITransferableEntity.

Author:

XIMA MEDIA GmbH

Field Summary

Fields

Modifier and Type	Field and Description
protected Class<T>	entityClass

Constructor Summary

Constructors

Constructor and Description
AEntityAPI() Instantiates a new entity API.

Method Summary

Modifier and Type	Method and Description
T	create(UserContext uc, T entity) Method for creating a entity.
T[]	create(UserContext uc, T[] entities) Method for creating multiple entities.
Boolean	delete(UserContext uc, T entity) Method for deleting a entity.
Boolean	delete(UserContext uc, T[] entities) Method for deleting multiple entities.
Boolean	deleteAllBy(UserContext uc, de.xima.cmn.criteria.QueryCriteriaManager qcm) Method for deleting entities using a QueryCriteriaManagers.
Boolean	deleteById(UserContext uc, Integer id)
Boolean	deleteById(UserContext uc, Long id) Method for deleting a entity by ID.
List<T>	getAll(UserContext uc) Method for determining all available entities in the user context.
List<T>	getAllBy(UserContext uc, de.xima.cmn.criteria.QueryCriteriaManager qcm) Method for determining all entities using a QueryCriteriaManagers.
<C extends de.xima.cmn.criteria.interfaces.IFilterableCriteriaManager & de.xima.cmn.criteria.interfaces.ISortableCriteriaManager & de.xima.cmn.criteria.interfaces.IPageableCriteriaManager & de.xima.cmn.criteria.interfaces.IQueryHintProviding & de.xima.cmn.criteria.interfaces.ISelectableCriteriaManager> List<Map<String,Serializable>>	getAttributes(UserContext uc, C cm) This method allows for the selection of certain attributes of entities instead of reading the entire entity
<R,C extends de.xima.cmn.criteria.interfaces.IFilterableCriteriaManager & de.xima.cmn.criteria.interfaces.ISortableCriteriaManager & de.xima.cmn.criteria.interfaces.IPageableCriteriaManager & de.xima.cmn.criteria.interfaces.IQueryHintProviding & de.xima.cmn.criteria.interfaces.ISelectableCriteriaManager> List<R>	getAttributes(UserContext uc, C cm, Class<R> resultClass) This method allows for the selection of certain attributes of entities instead of reading the entire entity.
T	getBy(UserContext uc, de.xima.cmn.criteria.QueryCriteriaManager qcm) Method for determining an entity using a QueryCriteriaManagers.
T	getById(UserContext uc, Integer id)
T	getById(UserContext uc, Long id) Method for determining an entity by ID.
<C extends de.xima.cmn.criteria.interfaces.IFilterableCriteriaManager & de.xima.cmn.criteria.interfaces.ISortableCriteriaManager & de.xima.cmn.criteria.interfaces.IPageableCriteriaManager & de.xima.cmn.criteria.interfaces.IQueryHintProviding & de.xima.cmn.criteria.interfaces.ISelectableCriteriaManager> javax.persistence.Tuple	getSingleAttributes(UserContext uc, C cm) This method allows for the selection of certain attributes of an entity instead of reading the entire entity
<R,C extends de.xima.cmn.criteria.interfaces.IFilterableCriteriaManager & de.xima.cmn.criteria.interfaces.ISortableCriteriaManager & de.xima.cmn.criteria.interfaces.IPageableCriteriaManager & de.xima.cmn.criteria.interfaces.IQueryHintProviding & de.xima.cmn.criteria.interfaces.ISelectableCriteriaManager> R	getSingleAttributes(UserContext uc, C cm, Class<R> resultClass) This method allows for the selection of certain attributes of an entity instead of reading the entire entity
<C extends de.xima.cmn.criteria.interfaces.IFilterableCriteriaManager & de.xima.cmn.criteria.interfaces.IQueryHintProviding> int	resultTotalCount(UserContext uc, C cm) Method for determining the number of hits when searching for entities using a IFilterableCriteriaManager.
int	resultTotalCount(UserContext uc, de.xima.cmn.criteria.QueryCriteriaManager qcm) Method for determining the number of hits when searching for entities using a QueryCriteriaManager.
T	update(UserContext uc, T entity) Method for updating a entity.
T[]	update(UserContext uc, T[] entities) Method for updating multiple entities.

Methods inherited from class de.xima.fc.api.ASubAPI

getHandlerProvider

Methods inherited from class java.lang.Object

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

Field Detail

entityClass

protected Class<T extends ITransferableEntity> entityClass

Constructor Detail

AEntityAPI

public AEntityAPI()

Instantiates a new entity API.

Method Detail

create

public T create(UserContext uc,
                T entity)

Method for creating a entity.

Parameters:

uc - UserContext the user context in which the action is to be performed.

entity - the entity to be created.

Returns:

The created entity.

create

public T[] create(UserContext uc,
                  T[] entities)

Method for creating multiple entities.

Parameters:

uc - UserContext the user context in which the action is to be performed.

entities - a Array of the entities to be created.

Returns:

Array of the created entities.

update

public T update(UserContext uc,
                T entity)

Method for updating a entity.

Parameters:

uc - UserContext the user context in which the action is to be performed.

entity - the entity to be update.

Returns:

The updated entity.

delete

public Boolean delete(UserContext uc,
                      T entity)

Method for deleting a entity.

Parameters:

uc - UserContext the user context in which the action is to be performed.

entity - the entity to be deleted.

Returns:

Boolean if the deletion was successful.

delete

public Boolean delete(UserContext uc,
                      T[] entities)

Method for deleting multiple entities.

Parameters:

uc - UserContext the user context in which the action is to be performed.

entities - a Array of the entities to be deleted.

Returns:

Boolean if the deletion was successful.

update

public T[] update(UserContext uc,
                  T[] entities)

Method for updating multiple entities.

Parameters:

uc - UserContext the user context in which the action is to be performed.

entities - a Array of the entities to be updated.

Returns:

Array with the updated entities.

getAll

public List<T> getAll(UserContext uc)

Method for determining all available entities in the user context.

Parameters:

uc - UserContext the user context in which the action is to be performed.

Returns:

List of the available entities.

getById

public T getById(UserContext uc,
                 Long id)

Method for determining an entity by ID.

Parameters:

uc - UserContext the user context in which the action is to be performed.

id - Integer the ID of the entity.

Returns:

The searched entity.

getById

public T getById(UserContext uc,
                 Integer id)

deleteById

public Boolean deleteById(UserContext uc,
                          Long id)

Method for deleting a entity by ID.

Parameters:

uc - UserContext the user context in which the action is to be performed.

id - Long the ID of the entity to be deleted.

Returns:

Boolean if the deletion was successful.

deleteById

public Boolean deleteById(UserContext uc,
                          Integer id)

resultTotalCount

public int resultTotalCount(UserContext uc,
                            de.xima.cmn.criteria.QueryCriteriaManager qcm)

Method for determining the number of hits when searching for entities using a QueryCriteriaManager.

Parameters:

uc - UserContext the user context in which the action is to be performed.

qcm - the QueryCriteriaManager which should be used for the search.

Returns:

Integer the found number of entities

resultTotalCount

public <C extends de.xima.cmn.criteria.interfaces.IFilterableCriteriaManager & de.xima.cmn.criteria.interfaces.IQueryHintProviding> int resultTotalCount(UserContext uc,
                                                                                                                                                         C cm)

Method for determining the number of hits when searching for entities using a IFilterableCriteriaManager.

Parameters:

uc - UserContext the user context in which the action is to be performed.

cm - the IFilterableCriteriaManager which should be used for the search.

Returns:

Integer the found number of entities

getBy

public T getBy(UserContext uc,
               de.xima.cmn.criteria.QueryCriteriaManager qcm)

Method for determining an entity using a QueryCriteriaManagers.

Parameters:

uc - UserContext the user context in which the action is to be performed.

qcm - the QueryCriteriaManager which should be used for the search.

Returns:

The found entity.

getAllBy

public List<T> getAllBy(UserContext uc,
                        de.xima.cmn.criteria.QueryCriteriaManager qcm)

Method for determining all entities using a QueryCriteriaManagers.

Parameters:

uc - UserContext the user context in which the action is to be performed.

qcm - the QueryCriteriaManager which should be used for the search.

Returns:

List the found entities.

getAttributes

public <C extends de.xima.cmn.criteria.interfaces.IFilterableCriteriaManager & de.xima.cmn.criteria.interfaces.ISortableCriteriaManager & de.xima.cmn.criteria.interfaces.IPageableCriteriaManager & de.xima.cmn.criteria.interfaces.IQueryHintProviding & de.xima.cmn.criteria.interfaces.ISelectableCriteriaManager> List<Map<String,Serializable>> getAttributes(UserContext uc,
                                                                                                                                                                                                                                                                                                                                                                    C cm)
                                                                                                                                                                                                                                                                                                                                                             throws NotSerializableException

This method allows for the selection of certain attributes of entities instead of reading the entire entity

Type Parameters:

C - type of the criteria manager

Parameters:

uc - UserContext which will be used for the transaction

cm - the criteria manager used for filtering, sorting, selecting, paging

Returns:

List of Maps that contain the values of the selected attributes

Throws:

NotSerializableException - when attributes are not serializable

getAttributes

public <R,C extends de.xima.cmn.criteria.interfaces.IFilterableCriteriaManager & de.xima.cmn.criteria.interfaces.ISortableCriteriaManager & de.xima.cmn.criteria.interfaces.IPageableCriteriaManager & de.xima.cmn.criteria.interfaces.IQueryHintProviding & de.xima.cmn.criteria.interfaces.ISelectableCriteriaManager> List<R> getAttributes(UserContext uc,
                                                                                                                                                                                                                                                                                                                                               C cm,
                                                                                                                                                                                                                                                                                                                                               Class<R> resultClass)

This method allows for the selection of certain attributes of entities instead of reading the entire entity. That result will be returned in form of a list of objects. These objects are defined by the given result class

Type Parameters:

R - type of result class

C - type of the criteria manager

Parameters:

uc - UserContext which will be used for the transaction

cm - the criteria manager used for filtering, sorting, selecting, paging

Returns:

List of objects that contain the values of the selected attributes

getSingleAttributes

public <C extends de.xima.cmn.criteria.interfaces.IFilterableCriteriaManager & de.xima.cmn.criteria.interfaces.ISortableCriteriaManager & de.xima.cmn.criteria.interfaces.IPageableCriteriaManager & de.xima.cmn.criteria.interfaces.IQueryHintProviding & de.xima.cmn.criteria.interfaces.ISelectableCriteriaManager> javax.persistence.Tuple getSingleAttributes(UserContext uc,
                                                                                                                                                                                                                                                                                                                                                                   C cm)

This method allows for the selection of certain attributes of an entity instead of reading the entire entity

Type Parameters:

T - type of entity

C - type of the criteria manager

Parameters:

uc - UserContext which will be used

cm - C object, that contains lists for filtering, sorting and selecting. These lists, if available, are included in the SQL query. This value can be null. The lists contained in the C can also be null or empty.

Returns:

Tuple that contains the values of the selected attributes

Since:

6.6.0

getSingleAttributes

public <R,C extends de.xima.cmn.criteria.interfaces.IFilterableCriteriaManager & de.xima.cmn.criteria.interfaces.ISortableCriteriaManager & de.xima.cmn.criteria.interfaces.IPageableCriteriaManager & de.xima.cmn.criteria.interfaces.IQueryHintProviding & de.xima.cmn.criteria.interfaces.ISelectableCriteriaManager> R getSingleAttributes(UserContext uc,
                                                                                                                                                                                                                                                                                                                                               C cm,
                                                                                                                                                                                                                                                                                                                                               Class<R> resultClass)

This method allows for the selection of certain attributes of an entity instead of reading the entire entity

Type Parameters:

R - type of object, in which the result values will be placed

T - type of entity

C - type of the criteria manager

Parameters:

ec - UserContext which will be used

cm - C object, that contains lists for filtering, sorting and selecting. These lists, if available, are included in the SQL query. This value can be null. The lists contained in the C can also be null or empty.

resultClass - Class of the object, in which the result value will be placed

Returns:

R that contains the values of the selected attributes

Since:

6.6.0

deleteAllBy

public Boolean deleteAllBy(UserContext uc,
                           de.xima.cmn.criteria.QueryCriteriaManager qcm)

Method for deleting entities using a QueryCriteriaManagers.

Parameters:

uc - UserContext the user context in which the action is to be performed.

qcm - the QueryCriteriaManager which should be used when deleting.

Returns:

Boolean if the deletion was successful.