Jakarta EE 11.0.0 · jakarta.ejb.EJBContext · APIdia, the JavaDoc alternative

Method Summary

Modifier and Type	Method and Description
public Principal	Returns: The `Principal` object that identifies the caller. This method never returns `null`. getCallerPrincipal() Obtain the `java.security.Principal` that identifies the caller.
public Map<String, Object>	Returns: the context data that interceptor context associated with this invocation. If there is no context data, an empty `Map<String,Object>` object will be returned. getContextData() The `getContextData` method enables a business method, lifecycle callback method, or timeout method to retrieve any interceptor/webservices context associated with its invocation.
public EJBHome	Returns: The enterprise bean's remote home interface. getEJBHome() Obtain the enterprise bean's remote home interface.
public EJBLocalHome	Returns: The enterprise bean's local home interface. getEJBLocalHome() Obtain the enterprise bean's local home interface.
public boolean	Returns: True if the current transaction is marked for rollback, false otherwise. getRollbackOnly() Test if the transaction has been marked for rollback only.
public TimerService	Returns: a `jakarta.ejb.TimerService` object. getTimerService() Get access to the enterprise bean Timer Service.
public UserTransaction	Returns: The `UserTransaction` interface that the enterprise bean instance can use for transaction demarcation. getUserTransaction() Obtain the transaction demarcation interface.
public boolean	Returns: True if the caller has the specified role. isCallerInRole(String The name of the security role. The role must be one of the security roles that is defined in the deployment descriptor. roleName) Test if the caller has a given security role.
public Object	Returns: a `java.lang.Object` object. lookup(String Name of the entry name) Lookup a resource within the `java:` namespace.
public void	setRollbackOnly() Mark the current transaction for rollback.

Method Detail

getCallerPrincipal back to summary

getCallerPrincipal	back to summary
public Principal getCallerPrincipal() throws IllegalStateException Obtain the `java.security.Principal` that identifies the caller. Returns:Principal The `Principal` object that identifies the caller. This method never returns `null`. Exceptions IllegalStateException: The Container throws the exception if the instance is not allowed to call this method. Since EJB 1.1

public Principal getCallerPrincipal() throws IllegalStateException

Obtain the java.security.Principal that identifies the caller.

Returns:Principal

The Principal object that identifies the caller. This method never returns null.

Exceptions

IllegalStateException:: The Container throws the exception if the instance is not allowed to call this method.

Since

EJB 1.1

getContextData back to summary

getContextData	back to summary
public Map<String, Object> getContextData() The `getContextData` method enables a business method, lifecycle callback method, or timeout method to retrieve any interceptor/webservices context associated with its invocation. Returns:Map<String, Object> the context data that interceptor context associated with this invocation. If there is no context data, an empty `Map<String,Object>` object will be returned. Since EJB 3.1

public Map<String, Object> getContextData()

The getContextData method enables a business method, lifecycle callback method, or timeout method to retrieve any interceptor/webservices context associated with its invocation.

Returns:Map<String, Object>: the context data that interceptor context associated with this invocation. If there is no context data, an empty Map<String,Object> object will be returned.
Since: EJB 3.1

getEJBHome	back to summary
public EJBHome getEJBHome() throws IllegalStateException Obtain the enterprise bean's remote home interface. Returns:EJBHome The enterprise bean's remote home interface. Exceptions IllegalStateException: if the enterprise bean does not have a remote home interface.

getEJBHome

back to summary

public EJBHome getEJBHome() throws IllegalStateException

Obtain the enterprise bean's remote home interface.

Returns:EJBHome

The enterprise bean's remote home interface.

Exceptions

IllegalStateException:: if the enterprise bean does not have a remote home interface.

getEJBLocalHome	back to summary
public EJBLocalHome getEJBLocalHome() throws IllegalStateException Obtain the enterprise bean's local home interface. Returns:EJBLocalHome The enterprise bean's local home interface. Exceptions IllegalStateException: if the enterprise bean does not have a local home interface. Since EJB 2.0

getEJBLocalHome

back to summary

public EJBLocalHome getEJBLocalHome() throws IllegalStateException

Obtain the enterprise bean's local home interface.

Returns:EJBLocalHome

The enterprise bean's local home interface.

Exceptions

IllegalStateException:: if the enterprise bean does not have a local home interface.

Since

EJB 2.0

getRollbackOnly	back to summary
public boolean getRollbackOnly() throws IllegalStateException Test if the transaction has been marked for rollback only. An enterprise bean instance can use this operation, for example, to test after an exception has been caught, whether it is fruitless to continue computation on behalf of the current transaction. Only enterprise beans with container-managed transactions are allowed to use this method. Returns:boolean True if the current transaction is marked for rollback, false otherwise. Exceptions IllegalStateException: The Container throws the exception if the instance is not allowed to use this method (i.e. the instance is of a bean with bean-managed transactions).

getRollbackOnly

back to summary

public boolean getRollbackOnly() throws IllegalStateException

Test if the transaction has been marked for rollback only. An enterprise bean instance can use this operation, for example, to test after an exception has been caught, whether it is fruitless to continue computation on behalf of the current transaction. Only enterprise beans with container-managed transactions are allowed to use this method.

Returns:boolean

True if the current transaction is marked for rollback, false otherwise.

