com.avaje.ebean.bean

Class EntityBeanIntercept

java.lang.Object

com.avaje.ebean.bean.EntityBeanIntercept

All Implemented Interfaces:

Serializable

public final class EntityBeanIntercept
extends Object
implements Serializable

This is the object added to every entity bean using byte code enhancement.

This provides the mechanisms to support deferred fetching of reference beans and oldValues generation for concurrency checking.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
EntityBeanIntercept(Object owner) Create a intercept with a given entity.

Method Summary

Methods

Modifier and Type	Method and Description
void	addPropertyChangeListener(PropertyChangeListener listener) Add a property change listener for this entity bean.
void	addPropertyChangeListener(String propertyName, PropertyChangeListener listener) Add a property change listener for this entity bean for a specific property.
protected boolean	areEqual(Object obj1, Object obj2) Helper method to check if two objects are equal.
void	copyStateTo(EntityBeanIntercept dest) Copy the internal state of the intercept to another intercept.
protected void	createOldValues() Create a copy of the bean as it is now.
int	getBeanLoaderIndex() Return the index position for batch loading via BeanLoader.
Set<String>	getChangedProps() Return the set of property names for changed properties.
String	getLazyLoadProperty() Return the property read or write that triggered the lazy load.
Set<String>	getLoadedProps() Return the set of property names for a partially loaded bean.
Object	getOldValues() Return the old values used for ConcurrencyMode.ALL.
EntityBean	getOwner() Return the 'owning' entity bean.
Object	getParentBean() Return the parent bean (by relationship).
PersistenceContext	getPersistenceContext() Return the persistenceContext.
boolean	isDirty() Return true if this bean has been directly modified (it has oldValues) or if any embedded beans are either new or dirty (and hence need saving).
boolean	isDisableLazyLoad() Return true if lazy loading is disabled.
boolean	isEmbeddedNewOrDirty(Object embeddedBean) Return true if the embedded bean is new or dirty and hence needs saving.
boolean	isIntercepting() Return true if the bean currently has interception on.
boolean	isLazyLoadFailure() Return true if the bean is marked as having failed lazy loading.
boolean	isLoaded() Return true if the entity has been loaded.
boolean	isNew() Return true if this entity bean is new and not yet saved.
boolean	isNewOrDirty() Return true if the entity bean is new or dirty (and should be saved).
boolean	isReadOnly() Return true if the bean should be treated as readOnly.
boolean	isReference() Return true if the entity is a reference.
protected void	loadBean(String loadProperty) Load the bean when it is a reference.
void	postSetter(PropertyChangeEvent event) Called for "enhancement" postSetter processing.
void	postSetter(PropertyChangeEvent event, Object newValue) Called for "subclassed" postSetter processing.
void	preGetter(String propertyName) Method that is called prior to a getter method on the actual entity.
PropertyChangeEvent	preSetter(boolean intercept, String propertyName, boolean oldValue, boolean newValue) Check for primitive boolean.
PropertyChangeEvent	preSetter(boolean intercept, String propertyName, byte[] oldValue, byte[] newValue) byte[].
PropertyChangeEvent	preSetter(boolean intercept, String propertyName, byte oldValue, byte newValue) char.
PropertyChangeEvent	preSetter(boolean intercept, String propertyName, char[] oldValue, char[] newValue) char[].
PropertyChangeEvent	preSetter(boolean intercept, String propertyName, char oldValue, char newValue) char.
PropertyChangeEvent	preSetter(boolean intercept, String propertyName, double oldValue, double newValue) double.
PropertyChangeEvent	preSetter(boolean intercept, String propertyName, float oldValue, float newValue) float.
PropertyChangeEvent	preSetter(boolean intercept, String propertyName, int oldValue, int newValue) Check for primitive int.
PropertyChangeEvent	preSetter(boolean intercept, String propertyName, long oldValue, long newValue) long.
PropertyChangeEvent	preSetter(boolean intercept, String propertyName, Object oldValue, Object newValue) Check to see if the values are not equal.
PropertyChangeEvent	preSetter(boolean intercept, String propertyName, short oldValue, short newValue) short.
PropertyChangeEvent	preSetterMany(boolean interceptField, String propertyName, Object oldValue, Object newValue) OneToMany and ManyToMany don't have any interception so just check for PropertyChangeSupport.
void	removePropertyChangeListener(PropertyChangeListener listener) Remove a property change listener for this entity bean.
void	removePropertyChangeListener(String propertyName, PropertyChangeListener listener) Remove a property change listener for this entity bean for a specific property.
void	setBeanLoader(int index, BeanLoader beanLoader, PersistenceContext ctx) Set the BeanLoader for general lazy loading.
void	setBeanLoaderByServerName(String ebeanServerName) Set Lazy Loading by ebeanServerName.
void	setDisableLazyLoad(boolean disableLazyLoad) Set true to turn off lazy loading.
void	setEmbeddedLoaded(Object embeddedBean) Set the loaded status for the embedded bean.
void	setIntercepting(boolean intercepting) Turn interception off or on.
void	setLazyLoadFailure() Mark this bean as having failed lazy loading due to the underlying row being deleted.
void	setLoaded() Set the loaded state to true.
void	setLoadedLazy() When finished loading for lazy or refresh on an already partially populated bean.
void	setLoadedProps(Set<String> loadedPropertyNames) Set the property names for a partially loaded bean.
void	setNodeUsageCollector(NodeUsageCollector usageCollector) Turn on profile collection.
void	setParentBean(Object parentBean) Special case for a OneToOne, Set the parent bean (by relationship).
void	setPersistenceContext(PersistenceContext persistenceContext) Set the persistenceContext.
void	setReadOnly(boolean readOnly) Set the readOnly status.
void	setReference() Set this as a reference object.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

