jrun.ejb.persistence
Class EntityPersistenceManager

jrunx.kernel.ServiceAdapter
  |
  +--jrun.ejb.persistence.EntityPersistenceManager

All Implemented Interfaces:

javax.naming.Referenceable, java.io.Serializable, Service, ServiceMBean

Direct Known Subclasses:

ContainerManagedEntityPersistenceManager

public class EntityPersistenceManager

extends ServiceAdapter

Author:

Paul Reilly, Enrique Duvos

See Also:

Serialized Form

Field Summary

protected EntityContainer

entityContainer

Fields inherited from class jrunx.kernel.ServiceAdapter

DEFAULT_DEACTIVATED, DEFAULT_DOMAIN, DOMAIN_NAME_SEPARATOR, DOMAIN_NAME_SUFFIX, domainName, jndiBindable, LOGGER_CACHE_TIME, SCHEDULER_SERVICE, SECURITY_MANAGER, server, status, TRANSACTION_MANAGER

Fields inherited from interface jrunx.kernel.Service

INITIALIZED, STARTED, STARTING, STOPPED, STOPPING, UNINITIALIZED

Constructor Summary

EntityPersistenceManager(EntityContainer entityContainer)

Method Summary

Instance	activate(java.lang.Object id, boolean isLocalInvocation, java.lang.Object securityID, java.lang.Object proxy) Load the instance corresponding to id from the persistence store.
void	create(Instance instance, java.lang.reflect.Method method, java.lang.Object[] args) Create an instance in the persistence store.
protected void	ejbCreate(Instance instance, java.lang.reflect.Method method, java.lang.Object[] args)
protected void	ejbPostCreate(Instance instance, java.lang.reflect.Method method, java.lang.Object[] args)
void	findByPrimaryKey(Instance instance, java.lang.reflect.Method finderMethod, java.lang.Object[] args) Find an entity bean by primary key in the persistence store.
void	findEntity(Instance instance, java.lang.reflect.Method finderMethod, java.lang.Object[] args) Find an entity bean in the persistence store.
java.util.Collection	findEntityCollection(Instance instance, java.lang.reflect.Method finderMethod, java.lang.Object[] args) Find a collection of entity beans in the persistence store.
java.util.Enumeration	findEntityEnumeration(Instance instance, java.lang.reflect.Method finderMethod, java.lang.Object[] args) Find an enumeration of entity beans in the persistence store.
void	load(Instance instance) Load the instance corresponding to id into the persistence store.
void	passivate(Instance instance) Store the instance in the persistence store.
void	remove(Instance instance) Remove the instance from the persistence store.
void	store(Instance instance) Store an instance into the persistence store.

Methods inherited from class jrunx.kernel.ServiceAdapter

bind, destroy, findObjectInstance, findObjectInstance, findObjectInstance, getBindToJNDI, getDeactivated, getDomainName, getDomainSearchPath, getJRunService, getLogger, getName, getParentService, getReference, getResourceManager, getServerName, getServerProperties, getStatus, init, invokeMethod, isInPartition, isPartition, lookup, postDeregister, postRegister, preDeregister, preRegister, requestServer, scheduleRunnable, setBindToJNDI, setDeactivated, setDomainName, setName, setParentService, start, stop, toString, unbind, unscheduleRunnable, updateStatus

Field Detail

entityContainer

protected EntityContainer entityContainer

Constructor Detail

EntityPersistenceManager

public EntityPersistenceManager(EntityContainer entityContainer)
                         throws java.lang.Exception

Method Detail

activate

public Instance activate(java.lang.Object id,
                         boolean isLocalInvocation,
                         java.lang.Object securityID,
                         java.lang.Object proxy)
                  throws javax.ejb.EJBException

Load the instance corresponding to id from the persistence store.

Parameters:

id - The ID associated with the instance.

isLocalInvocation - True if the business method was a local call.

securityID - The object representation of the security ID.

proxy - The EJBObject or EJBLocalObject Proxy.

Throws:

EJBException - Implementations are expected to call ejbActivate, which throws this exception.

create

public void create(Instance instance,
                   java.lang.reflect.Method method,
                   java.lang.Object[] args)
            throws java.lang.Exception

Create an instance in the persistence store.

ejbCreate

protected void ejbCreate(Instance instance,
                         java.lang.reflect.Method method,
                         java.lang.Object[] args)
                  throws java.lang.Exception

ejbPostCreate

protected void ejbPostCreate(Instance instance,
                             java.lang.reflect.Method method,
                             java.lang.Object[] args)
                      throws java.lang.Exception

findByPrimaryKey

public void findByPrimaryKey(Instance instance,
                             java.lang.reflect.Method finderMethod,
                             java.lang.Object[] args)
                      throws java.lang.Exception

Find an entity bean by primary key in the persistence store.

findEntity

public void findEntity(Instance instance,
                       java.lang.reflect.Method finderMethod,
                       java.lang.Object[] args)
                throws java.lang.Exception

Find an entity bean in the persistence store.

findEntityCollection

public java.util.Collection findEntityCollection(Instance instance,
                                                 java.lang.reflect.Method finderMethod,
                                                 java.lang.Object[] args)
                                          throws java.lang.Exception

Find a collection of entity beans in the persistence store.

Returns:

A collection of primary keys.

findEntityEnumeration

public java.util.Enumeration findEntityEnumeration(Instance instance,
                                                   java.lang.reflect.Method finderMethod,
                                                   java.lang.Object[] args)
                                            throws java.lang.Exception

Find an enumeration of entity beans in the persistence store.

Returns:

An enumeration of primary keys.

load

public void load(Instance instance)
          throws javax.ejb.EJBException

Load the instance corresponding to id into the persistence store.

Parameters:

instance - the instance associated with the entity bean.

Returns:

the instance.

passivate

public void passivate(Instance instance)
               throws javax.ejb.EJBException

Store the instance in the persistence store.

Parameters:

instance - the instance associated with the bean.

remove

public void remove(Instance instance)
            throws javax.ejb.EJBException,
                   javax.ejb.RemoveException

Remove the instance from the persistence store.

Parameters:

instance - the instance associated with the bean.

store

public void store(Instance instance)
           throws javax.ejb.EJBException

Store an instance into the persistence store.

Parameters:

instance - The instance.