com.solarmetric.kodo.ee
Class JDOEntityBean

java.lang.Object
  |
  +--com.solarmetric.kodo.ee.JDOBean
        |
        +--com.solarmetric.kodo.ee.JDOEntityBean

All Implemented Interfaces:

EnterpriseBean, EntityBean, Serializable

public abstract class JDOEntityBean

extends JDOBean

implements EntityBean

Base class that can be used to implement a BMP Entity Bean with a wrapped JDO persistent instance. The behaviour of this wrapper is outlined in section 16.2.1 of the JDO 1.0 specification.

See Also:

Serialized Form

Field Summary

protected EntityContext

ctx

Fields inherited from class com.solarmetric.kodo.ee.JDOBean

CM_JNDI_SUFFIX

Constructor Summary

JDOEntityBean()

Method Summary

PersistenceCapable	createPersistent() Create a new instance of the PersistenceCapable.
void	ejbActivate() From section 16.2.1 of the JDO 1.0 specification: The ejbActivate method acquires a PersistenceManager from the ConnectionFactory, and finds the JDO instance with the specific primary key by calling getObjectById on the PersistenceManager instance.
Object	ejbCreate() From section 16.2.1 of the JDO 1.0 specification: The ejbCreate method creates a new instance of the corresponding JDO class corresponding to the primary key value, sets the jdoInstance variable, and calls makePersistent with the instance as a parameter.
Object	ejbFindByPrimaryKey(Object pk) Locate an instanced based on the Primary Key.
Collection	ejbFindByQuery(String queryString) Find a Collection of the persistent instances based on the JDOQL query.
void	ejbLoad() From section 16.2.1 of the JDO 1.0 specification: The ejbLoad and ejbStore methods are used to acquire and close the PersistenceManager.
void	ejbLog(String msg, Throwable t, PrintWriter logWriter) Allows the implementor to log messages.
void	ejbPassivate() From section 16.2.1 of the JDO 1.0 specification: The ejbPassivate method sets the jdoInstance to null and closes the PersistenceManager.
void	ejbPostCreate() From section 16.2.1 of the JDO 1.0 specification: An ejbPostCreate method is required for each ejbCreate method.
void	ejbRemove() From section 16.2.1 of the JDO 1.0 specification: The ejbRemove method calls deletePersistent with the JDO instance as a parameter.
void	ejbStore()
Serializable	getPersistenceCapableInstance() Return the wrapped PersistenceCapable object for this bean instance.
abstract Class	getPersistentClass()
void	setEntityContext(EntityContext ctx) From section 16.2.1 of the JDO 1.0 specification: The setEntityContext method copies the value of the EntityContext parameter to the instance variable entityContext,looksupthe ConnectionFactory using JNDI, and sets it into the persistenceManagerFactory variable.
void	unsetEntityContext() From section 16.2.1 of the JDO 1.0 specification: The unsetEntityContext method clears the entityContext variable and the persistenceManagerFactory variable.

Methods inherited from class com.solarmetric.kodo.ee.JDOBean

bindConnectionFactory, ejbException, ejbLog, getById, getConnectionFactory, getConnectionFactory, getContext, getJNDIName, getPersistenceManager, lookup, lookupConnectionFactory, setConnectionFactory, setLogWriter, setPropertiesResource, unsetConnectionFactory

Methods inherited from class java.lang.Object

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

Field Detail

ctx

protected EntityContext ctx

Constructor Detail

JDOEntityBean

public JDOEntityBean()

Method Detail

getPersistentClass

public abstract Class getPersistentClass()

createPersistent

public PersistenceCapable createPersistent()
                                    throws InstantiationException,
                                           IllegalAccessException

Create a new instance of the PersistenceCapable. This should be overridden to assign a primary key if the PC uses application identity.

getPersistenceCapableInstance

public Serializable getPersistenceCapableInstance()

Return the wrapped PersistenceCapable object for this bean instance. Note that this assumes that the wrapped PC implements java.io.Serializable.

ejbCreate

public Object ejbCreate()
                 throws EJBException,
                        RemoteException

From section 16.2.1 of the JDO 1.0 specification: The ejbCreate method creates a new instance of the corresponding JDO class corresponding to the primary key value, sets the jdoInstance variable, and calls makePersistent with the instance as a parameter.

ejbPostCreate

public void ejbPostCreate()
                   throws EJBException,
                          RemoteException

From section 16.2.1 of the JDO 1.0 specification: An ejbPostCreate method is required for each ejbCreate method. This method does nothing with the wrapped PC.

ejbActivate

public void ejbActivate()
                 throws EJBException,
                        RemoteException

From section 16.2.1 of the JDO 1.0 specification: The ejbActivate method acquires a PersistenceManager from the ConnectionFactory, and finds the JDO instance with the specific primary key by calling getObjectById on the PersistenceManager instance.

Specified by:

ejbActivate in interface EntityBean

ejbPassivate

public void ejbPassivate()
                  throws EJBException,
                         RemoteException

From section 16.2.1 of the JDO 1.0 specification: The ejbPassivate method sets the jdoInstance to null and closes the PersistenceManager.

Specified by:

ejbPassivate in interface EntityBean

ejbRemove

public void ejbRemove()
               throws EJBException,
                      RemoteException

From section 16.2.1 of the JDO 1.0 specification: The ejbRemove method calls deletePersistent with the JDO instance as a parameter.

Specified by:

ejbRemove in interface EntityBean

ejbLoad

public void ejbLoad()
             throws EJBException,
                    RemoteException

From section 16.2.1 of the JDO 1.0 specification: The ejbLoad and ejbStore methods are used to acquire and close the PersistenceManager. Business methods operating on the JDO instance will access fields which will transparently cause the appropriate state transitions of the persistent instance. The state of the JDO instances will be synchronized with the datastore during transaction completion.

Specified by:

ejbLoad in interface EntityBean

ejbStore

public void ejbStore()
              throws EJBException,
                     RemoteException

Specified by:

ejbStore in interface EntityBean

setEntityContext

public void setEntityContext(EntityContext ctx)
                      throws EJBException

From section 16.2.1 of the JDO 1.0 specification: The setEntityContext method copies the value of the EntityContext parameter to the instance variable entityContext,looksupthe ConnectionFactory using JNDI, and sets it into the persistenceManagerFactory variable.

Specified by:

setEntityContext in interface EntityBean

unsetEntityContext

public void unsetEntityContext()
                        throws EJBException,
                               RemoteException

From section 16.2.1 of the JDO 1.0 specification: The unsetEntityContext method clears the entityContext variable and the persistenceManagerFactory variable.

Specified by:

unsetEntityContext in interface EntityBean

ejbFindByPrimaryKey

public Object ejbFindByPrimaryKey(Object pk)
                           throws ObjectNotFoundException,
                                  FinderException

Locate an instanced based on the Primary Key.

ejbFindByQuery

public Collection ejbFindByQuery(String queryString)
                          throws FinderException

Find a Collection of the persistent instances based on the JDOQL query.

ejbLog

public void ejbLog(String msg,
                   Throwable t,
                   PrintWriter logWriter)

Description copied from class: JDOBean

Allows the implementor to log messages.

Overrides:

ejbLog in class JDOBean