EntityBeanIntercept

public EntityBeanIntercept(Object owner)

Create a intercept with a given entity.

Refer to agent ProxyConstructor.

Method Detail

copyStateTo

public void copyStateTo(EntityBeanIntercept dest)

Copy the internal state of the intercept to another intercept.

getOwner

public EntityBean getOwner()

Return the 'owning' entity bean.

toString

public String toString()

Overrides:

toString in class Object

getPersistenceContext

public PersistenceContext getPersistenceContext()

Return the persistenceContext.

setPersistenceContext

public void setPersistenceContext(PersistenceContext persistenceContext)

Set the persistenceContext.

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

Add a property change listener for this entity bean.

addPropertyChangeListener

public void addPropertyChangeListener(String propertyName,
                             PropertyChangeListener listener)

Add a property change listener for this entity bean for a specific property.

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

Remove a property change listener for this entity bean.

removePropertyChangeListener

public void removePropertyChangeListener(String propertyName,
                                PropertyChangeListener listener)

Remove a property change listener for this entity bean for a specific property.

setNodeUsageCollector

public void setNodeUsageCollector(NodeUsageCollector usageCollector)

Turn on profile collection.

getParentBean

public Object getParentBean()

Return the parent bean (by relationship).

setParentBean

public void setParentBean(Object parentBean)

Special case for a OneToOne, Set the parent bean (by relationship). This is the owner of a 1-1.

getBeanLoaderIndex

public int getBeanLoaderIndex()

Return the index position for batch loading via BeanLoader.

setBeanLoaderByServerName

public void setBeanLoaderByServerName(String ebeanServerName)

Set Lazy Loading by ebeanServerName.

This is for reference beans created by themselves.

setBeanLoader

public void setBeanLoader(int index,
                 BeanLoader beanLoader,
                 PersistenceContext ctx)

Set the BeanLoader for general lazy loading.

isDirty

public boolean isDirty()

Return true if this bean has been directly modified (it has oldValues) or if any embedded beans are either new or dirty (and hence need saving).

isNew

public boolean isNew()

Return true if this entity bean is new and not yet saved.

isNewOrDirty

public boolean isNewOrDirty()

Return true if the entity bean is new or dirty (and should be saved).

isReference

public boolean isReference()

Return true if the entity is a reference.

setReference

public void setReference()

Set this as a reference object.

getOldValues

public Object getOldValues()

Return the old values used for ConcurrencyMode.ALL.

isReadOnly

public boolean isReadOnly()

Return true if the bean should be treated as readOnly. If a setter method is called when it is readOnly an Exception is thrown.

setReadOnly

public void setReadOnly(boolean readOnly)

Set the readOnly status. If readOnly then calls to setter methods through an exception.

isIntercepting

public boolean isIntercepting()

Return true if the bean currently has interception on.

With interception on the bean will invoke lazy loading and dirty checking.

setIntercepting

public void setIntercepting(boolean intercepting)

Turn interception off or on.

This is to support custom serialisation mechanisms that just read all the properties on the bean.

isLoaded

public boolean isLoaded()

Return true if the entity has been loaded.

setLoaded

public void setLoaded()

Set the loaded state to true.

Calls to setter methods after the bean is loaded can result in 'Old Values' being created to support ConcurrencyMode.ALL

Worth noting that this is also set after a insert/update. By doing so it 'resets' the bean for making further changes and saving again.