Exceptions

IllegalStateException:: The Container throws the exception if the instance is not allowed to use this method (i.e. the instance is of a bean with bean-managed transactions).

getTimerService back to summary

getTimerService	back to summary
public TimerService getTimerService() throws IllegalStateException Get access to the enterprise bean Timer Service. Returns:TimerService a `jakarta.ejb.TimerService` object. Exceptions IllegalStateException: The Container throws the exception if the instance is not allowed to use this method (e.g. if the bean is a stateful session bean) Since EJB 2.1

public TimerService getTimerService() throws IllegalStateException

Get access to the enterprise bean Timer Service.

Returns:TimerService

a jakarta.ejb.TimerService object.

Exceptions

IllegalStateException:: The Container throws the exception if the instance is not allowed to use this method (e.g. if the bean is a stateful session bean)

Since

EJB 2.1

getUserTransaction back to summary

getUserTransaction	back to summary
public UserTransaction getUserTransaction() throws IllegalStateException Obtain the transaction demarcation interface. Only enterprise beans with bean-managed transactions are allowed to to use the `UserTransaction` interface. As entity beans must always use container-managed transactions, only session beans or message-driven beans with bean-managed transactions are allowed to invoke this method. Returns:UserTransaction The `UserTransaction` interface that the enterprise bean instance can use for transaction demarcation. Exceptions IllegalStateException: The Container throws the exception if the instance is not allowed to use the `UserTransaction` interface (i.e. the instance is of a bean with container-managed transactions).

public UserTransaction getUserTransaction() throws IllegalStateException

Obtain the transaction demarcation interface. Only enterprise beans with bean-managed transactions are allowed to to use the UserTransaction interface. As entity beans must always use container-managed transactions, only session beans or message-driven beans with bean-managed transactions are allowed to invoke this method.

Returns:UserTransaction

The UserTransaction interface that the enterprise bean instance can use for transaction demarcation.

Exceptions

IllegalStateException:: The Container throws the exception if the instance is not allowed to use the UserTransaction interface (i.e. the instance is of a bean with container-managed transactions).

isCallerInRole	back to summary
public boolean isCallerInRole(String roleName) throws IllegalStateException Test if the caller has a given security role. Parameters roleName:String The name of the security role. The role must be one of the security roles that is defined in the deployment descriptor. Returns:boolean True if the caller has the specified role. Exceptions IllegalStateException: The Container throws the exception if the instance is not allowed to call this method. Since EJB 1.1

isCallerInRole

back to summary

public boolean isCallerInRole(String roleName) throws IllegalStateException

Test if the caller has a given security role.

Parameters

roleName:String: The name of the security role. The role must be one of the security roles that is defined in the deployment descriptor.

Returns:boolean

True if the caller has the specified role.

Exceptions

IllegalStateException:: The Container throws the exception if the instance is not allowed to call this method.

Since

EJB 1.1

lookup back to summary

lookup	back to summary
public Object lookup(String name) throws IllegalArgumentException Lookup a resource within the `java:` namespace. Names referring to entries within the private component namespace can be passed as unqualified strings. In that case the lookup will be relative to `"java:comp/env/"`. For example, assuming an enterprise bean defines an `ejb-local-ref` with `ejb-ref-name` `"ejb/BarRef"` the following two calls to `EJBContext.lookup` are equivalent : `ejbContext.lookup("ejb/BarRef")`; `ejbContext.lookup("java:comp/env/ejb/BarRef")`; Parameters name:String Name of the entry Returns:Object a `java.lang.Object` object. Exceptions IllegalArgumentException: The Container throws the exception if the given name does not match an entry within the component's environment. Since EJB 3.0

public Object lookup(String name) throws IllegalArgumentException

Lookup a resource within the java: namespace. Names referring to entries within the private component namespace can be passed as unqualified strings. In that case the lookup will be relative to "java:comp/env/". For example, assuming an enterprise bean defines an ejb-local-ref with ejb-ref-name "ejb/BarRef" the following two calls to EJBContext.lookup are equivalent : ejbContext.lookup("ejb/BarRef"); ejbContext.lookup("java:comp/env/ejb/BarRef");

Parameters

name:String: Name of the entry

Returns:Object

a java.lang.Object object.

Exceptions

IllegalArgumentException:: The Container throws the exception if the given name does not match an entry within the component's environment.

Since

EJB 3.0

setRollbackOnly	back to summary
public void setRollbackOnly() throws IllegalStateException Mark the current transaction for rollback. The transaction will become permanently marked for rollback. A transaction marked for rollback can never commit. Only enterprise beans with container-managed transactions are allowed to use this method. Exceptions IllegalStateException: The Container throws the exception if the instance is not allowed to use this method (i.e. the instance is of a bean with bean-managed transactions).

setRollbackOnly

back to summary

public void setRollbackOnly() throws IllegalStateException

Mark the current transaction for rollback. The transaction will become permanently marked for rollback. A transaction marked for rollback can never commit. Only enterprise beans with container-managed transactions are allowed to use this method.

Exceptions

IllegalStateException:: The Container throws the exception if the instance is not allowed to use this method (i.e. the instance is of a bean with bean-managed transactions).

public Interface EJBContext

Method Summary

Method Detail