org.jboss.ejb
Interface EntityPersistenceManager

All Superinterfaces:

AllowedOperationsFlags (src) , ContainerPlugin (src) , Service (src)

All Known Implementing Classes:

BMPPersistenceManager (src) , CachedConnectionInterceptor (src) , CMPPersistenceManager (src)

public interface EntityPersistenceManager

extends ContainerPlugin (src)

This interface is implemented by any EntityBean persistence managers plugins.

Implementations of this interface are called by other plugins in the container. If the persistence manager wants to, it may attach any instance specific metadata to the EntityEnterpriseContext that is passed in method calls.

See Also:

EntityContainer (src)

createBeanClassInstance

public java.lang.Object createBeanClassInstance()
                                         throws java.lang.Exception

Returns a new instance of the bean class or a subclass of the bean class.

Returns:

the new instance

Throws:

java.lang.Exception

createEntity

public void createEntity(java.lang.reflect.Method m,
                         java.lang.Object[] args,
                         EntityEnterpriseContext (src)  instance)
                  throws java.lang.Exception

This method is called whenever an entity is to be created. The persistence manager is responsible for calling the ejbCreate method on the instance and to handle the results properly wrt the persistent store.

Parameters:

m - the create method in the home interface that was called

args - any create parameters

instance - the instance being used for this create call

Throws:

java.lang.Exception

postCreateEntity

public void postCreateEntity(java.lang.reflect.Method m,
                             java.lang.Object[] args,
                             EntityEnterpriseContext (src)  instance)
                      throws java.lang.Exception

This method is called whenever an entity is to be created. The persistence manager is responsible for calling the ejbPostCreate method on the instance and to handle the results properly wrt the persistent store.

Parameters:

m - the create method in the home interface that was called

args - any create parameters

instance - the instance being used for this create call

Throws:

java.lang.Exception

findEntity

public java.lang.Object findEntity(java.lang.reflect.Method finderMethod,
                                   java.lang.Object[] args,
                                   EntityEnterpriseContext (src)  instance,
                                   GenericEntityObjectFactory (src)  factory)
                            throws java.lang.Exception

This method is called when single entities are to be found. The persistence manager must find out whether the wanted instance is available in the persistence store, and if so it shall use the EJBProxyFactory plugin to create an EJBObject to the instance, which is to be returned as result.

Parameters:

finderMethod - the find method in the home interface that was called

args - any finder parameters

instance - the instance to use for the finder call

Returns:

an EJBObject representing the found entity

Throws:

java.lang.Exception

findEntities

public java.util.Collection findEntities(java.lang.reflect.Method finderMethod,
                                         java.lang.Object[] args,
                                         EntityEnterpriseContext (src)  instance,
                                         GenericEntityObjectFactory (src)  factory)
                                  throws java.lang.Exception

This method is called when collections of entities are to be found. The persistence manager must find out whether the wanted instances are available in the persistence store, and if so it shall use the EJBProxyFactory plugin to create EJBObjects to the instances, which are to be returned as result.

Parameters:

finderMethod - the find method in the home interface that was called

args - any finder parameters

instance - the instance to use for the finder call

Returns:

an EJBObject collection representing the found entities

Throws:

java.lang.Exception

activateEntity

public void activateEntity(EntityEnterpriseContext (src)  instance)
                    throws java.rmi.RemoteException

This method is called when an entity shall be activated. The persistence manager must call the ejbActivate method on the instance.

Parameters:

instance - the instance to use for the activation

Throws:

java.rmi.RemoteException - thrown if some system exception occurs

loadEntity

public void loadEntity(EntityEnterpriseContext (src)  instance)
                throws java.rmi.RemoteException

This method is called whenever an entity shall be load from the underlying storage. The persistence manager must load the state from the underlying storage and then call ejbLoad on the supplied instance.

Parameters:

instance - the instance to synchronize

Throws:

java.rmi.RemoteException - thrown if some system exception occurs

isStoreRequired

public boolean isStoreRequired(EntityEnterpriseContext (src)  instance)
                        throws java.lang.Exception

This method is used to determine if an entity should be stored.

Parameters:

instance - the instance to check

Returns:

true, if the entity has been modified

Throws:

java.lang.Exception - thrown if some system exception occurs

isModified

public boolean isModified(EntityEnterpriseContext (src)  ctx)
                   throws java.lang.Exception

This method is used to determined whether the instance was modified. NOTE, even if the method returns true the isStoreRequired for this same instance might return false, e.g. a CMR field that doesn't have a foreign key was modified.

Parameters:

ctx -

Returns:

Throws:

java.lang.Exception

storeEntity

public void storeEntity(EntityEnterpriseContext (src)  instance)
                 throws java.rmi.RemoteException

This method is called whenever an entity shall be stored to the underlying storage. The persistence manager must call ejbStore on the supplied instance and then store the state to the underlying storage.

Parameters:

instance - the instance to synchronize

Throws:

java.rmi.RemoteException - thrown if some system exception occurs

invokeEjbStore

public void invokeEjbStore(EntityEnterpriseContext (src)  instance)
                    throws java.rmi.RemoteException

Invokes ejbStore on the instance.

Parameters:

instance -

Throws:

java.rmi.RemoteException

passivateEntity

public void passivateEntity(EntityEnterpriseContext (src)  instance)
                     throws java.rmi.RemoteException

This method is called when an entity shall be passivate. The persistence manager must call the ejbPassivate method on the instance.

Parameters:

instance - the instance to passivate

Throws:

java.rmi.RemoteException - thrown if some system exception occurs

removeEntity

public void removeEntity(EntityEnterpriseContext (src)  instance)
                  throws java.rmi.RemoteException,
                         RemoveException (src) 

This method is called when an entity shall be removed from the underlying storage. The persistence manager must call ejbRemove on the instance and then remove its state from the underlying storage.

Parameters:

instance - the instance to remove

Throws:

java.rmi.RemoteException - thrown if some system exception occurs

RemoveException (src) - thrown if the instance could not be removed