ome.security.basic

Class OmeroInterceptor

java.lang.Object

ome.security.basic.OmeroInterceptor

All Implemented Interfaces:

org.hibernate.Interceptor

public class OmeroInterceptor
extends Object
implements org.hibernate.Interceptor

implements Interceptor for controlling various aspects of the Hibernate runtime. Where no special requirements exist, methods delegate to EmptyInterceptor Current responsibilities include the proper (re-)setting of Details

Since:

3.0-M3

Version:

$Revision$, $Date$

Author:

Josh Moore, josh.moore at gmx.de

See Also:

EmptyInterceptor, Interceptor

Constructor Summary

Constructors

Constructor and Description
OmeroInterceptor(Roles roles, SystemTypes sysTypes, ExtendedMetadata em, CurrentDetails cd, TokenHolder tokenHolder, SessionStats stats)

Method Summary

Modifier and Type	Method and Description
void	afterTransactionBegin(org.hibernate.Transaction tx)
void	afterTransactionCompletion(org.hibernate.Transaction tx)
void	beforeTransactionCompletion(org.hibernate.Transaction tx)
Details	checkManagedDetails(IObject iobj, Details previousDetails)
protected Details	checkManagedDetails(IObject iobj, Details previousDetails, Details newDetails) Like checkManagedDetails(IObject, Details, Details) but allows passing in a specific Details instance.
Details	evaluateLinkages(IObject changedObject) Checks the details of the objects which the given object links to in order to guarantee that linkages are valid.
int[]	findDirty(Object entity, Serializable id, Object[] currentState, Object[] previousState, String[] propertyNames, org.hibernate.type.Type[] types) default logic
Object	getEntity(String entityName, Serializable id)
String	getEntityName(Object object)
Object	instantiate(String entityName, org.hibernate.EntityMode entityMode, Serializable id) default logic, but we may want to use them eventually for dependency-injection.
Boolean	isTransient(Object entity)
protected void	log(String msg)
protected boolean	managedEvent(boolean privileged, IObject obj, Details previousDetails, Details currentDetails, Details newDetails)
protected boolean	managedExternalInfo(boolean privileged, IObject obj, Details previousDetails, Details currentDetails, Details newDetails) Deprecated.
protected boolean	managedGroup(boolean privileged, IObject obj, Details previousDetails, Details currentDetails, Details newDetails, BasicEventContext bec)
protected boolean	managedOwner(boolean privileged, IObject obj, Details previousDetails, Details currentDetails, Details newDetails, BasicEventContext bec)
protected Permissions.Right	neededRight(Class<?> changedClass, Class<?> linkedClass) The default right need for a linkage is Permissions.Right.WRITE.
Details	newTransientDetails(IObject obj)
protected Details	newTransientDetails(IObject obj, Details newDetails) Like newTransientDetails(IObject) but allows passing in a newDetails object with possibly preset values.
void	onCollectionRecreate(Object collection, Serializable key)
void	onCollectionRemove(Object collection, Serializable key)
void	onCollectionUpdate(Object collection, Serializable key)
void	onDelete(Object entity, Serializable id, Object[] state, String[] propertyNames, org.hibernate.type.Type[] types) default logic
boolean	onFlushDirty(Object entity, Serializable id, Object[] currentState, Object[] previousState, String[] propertyNames, org.hibernate.type.Type[] types) calls back to BasicSecuritySystem.checkManagedDetails(IObject, Details) for properly setting Details.
boolean	onLoad(Object entity, Serializable id, Object[] state, String[] propertyNames, org.hibernate.type.Type[] types) default logic.
String	onPrepareStatement(String sql)
boolean	onSave(Object entity, Serializable id, Object[] state, String[] propertyNames, org.hibernate.type.Type[] types) callsback to BasicSecuritySystem.newTransientDetails(IObject) for properly setting Details
void	postFlush(Iterator entities)
void	preFlush(Iterator entities)
protected boolean	resetDetails(IObject entity, Object[] currentState, Object[] previousState, int idx, Details newDetails) asks BasicSecuritySystem to create a new managed Details based on the previous state of this entity.