setLoadedLazy

public void setLoadedLazy()

When finished loading for lazy or refresh on an already partially populated bean.

setLazyLoadFailure

public void setLazyLoadFailure()

Mark this bean as having failed lazy loading due to the underlying row being deleted.

We mark the bean this way rather than immediately fail as we might be batch lazy loading and this bean might not be used by the client code at all. Instead we will fail as soon as the client code tries to use this bean.

isLazyLoadFailure

public boolean isLazyLoadFailure()

Return true if the bean is marked as having failed lazy loading.

isDisableLazyLoad

public boolean isDisableLazyLoad()

Return true if lazy loading is disabled.

setDisableLazyLoad

public void setDisableLazyLoad(boolean disableLazyLoad)

Set true to turn off lazy loading.

Typically used to disable lazy loading on SQL based report beans.

setEmbeddedLoaded

public void setEmbeddedLoaded(Object embeddedBean)

Set the loaded status for the embedded bean.

isEmbeddedNewOrDirty

public boolean isEmbeddedNewOrDirty(Object embeddedBean)

Return true if the embedded bean is new or dirty and hence needs saving.

setLoadedProps

public void setLoadedProps(Set<String> loadedPropertyNames)

Set the property names for a partially loaded bean.

Parameters:

loadedPropertyNames - the names of the loaded properties

getLoadedProps

public Set<String> getLoadedProps()

Return the set of property names for a partially loaded bean.

getChangedProps

public Set<String> getChangedProps()

Return the set of property names for changed properties.

getLazyLoadProperty

public String getLazyLoadProperty()

Return the property read or write that triggered the lazy load.

loadBean

protected void loadBean(String loadProperty)

Load the bean when it is a reference.

createOldValues

protected void createOldValues()

Create a copy of the bean as it is now. This is the original or 'old values' prior to any modification. This is used to perform concurrency testing.

areEqual

protected boolean areEqual(Object obj1,
               Object obj2)

Helper method to check if two objects are equal.

preGetter

public void preGetter(String propertyName)

Method that is called prior to a getter method on the actual entity.

This checks if the bean is a reference and should be loaded.

postSetter

public void postSetter(PropertyChangeEvent event)

Called for "enhancement" postSetter processing. This is around a PUTFIELD so no need to check the newValue afterwards.

postSetter

public void postSetter(PropertyChangeEvent event,
              Object newValue)

Called for "subclassed" postSetter processing. Here the newValue has to be re-fetched (and passed into this method) in case there is code inside the setter that further mutates the value.

preSetterMany

public PropertyChangeEvent preSetterMany(boolean interceptField,
                                String propertyName,
                                Object oldValue,
                                Object newValue)

OneToMany and ManyToMany don't have any interception so just check for PropertyChangeSupport.

preSetter

public PropertyChangeEvent preSetter(boolean intercept,
                            String propertyName,
                            Object oldValue,
                            Object newValue)

Check to see if the values are not equal. If they are not equal then create the old values for use with ConcurrencyMode.ALL.

preSetter

public PropertyChangeEvent preSetter(boolean intercept,
                            String propertyName,
                            boolean oldValue,
                            boolean newValue)

Check for primitive boolean.

preSetter

public PropertyChangeEvent preSetter(boolean intercept,
                            String propertyName,
                            int oldValue,
                            int newValue)

Check for primitive int.

preSetter

public PropertyChangeEvent preSetter(boolean intercept,
                            String propertyName,
                            long oldValue,
                            long newValue)

long.

preSetter

public PropertyChangeEvent preSetter(boolean intercept,
                            String propertyName,
                            double oldValue,
                            double newValue)

double.

preSetter

public PropertyChangeEvent preSetter(boolean intercept,
                            String propertyName,
                            float oldValue,
                            float newValue)

float.

preSetter

public PropertyChangeEvent preSetter(boolean intercept,
                            String propertyName,
                            short oldValue,
                            short newValue)

short.

preSetter

public PropertyChangeEvent preSetter(boolean intercept,
                            String propertyName,
                            char oldValue,
                            char newValue)

char.

preSetter

public PropertyChangeEvent preSetter(boolean intercept,
                            String propertyName,
                            byte oldValue,
                            byte newValue)

char.

preSetter

public PropertyChangeEvent preSetter(boolean intercept,
                            String propertyName,
                            char[] oldValue,
                            char[] newValue)

char[].

preSetter

public PropertyChangeEvent preSetter(boolean intercept,
                            String propertyName,
                            byte[] oldValue,
                            byte[] newValue)

byte[].