org.cyclos.impl.utils.persistence

Interface EntityManagerHandler

All Superinterfaces:

BaseEntityManagerHandler

public interface EntityManagerHandler
extends BaseEntityManagerHandler

Handler for EntityManager and EntityManagerFactory access

Author:

luis

Method Summary

Modifier and Type	Method and Description
void	checkAccess(IEntity entity) If isAccessible(IEntity) would return false, throw a PermissionDeniedException
<E extends IInternalNamedEntity> E	find(java.lang.Class<E> entityClass, java.lang.String internalName) Finds the given entity by internal name in the current network.
<E extends IInternalNamedEntity> E	find(java.lang.Class<E> entityClass, java.lang.String internalName, SimpleEntity ownerEntity) Finds the given entity by internal name in the current network filtering by the specified owner entity.
java.lang.String	getQualifiedInternalName(IInternalNamedEntity entity) Resolves the fully qualified internal name, from the topmost owner entity.
boolean	isAccessible(IEntity entity) Checks whether the given entity is accessible, that means, the logged user can either directly or indirectly view this entity.

Methods inherited from interface org.cyclos.impl.utils.persistence.BaseEntityManagerHandler

clear, delete, detach, find, flush, from, persist, persist, refresh, remove, remove, selectFrom, subQuery, update

Method Detail

checkAccess

void checkAccess(IEntity entity)
          throws PermissionDeniedException

If isAccessible(IEntity) would return false, throw a PermissionDeniedException

Throws:

PermissionDeniedException

find

<E extends IInternalNamedEntity> E find(java.lang.Class<E> entityClass,
                                        java.lang.String internalName)
                                 throws EntityNotFoundException

Finds the given entity by internal name in the current network.
If the entity was not found and entityClass is a INamedEntity then it try to find by name. Supports nesting of internal names, like finding a transfer type by account_type/transfer_type.

Throws:

EntityNotFoundException

find

<E extends IInternalNamedEntity> E find(java.lang.Class<E> entityClass,
                                        java.lang.String internalName,
                                        SimpleEntity ownerEntity)
                                 throws EntityNotFoundException

Finds the given entity by internal name in the current network filtering by the specified owner entity.
If the entity was not found and entityClass is a INamedEntity then it try to find by name. Supports nesting of internal names, like finding a transfer type by account_type/transfer_type.

Parameters:

ownerEntity - the entity used as a filter

Throws:

EntityNotFoundException

getQualifiedInternalName

java.lang.String getQualifiedInternalName(IInternalNamedEntity entity)

Resolves the fully qualified internal name, from the topmost owner entity. For example, for a transfer type, would return account_type/transfer_type. If any of the levels has a null internal name, returns null.

isAccessible

boolean isAccessible(IEntity entity)

Checks whether the given entity is accessible, that means, the logged user can either directly or indirectly view this entity. For example, a regular user cannot view all group details, but he can work with his own group.