public interface SessionBean extends EnterpriseBean
As of EJB 3.0 it is no longer required that a session bean class implement this interface.
Modifier and Type | Method and Description |
---|---|
void |
ejbActivate()
The activate method is called when a stateful session bean instance is activated
from its "passive" state.
|
void |
ejbPassivate()
The passivate method is called before a stateful session bean instance enters
the "passive" state.
|
void |
ejbRemove()
A container invokes this method before it ends the life of the session
object.
|
void |
setSessionContext(SessionContext ctx)
Set the associated session context.
|
void setSessionContext(SessionContext ctx) throws EJBException, RemoteException
The session 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.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.void ejbRemove() throws EJBException, RemoteException
This method is called with no transaction context.
EJBException
- Thrown by the method to indicate a failure
caused by a system-level error.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.void ejbActivate() throws EJBException, RemoteException
ejbPassivate
method.
This method is called with no transaction context.
EJBException
- Thrown by the method to indicate a failure
caused by a system-level error.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.void ejbPassivate() throws EJBException, RemoteException
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 with no transaction context.
EJBException
- Thrown by the method to indicate a failure
caused by a system-level error.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.Copyright © 1996-2017, Oracle and/or its affiliates. All Rights Reserved. Use is subject to license terms.