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:

Michael Kohlsche

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> 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> 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> 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> 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

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

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

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

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

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