de.xima.fc.api.entity

Class GenericAPI

java.lang.Object

de.xima.fc.api.ASubAPI

de.xima.fc.api.entity.GenericAPI

public class GenericAPI
extends ASubAPI

Generic API class for manipulation of entities.
The class provides methods for the basic CRUD functions (Create, Read, Update, Delete).

Author:

XIMA MEDIA GmbH

Constructor Summary

Constructors

Constructor and Description
GenericAPI()

Method Summary

Modifier and Type	Method and Description
<T extends ITransferableEntity> T	create(Class<T> entityClass, UserContext uc, T entity) Method for creating a entity of a defined class.
<T extends ITransferableEntity> T[]	create(Class<T> entityClass, UserContext uc, T[] entities) Method for creating multiple entities of a defined class.
<T extends ITransferableEntity> boolean	delete(Class<T> entityClass, UserContext uc, T entity) Method for deleting a entity of a defined class.
<T extends ITransferableEntity> boolean	delete(Class<T> entityClass, UserContext uc, T[] entities) Method for deleting multiple entities of a defined class.
<T extends ITransferableEntity,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> Boolean	deleteAllBy(Class<T> entityClass, UserContext uc, C cm) Method for deleting multiple entities of a defined class by ID.
<T extends ITransferableEntity> Boolean	deleteAllBy(Class<T> entityClass, UserContext uc, de.xima.cmn.criteria.QueryCriteriaManager qcm) Method for deleting multiple entities of a defined class by ID.
<T extends ITransferableEntity> Boolean	deleteById(Class<T> entityClass, UserContext uc, Integer id)
<T extends ITransferableEntity> Boolean	deleteById(Class<T> entityClass, UserContext uc, Long id) Method for deleting a entity of a defined class by ID.
<T extends ITransferableEntity> List<T>	getAll(Class<T> entityClass, UserContext uc) Method for determining all entities.
<T extends ITransferableEntity,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> List<T>	getAll(Class<T> entityClass, UserContext uc, C cm) Method for determining all entities of a defined class using a Cs.
<T extends ITransferableEntity> List<T>	getAll(Class<T> entityClass, UserContext uc, de.xima.cmn.criteria.QueryCriteriaManager qcm) Method for determining all entities of a defined class using a QueryCriteriaManagers.
<T extends ITransferableEntity,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(Class<T> entityClass, UserContext uc, C cm)
<R,T extends ITransferableEntity,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(Class<T> entityClass, UserContext uc, C cm, Class<R> resultClass)
<T extends ITransferableEntity,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> T	getBy(Class<T> entityClass, UserContext uc, C cm) Method for determining an entity using a QueryCriteriaManager.
<T extends ITransferableEntity> T	getBy(Class<T> entityClass, UserContext uc, de.xima.cmn.criteria.QueryCriteriaManager qcm) Method for determining an entity using a QueryCriteriaManager.
<T extends ITransferableEntity> T	getById(Class<T> entityClass, UserContext uc, Integer id)
<T extends ITransferableEntity> T	getById(Class<T> entityClass, UserContext uc, Long id) Method for reading a entity by class and ID.
<T extends ITransferableEntity> T	getById(UserContext uc, String entityClassName, String id) Method for reading an entity by its class name and ID.
<T extends ITransferableEntity,C extends de.xima.cmn.criteria.interfaces.IFilterableCriteriaManager & de.xima.cmn.criteria.interfaces.IQueryHintProviding> int	resultTotalCount(Class<T> entityClass, UserContext uc, C cm) Method for determining the number of found entities based on their class.
<T extends ITransferableEntity> int	resultTotalCount(Class<T> entityClass, UserContext uc, de.xima.cmn.criteria.QueryCriteriaManager qcm) Method for determining the number of found entities based on their class.
<T extends ITransferableEntity> T	update(Class<T> entityClass, UserContext uc, T entity) Method for updating a entity of a defined class.
<T extends ITransferableEntity> T[]	update(Class<T> entityClass, UserContext uc, T[] entities) Method for updating multiple entities of a defined class.

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

