|
| |
|
| javax.ejb.EntityBean
| EntityBean | | public interface EntityBean extends EnterpriseBean(Code) | | The EntityBean interface is implemented by every entity enterprise Bean
class. The container uses the EntityBean methods to notify the enterprise
Bean instances of the instance's life cycle events.
|
| Method Summary | |
| public void | ejbActivate()
A container invokes this method when the instance
is taken out of the pool of available instances to become associated
with a specific EJB object. | | public void | ejbLoad()
A container invokes this method to instruct the
instance to synchronize its state by loading it state from the
underlying database.
This method always executes in the transaction context determined
by the value of the transaction attribute in the deployment descriptor.
exception:
EJBException - Thrown by the method to indicate a failurecaused by a system-level error.
exception:
RemoteException - This exception is defined in the methodsignature to provide backward compatibility for enterprise beans written for the EJB 1.0 specification. | | public void | ejbPassivate()
A container invokes this method on an instance before the instance
becomes disassociated with a specific EJB object. | | public void | ejbRemove()
A container invokes this method before it removes the EJB object
that is currently associated with the instance. | | public void | ejbStore()
A container invokes this method to instruct the
instance to synchronize its state by storing it to the underlying
database.
This method always executes in the transaction context determined
by the value of the transaction attribute in the deployment descriptor.
exception:
EJBException - Thrown by the method to indicate a failurecaused by a system-level error.
exception:
RemoteException - This exception is defined in the methodsignature to provide backward compatibility for enterprise beans written for the EJB 1.0 specification. | | public void | setEntityContext(EntityContext ctx)
Set the associated entity context. | | public void | unsetEntityContext()
Unset the associated entity context. |
| ejbActivate | | public void ejbActivate() throws EJBException, RemoteException(Code) | | A container invokes this method when the instance
is taken out of the pool of available instances to become associated
with a specific EJB object. This method transitions the instance to
the ready state.
This method executes in an unspecified transaction context.
exception:
EJBException - Thrown by the method to indicate a failurecaused by a system-level error.
exception:
RemoteException - This exception is defined in the methodsignature to provide backward compatibility for enterprise beans written for the EJB 1.0 specification. Enterprise beans written for the EJB 1.1 specification should throw thejavax.ejb.EJBException instead of this exception.Enterprise beans written for the EJB2.0 and higher specificationsmust throw the javax.ejb.EJBException instead of this exception. |
| ejbLoad | | public void ejbLoad() throws EJBException, RemoteException(Code) | | A container invokes this method to instruct the
instance to synchronize its state by loading it state from the
underlying database.
This method always executes in the transaction context determined
by the value of the transaction attribute in the deployment descriptor.
exception:
EJBException - Thrown by the method to indicate a failurecaused by a system-level error.
exception:
RemoteException - This exception is defined in the methodsignature to provide backward compatibility for enterprise beans written for the EJB 1.0 specification. Enterprise beans written for the EJB 1.1 specification should throw thejavax.ejb.EJBException instead of this exception.Enterprise beans written for the EJB2.0 and higher specificationsmust throw the javax.ejb.EJBException instead of this exception. |
| ejbPassivate | | public void ejbPassivate() throws EJBException, RemoteException(Code) | | A container invokes this method on an instance before the instance
becomes disassociated with a specific EJB object. After this method
completes, the container will place the instance into the pool of
available instances.
This method executes in an unspecified transaction context.
exception:
EJBException - Thrown by the method to indicate a failurecaused by a system-level error.
exception:
RemoteException - This exception is defined in the methodsignature to provide backward compatibility for enterprise beans written for the EJB 1.0 specification. Enterprise beans written for the EJB 1.1 specification should throw thejavax.ejb.EJBException instead of this exception.Enterprise beans written for the EJB2.0 and higher specificationsmust throw the javax.ejb.EJBException instead of this exception. |
| ejbRemove | | public void ejbRemove() throws RemoveException, EJBException, RemoteException(Code) | | A container invokes this method before it removes the EJB object
that is currently associated with the instance. This method
is invoked when a client invokes a remove operation on the
enterprise Bean's home interface or the EJB object's remote interface.
This method transitions the instance from the ready state to the pool
of available instances.
This method is called in the transaction context of the remove
operation.
exception:
RemoveException - The enterprise Bean does not allowdestruction of the object.
exception:
EJBException - Thrown by the method to indicate a failurecaused by a system-level error.
exception:
RemoteException - This exception is defined in the methodsignature to provide backward compatibility for enterprise beans written for the EJB 1.0 specification. Enterprise beans written for the EJB 1.1 specification should throw thejavax.ejb.EJBException instead of this exception.Enterprise beans written for the EJB2.0 and higher specificationsmust throw the javax.ejb.EJBException instead of this exception. |
| ejbStore | | public void ejbStore() throws EJBException, RemoteException(Code) | | A container invokes this method to instruct the
instance to synchronize its state by storing it to the underlying
database.
This method always executes in the transaction context determined
by the value of the transaction attribute in the deployment descriptor.
exception:
EJBException - Thrown by the method to indicate a failurecaused by a system-level error.
exception:
RemoteException - This exception is defined in the methodsignature to provide backward compatibility for enterprise beans written for the EJB 1.0 specification. Enterprise beans written for the EJB 1.1 specification should throw thejavax.ejb.EJBException instead of this exception.Enterprise beans written for the EJB2.0 and higher specificationsmust throw the javax.ejb.EJBException instead of this exception. |
| setEntityContext | | public void setEntityContext(EntityContext ctx) throws EJBException, RemoteException(Code) | | Set the associated entity context. The container invokes this method
on an instance after the instance has been created.
This method is called in an unspecified transaction context.
Parameters:
ctx - An EntityContext interface for the instance. The instanceshould store the reference to the context in an instance variable.
exception:
EJBException - Thrown by the method to indicate a failurecaused by a system-level error.
exception:
RemoteException - This exception is defined in the methodsignature to provide backward compatibility for enterprise beans written for the EJB 1.0 specification. Enterprise beans written for the EJB 1.1 specification should throw thejavax.ejb.EJBException instead of this exception.Enterprise beans written for the EJB2.0 and higher specificationsmust throw the javax.ejb.EJBException instead of this exception. |
| unsetEntityContext | | public void unsetEntityContext() throws EJBException, RemoteException(Code) | | Unset the associated entity context. The container calls this method
before removing the instance.
This is the last method that the container invokes on the instance.
The Java garbage collector will eventually invoke the finalize() method
on the instance.
This method is called in an unspecified transaction context.
exception:
EJBException - Thrown by the method to indicate a failurecaused by a system-level error.
exception:
RemoteException - This exception is defined in the methodsignature to provide backward compatibility for enterprise beans written for the EJB 1.0 specification. Enterprise beans written for the EJB 1.1 specification should throw thejavax.ejb.EJBException instead of this exception.Enterprise beans written for the EJB2.0 and higher specificationsmust throw the javax.ejb.EJBException instead of this exception. |
|
|
|