org.openmrs.api.db.hibernate

Class ImmutableEntityInterceptor

java.lang.Object

org.hibernate.EmptyInterceptor

org.openmrs.api.db.hibernate.ImmutableEntityInterceptor

All Implemented Interfaces:

java.io.Serializable, org.hibernate.Interceptor

Direct Known Subclasses:

ImmutableOrderInterceptor

public abstract class ImmutableEntityInterceptor
extends org.hibernate.EmptyInterceptor

Superclass for all Interceptors that would like to ensure that changes to immutable entities of specific types don't get persisted to the database, more granularity of the immutable properties is also supported so as to allow editing some properties while not for others

 NOTE: Subclasses MUST not make any changes to the persistent object because they get 
 called last, if they make any changes other interceptors would never know about them.
 

Since:

1.10

See Also:

Serialized Form

Field Summary

Fields inherited from class org.hibernate.EmptyInterceptor

INSTANCE

Constructor Summary

Constructors

Constructor and Description
ImmutableEntityInterceptor()

Method Summary

Modifier and Type	Method and Description
protected java.lang.String[]	getMutablePropertyNames() Subclasses can override this to return fields that are allowed to be edited, returning null or an empty array implies the entity is immutable
protected abstract java.lang.Class<?>	getSupportedType() Returns the class handled by the interceptor
protected boolean	ignoreVoidedOrRetiredObjects() Subclasses can override this to specify whether voided or retired items are mutable
boolean	onFlushDirty(java.lang.Object entity, java.io.Serializable id, java.lang.Object[] currentState, java.lang.Object[] previousState, java.lang.String[] propertyNames, org.hibernate.type.Type[] types)

Methods inherited from class org.hibernate.EmptyInterceptor

afterTransactionBegin, afterTransactionCompletion, beforeTransactionCompletion, findDirty, getEntity, getEntityName, instantiate, isTransient, onCollectionRecreate, onCollectionRemove, onCollectionUpdate, onDelete, onLoad, onPrepareStatement, onSave, postFlush, preFlush

Methods inherited from class java.lang.Object

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

Constructor Detail

ImmutableEntityInterceptor

public ImmutableEntityInterceptor()

Method Detail

getSupportedType

protected abstract java.lang.Class<?> getSupportedType()

Returns the class handled by the interceptor

getMutablePropertyNames

protected java.lang.String[] getMutablePropertyNames()

Subclasses can override this to return fields that are allowed to be edited, returning null or an empty array implies the entity is immutable

Returns:

an array of properties

ignoreVoidedOrRetiredObjects

protected boolean ignoreVoidedOrRetiredObjects()

Subclasses can override this to specify whether voided or retired items are mutable

Returns:

true if voided or retired objects are mutable otherwise false means they are immutable

onFlushDirty

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

Specified by:

onFlushDirty in interface org.hibernate.Interceptor

Overrides:

onFlushDirty in class org.hibernate.EmptyInterceptor

See Also:

EmptyInterceptor.onFlushDirty(Object, java.io.Serializable, Object[], Object[], String[], org.hibernate.type.Type[])