Constructor Detail

GenericAPI

public GenericAPI()

Method Detail

getAll

public <T extends ITransferableEntity> List<T> getAll(Class<T> entityClass,
                                                      UserContext uc,
                                                      de.xima.cmn.criteria.QueryCriteriaManager qcm)

Method for determining all entities of a defined class using a QueryCriteriaManagers.

Parameters:

entityClass - ITransferableEntity class of the entity.

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

qcm - QueryCriteriaManager to be filtered by.

Returns:

List from ITransferableEntity which were found.

Since:

2.4.3

getAll

public <T extends ITransferableEntity,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> List<T> getAll(Class<T> entityClass,
                                                                                                                                                                                                                                                                                                       UserContext uc,
                                                                                                                                                                                                                                                                                                       C cm)

Method for determining all entities of a defined class using a Cs.

Parameters:

entityClass - ITransferableEntity class of the entity.

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

cm - C to be filtered by.

Returns:

List from ITransferableEntity which were found.

Since:

6.2.1

create

public <T extends ITransferableEntity> T create(Class<T> entityClass,
                                                UserContext uc,
                                                T entity)

Method for creating a entity of a defined class.

Parameters:

entityClass - ITransferableEntity class of the entity.

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

entity - ITransferableEntity which should be created.

Returns:

ITransferableEntity which is created.

Since:

2.4.3 @

create

public <T extends ITransferableEntity> T[] create(Class<T> entityClass,
                                                  UserContext uc,
                                                  T[] entities)

Method for creating multiple entities of a defined class.

Parameters:

entityClass - ITransferableEntity class of the entity.

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

entities - Array the entities to create.

Returns:

Array of the created entities.

Since:

2.4.3

delete

public <T extends ITransferableEntity> boolean delete(Class<T> entityClass,
                                                      UserContext uc,
                                                      T entity)

Method for deleting a entity of a defined class.

Parameters:

entityClass - ITransferableEntity class of the entity.

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

entity - ITransferableEntity which should be deleted.

Returns:

Boolean whether the deletion was successful or not.

Since:

2.4.3

delete

public <T extends ITransferableEntity> boolean delete(Class<T> entityClass,
                                                      UserContext uc,
                                                      T[] entities)

Method for deleting multiple entities of a defined class.

Parameters:

entityClass - ITransferableEntity class of the entity.

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

entities - Array the entities to be deleted.

Returns:

Boolean whether the deletion was successful or not.

Since:

2.4.3

getById

public <T extends ITransferableEntity> T getById(Class<T> entityClass,
                                                 UserContext uc,
                                                 Long id)

Method for reading a entity by class and ID.

Parameters:

entityClass - ITransferableEntity class of the entity.

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

id - Long the ID of the searched entity.

Returns:

ITransferableEntity the found entity.

Since:

2.4.3

getById

public <T extends ITransferableEntity> T getById(Class<T> entityClass,
                                                 UserContext uc,
                                                 Integer id)

getById

public <T extends ITransferableEntity> T getById(UserContext uc,
                                                 String entityClassName,
                                                 String id)

Method for reading an entity by its class name and ID.

Parameters:

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

entityClassName - String the class name of the searched entity.

id - Integer the ID of the searched entity.

Returns:

ITransferableEntity the found entity.

Since:

2.4.3

getAttributes

public <T extends ITransferableEntity,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(Class<T> entityClass,
                                                                                                                                                                                                                                                                                                                                                                                                  UserContext uc,
                                                                                                                                                                                                                                                                                                                                                                                                  C cm)
                                                                                                                                                                                                                                                                                                                                                                                           throws NotSerializableException

Throws:

NotSerializableException

getAttributes

public <R,T extends ITransferableEntity,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(Class<T> entityClass,
                                                                                                                                                                                                                                                                                                                                                                             UserContext uc,
                                                                                                                                                                                                                                                                                                                                                                             C cm,
                                                                                                                                                                                                                                                                                                                                                                             Class<R> resultClass)

resultTotalCount

