All Packages  Class Hierarchy  This Package  Previous  Next  Index

Interface javax.ejb.SessionBean

public interface interface SessionBean
extends EnterpriseBean
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.


Method Index

 o ejbActivate()
The activate method is called when the instance is activated from its "passive" state.
 o ejbDestroy()
A container invokes this method before it ends the life of the session object.
 o ejbPassivate()
The passivate method is called before the instance enters the "passive" state.
 o setSessionContext(SessionContext)
Set the associated session context.

Methods

 o setSessionContext
 public abstract void setSessionContext(SessionContext ctx) throws EJBException
Set the associated session context. The container calls this method after the instance creation.

The enterprise bean instance should store the reference to the context object in an instance variable.

This method is called in no transaction context.

Parameters:
ctx - An SessionContext interface for the instance.
Throws: EJBException
Thrown if the instance could not perform the function requested by the container.
 o ejbDestroy
 public abstract void ejbDestroy() throws EJBException
A container invokes this method before it ends the life of the session object. This happens as a result of a client's invoking a destroy operation, or when a container decides to terminate the session object after a timeout.

This method is called in no transaction context.

Throws: EJBException
Thrown if the instance could not perform the function requested by the container.
 o ejbActivate
 public abstract void ejbActivate() throws EJBException
The activate method is called when the instance is activated from its "passive" state. The instance should acquire any resource that it has released earlier in the ejbPassivate() method.

This method is called in no transaction context.

Throws: EJBException
Thrown if the instance could not perform the function requested by the container.
 o ejbPassivate
 public abstract void ejbPassivate() throws EJBException
The passivate method is called before the instance enters the "passive" state. The instance should release any resources that that it can re-acquire later in the ejbActivate() method.

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 in no transaction context.

Throws: EJBException
Thrown if the instance could not perform the function requested by the container.

All Packages  Class Hierarchy  This Package  Previous  Next  Index