Methods inherited from class java.lang.Object

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

Constructor Detail

OmeroInterceptor

public OmeroInterceptor(Roles roles,
                        SystemTypes sysTypes,
                        ExtendedMetadata em,
                        CurrentDetails cd,
                        TokenHolder tokenHolder,
                        SessionStats stats)

Method Detail

instantiate

public Object instantiate(String entityName,
                          org.hibernate.EntityMode entityMode,
                          Serializable id)
                   throws org.hibernate.CallbackException

default logic, but we may want to use them eventually for dependency-injection.

Specified by:

instantiate in interface org.hibernate.Interceptor

Throws:

org.hibernate.CallbackException

onLoad

public boolean onLoad(Object entity,
                      Serializable id,
                      Object[] state,
                      String[] propertyNames,
                      org.hibernate.type.Type[] types)
               throws org.hibernate.CallbackException

default logic.

Specified by:

onLoad in interface org.hibernate.Interceptor

Throws:

org.hibernate.CallbackException

findDirty

public int[] findDirty(Object entity,
                       Serializable id,
                       Object[] currentState,
                       Object[] previousState,
                       String[] propertyNames,
                       org.hibernate.type.Type[] types)

default logic

Specified by:

findDirty in interface org.hibernate.Interceptor

onSave

public boolean onSave(Object entity,
                      Serializable id,
                      Object[] state,
                      String[] propertyNames,
                      org.hibernate.type.Type[] types)

callsback to BasicSecuritySystem.newTransientDetails(IObject) for properly setting Details

Specified by:

onSave in interface org.hibernate.Interceptor

onFlushDirty

public boolean onFlushDirty(Object entity,
                            Serializable id,
                            Object[] currentState,
                            Object[] previousState,
                            String[] propertyNames,
                            org.hibernate.type.Type[] types)

calls back to BasicSecuritySystem.checkManagedDetails(IObject, Details) for properly setting Details.

Specified by:

onFlushDirty in interface org.hibernate.Interceptor

onDelete

public void onDelete(Object entity,
                     Serializable id,
                     Object[] state,
                     String[] propertyNames,
                     org.hibernate.type.Type[] types)
              throws org.hibernate.CallbackException

default logic

Specified by:

onDelete in interface org.hibernate.Interceptor

Throws:

org.hibernate.CallbackException

onCollectionRecreate

public void onCollectionRecreate(Object collection,
                                 Serializable key)
                          throws org.hibernate.CallbackException

Specified by:

onCollectionRecreate in interface org.hibernate.Interceptor

Throws:

org.hibernate.CallbackException

onCollectionRemove

public void onCollectionRemove(Object collection,
                               Serializable key)
                        throws org.hibernate.CallbackException

Specified by:

onCollectionRemove in interface org.hibernate.Interceptor

Throws:

org.hibernate.CallbackException

onCollectionUpdate

public void onCollectionUpdate(Object collection,
                               Serializable key)
                        throws org.hibernate.CallbackException

Specified by:

onCollectionUpdate in interface org.hibernate.Interceptor

Throws:

org.hibernate.CallbackException

preFlush

public void preFlush(Iterator entities)
              throws org.hibernate.CallbackException

Specified by:

preFlush in interface org.hibernate.Interceptor

Throws:

org.hibernate.CallbackException

postFlush

public void postFlush(Iterator entities)
               throws org.hibernate.CallbackException

Specified by:

postFlush in interface org.hibernate.Interceptor

Throws:

org.hibernate.CallbackException

afterTransactionBegin

public void afterTransactionBegin(org.hibernate.Transaction tx)

Specified by:

afterTransactionBegin in interface org.hibernate.Interceptor

afterTransactionCompletion

public void afterTransactionCompletion(org.hibernate.Transaction tx)

Specified by:

afterTransactionCompletion in interface org.hibernate.Interceptor

beforeTransactionCompletion

public void beforeTransactionCompletion(org.hibernate.Transaction tx)

Specified by:

beforeTransactionCompletion in interface org.hibernate.Interceptor

getEntity

public Object getEntity(String entityName,
                        Serializable id)
                 throws org.hibernate.CallbackException

Specified by:

getEntity in interface org.hibernate.Interceptor

Throws:

org.hibernate.CallbackException

getEntityName

public String getEntityName(Object object)
                     throws org.hibernate.CallbackException

Specified by:

getEntityName in interface org.hibernate.Interceptor

Throws:

org.hibernate.CallbackException

isTransient

public Boolean isTransient(Object entity)

Specified by:

isTransient in interface org.hibernate.Interceptor

onPrepareStatement

public String onPrepareStatement(String sql)

Specified by:

onPrepareStatement in interface org.hibernate.Interceptor

resetDetails

protected boolean resetDetails(IObject entity,
                               Object[] currentState,
                               Object[] previousState,
                               int idx,
                               Details newDetails)

asks BasicSecuritySystem to create a new managed Details based on the previous state of this entity. If the previous state is null (see ticket:3929) then throw an exception.

Parameters:

entity - IObject to be updated

currentState - the possibly changed field data for this entity

previousState - the field data as seen in the db

idx - the index of Details in the state arrays.

log

protected void log(String msg)

evaluateLinkages

public Details evaluateLinkages(IObject changedObject)

Checks the details of the objects which the given object links to in order to guarantee that linkages are valid. In the case of a non-specific UID or GID, then the Details object returned by this method can be used as the basis for unknown user/group. This method is called during save and update since this is the only time that new entity references can be created.

Parameters:

changedObject - new or updated entity which may reference other entities which then require locking. Nulls are tolerated but do nothing.

neededRight

protected Permissions.Right neededRight(Class<?> changedClass,
                                        Class<?> linkedClass)

The default right need for a linkage is Permissions.Right.WRITE. If however, this is only an annotation or only a viewing, then less permission is needed.

Parameters:

changedClass - the changed class

linkedClass - the linked class

Returns:

the right that is needed

newTransientDetails

public Details newTransientDetails(IObject obj)

See Also:

SecuritySystem.newTransientDetails(IObject)

newTransientDetails

protected Details newTransientDetails(IObject obj,
                                      Details newDetails)

Like newTransientDetails(IObject) but allows passing in a newDetails object with possibly preset values.

See Also:

evaluateLinkages(IObject)

checkManagedDetails

public Details checkManagedDetails(IObject iobj,
                                   Details previousDetails)

See Also:

SecuritySystem.checkManagedDetails(IObject, Details)

checkManagedDetails

protected Details checkManagedDetails(IObject iobj,
                                      Details previousDetails,
                                      Details newDetails)

Like checkManagedDetails(IObject, Details, Details) but allows passing in a specific Details instance.

See Also:

SecuritySystem.checkManagedDetails(IObject, Details), evaluateLinkages(IObject)

managedExternalInfo

@Deprecated
protected boolean managedExternalInfo(boolean privileged,
                                                  IObject obj,
                                                  Details previousDetails,
                                                  Details currentDetails,
                                                  Details newDetails)

Deprecated.

responsible for guaranteeing that external info is not modified by any users, including root. This does not apply to the "client concern" fields which can be modified after the fact.

Parameters:

privileged - if the user is privileged

obj - the model object

previousDetails - details representing the known DB state

currentDetails - details representing the user request (UNTRUSTED)

newDetails - details from the current context. Holder for the merged Permissions

Returns:

true if the Permissions of newDetails are changed.

managedOwner

protected boolean managedOwner(boolean privileged,
                               IObject obj,
                               Details previousDetails,
                               Details currentDetails,
                               Details newDetails,
                               BasicEventContext bec)

managedGroup

protected boolean managedGroup(boolean privileged,
                               IObject obj,
                               Details previousDetails,
                               Details currentDetails,
                               Details newDetails,
                               BasicEventContext bec)

managedEvent

protected boolean managedEvent(boolean privileged,
                               IObject obj,
                               Details previousDetails,
                               Details currentDetails,
                               Details newDetails)