public <T extends ITransferableEntity> int resultTotalCount(Class<T> entityClass,
                                                            UserContext uc,
                                                            de.xima.cmn.criteria.QueryCriteriaManager qcm)

Method for determining the number of found entities based on their class.

Parameters:

entityClass - ITransferableEntity class of the entity.

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

qcm - QueryCriteriaManager to be searched by.

Returns:

Integer the found number of elements QueryCriteriaManagers.

Since:

2.4.3

resultTotalCount

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

Method for determining the number of found entities based on their class.

Parameters:

entityClass - ITransferableEntity class of the entity.

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

cm - C to be searched by.

Returns:

Integer the found number of elements Cs.

Since:

6.2.1

update

public <T extends ITransferableEntity> T[] update(Class<T> entityClass,
                                                  UserContext uc,
                                                  T[] entities)

Method for updating multiple entities of a defined class.

Parameters:

entityClass - ITransferableEntity class of the entity.

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

entities - Array the entities to be updated.

Returns:

Array the updated entities.

Since:

2.4.3

update

public <T extends ITransferableEntity> T update(Class<T> entityClass,
                                                UserContext uc,
                                                T entity)

Method for updating a entity of a defined class.

Parameters:

entityClass - ITransferableEntity class of the entity.

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

entity - ITransferableEntity which should be updated.

Returns:

ITransferableEntity the updated entity.

Since:

2.4.3

getBy

public <T extends ITransferableEntity> T getBy(Class<T> entityClass,
                                               UserContext uc,
                                               de.xima.cmn.criteria.QueryCriteriaManager qcm)

Method for determining an entity using a QueryCriteriaManager.

Parameters:

entityClass - ITransferableEntity class of the entity.

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

qcm - the QueryCriteriaManager to be searched by.

Returns:

the found entity.

Since:

2.4.3

getBy

public <T extends ITransferableEntity,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> T getBy(Class<T> entityClass,
                                                                                                                                                                                                                                                                                                UserContext uc,
                                                                                                                                                                                                                                                                                                C cm)

Method for determining an entity using a QueryCriteriaManager.

Parameters:

entityClass - ITransferableEntity class of the entity.

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

cm - the C to be searched by.

Returns:

the found entity.

Since:

6.2.1

deleteAllBy

public <T extends ITransferableEntity> Boolean deleteAllBy(Class<T> entityClass,
                                                           UserContext uc,
                                                           de.xima.cmn.criteria.QueryCriteriaManager qcm)

Method for deleting multiple entities of a defined class by ID.

Parameters:

entityClass - ITransferableEntity class of the entity.

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

qcm - QueryCriteriaManager to be searched by.

Returns:

Boolean whether the deletion was successful or not.

Since:

2.4.3

deleteAllBy

public <T extends ITransferableEntity,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> Boolean deleteAllBy(Class<T> entityClass,
                                                                                                                                                                                                                                                                                                            UserContext uc,
                                                                                                                                                                                                                                                                                                            C cm)

Method for deleting multiple entities of a defined class by ID.

Parameters:

entityClass - ITransferableEntity class of the entity.

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

cm - C to be searched by.

Returns:

Boolean whether the deletion was successful or not.

Since:

6.2.1

deleteById

public <T extends ITransferableEntity> Boolean deleteById(Class<T> entityClass,
                                                          UserContext uc,
                                                          Long id)

Method for deleting a entity of a defined class by ID.

Parameters:

entityClass - ITransferableEntity class of the entity.

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

id - Long the ID of the searched entity.

Returns:

Boolean whether the deletion was successful or not.

Since:

2.4.3

deleteById

public <T extends ITransferableEntity> Boolean deleteById(Class<T> entityClass,
                                                          UserContext uc,
                                                          Integer id)

getAll

public <T extends ITransferableEntity> List<T> getAll(Class<T> entityClass,
                                                      UserContext uc)

Method for determining all entities.

Parameters:

entityClass - ITransferableEntity class of the entity.

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

Returns:

List of the found entities.

Since:

2.4.3