The SessionBean interface is implemented by every session enterprise Bean class. The container uses the SessionBean methods to notify the enterprise Bean instances of the instance's life cycle events.
ejbActivate() The activate method is called when the instance is activated from its "passive" state. | |
ejbPassivate() The passivate method is called before the instance enters the "passive" state. | |
ejbRemove() A container invokes this method before it ends the life of the session object. | |
setSessionContext(SessionContext ctx) Set the associated session context. |
public voidsetSessionContext(SessionContext ctx) throwsEJBException, java.rmi.RemoteException
The enterprise Bean instance should store the reference to the context object in an instance variable.
This method is called with no transaction context.
ctx
- A SessionContext interface for the instance.EJBException
- Thrown by the method to indicate a failure caused by a system-level error.java.rmi.RemoteException
- This exception is defined in the method signature to provide backward compatibility for applications written for the EJB 1.0 specification. Enterprise beans written for the EJB 1.1 specification should throw the javax.ejb.EJBException instead of this exception. Enterprise beans written for the EJB2.0 and higher specifications must throw the javax.ejb.EJBException instead of this exception.public voidejbRemove() throwsEJBException, java.rmi.RemoteException
This method is called with no transaction context.
EJBException
- Thrown by the method to indicate a failure caused by a system-level error.java.rmi.RemoteException
- This exception is defined in the method signature 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 the javax.ejb.EJBException instead of this exception. Enterprise beans written for the EJB2.0 and higher specifications must throw the javax.ejb.EJBException instead of this exception.public voidejbActivate() throwsEJBException, java.rmi.RemoteException
This method is called with no transaction context.
EJBException
- Thrown by the method to indicate a failure caused by a system-level error.java.rmi.RemoteException
- This exception is defined in the method signature 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 the javax.ejb.EJBException instead of this exception. Enterprise beans written for the EJB2.0 and higher specifications must throw the javax.ejb.EJBException instead of this exception.public voidejbPassivate() throwsEJBException, java.rmi.RemoteException
After the passivate method completes, the instance must be in a state that allows the container to use the Java Serialization protocol to externalize and store away the instance's state.
This method is called with no transaction context.
EJBException
- Thrown by the method to indicate a failure caused by a system-level error.java.rmi.RemoteException
- This exception is defined in the method signature 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 the javax.ejb.EJBException instead of this exception. Enterprise beans written for the EJB2.0 and higher specifications must throw the javax.ejb.EJBException instead of this exception.