com.bea.control
Interface SessionEJB3Control

public interface SessionEJB3Control

Enterprise Java Bean Control base interface for EJB 3.0 beans.

Nested Class Summary

static interface	SessionEJB3Control.BusinessInterface Specifies the business interface of the EJB.
static interface	SessionEJB3Control.EJBLookup EJBLookup specifies the target EJB's business interface for the EJB control using either the jndiName or ejbLink member.
static interface	SessionEJB3Control.JNDIContextEnv JNDI environment settings.
static interface	SessionEJB3Control.UndefinedBusinessInterface Default interface for undefined business interface.

Method Summary

Object	getEJBBeanInstance() Returns the current target instance of the bean business interface used for business interface method invocations.
Throwable	getEJBException() Returns the last EJB exception serviced by the EJB control on the developers behalf.
boolean	hasEJBBeanInstance() Returns true if the EJB control currently has a target bean instance upon which bean business interface methods may be invoked.

Method Detail

hasEJBBeanInstance

boolean hasEJBBeanInstance()

Returns true if the EJB control currently has a target bean instance upon which bean business interface methods may be invoked. This will be true after a successful create() or single select finder method execution, or in cases where implicit creation or find has occurred by the control on the control users behalf. This provides a simple way to procedurally check the status of explicit or implicit bean instance creation or find operations.

getEJBBeanInstance

Object getEJBBeanInstance()

Returns the current target instance of the bean business interface used for business interface method invocations. This API is provided for advanced use cases were direct access to the local/ remote interfaces outside of the control is required. It will return null if no target instance is currently selected.

getEJBException

Throwable getEJBException()

Returns the last EJB exception serviced by the EJB control on the developers behalf. This can be used to discover or log additional information, for example when a create or find method is unable to locate a target bean instance.