com.oneandone.ejbcdiunit.resourcesimulators

Class EjbContextSimulation

java.lang.Object

com.oneandone.ejbcdiunit.resourcesimulators.EjbContextSimulation

All Implemented Interfaces:

javax.ejb.EJBContext

Direct Known Subclasses:

MessageContextSimulation, SessionContextSimulation

public abstract class EjbContextSimulation
extends Object
implements javax.ejb.EJBContext

Author:

aschoerk

Constructor Summary

Constructors

Constructor and Description
EjbContextSimulation()

Method Summary

Modifier and Type	Method and Description
Identity	getCallerIdentity() Deprecated. Use Principal getCallerPrincipal() instead.
Principal	getCallerPrincipal() Obtain the java.security.Principal that identifies the caller.
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.
javax.ejb.EJBHome	getEJBHome() Obtain the enterprise bean's remote home interface.
javax.ejb.EJBLocalHome	getEJBLocalHome() Obtain the enterprise bean's local home interface.
Properties	getEnvironment() Deprecated. Use the JNDI naming context java:comp/env to access enterprise bean's environment.
boolean	getRollbackOnly() Test if the transaction has been marked for rollback only.
javax.ejb.TimerService	getTimerService() Get access to the EJB Timer Service.
UserTransaction	getUserTransaction() Obtain the transaction demarcation interface.
boolean	isCallerInRole(Identity role) Deprecated. Use boolean isCallerInRole(String roleName) instead.
boolean	isCallerInRole(String roleName) Test if the caller has a given security role.
Object	lookup(String name) Lookup a resource within the java: namespace.
void	setRollbackOnly() Mark the current transaction for rollback.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

EjbContextSimulation

public EjbContextSimulation()

Method Detail

getEJBHome

public javax.ejb.EJBHome getEJBHome()
                             throws IllegalStateException

Obtain the enterprise bean's remote home interface.

Specified by:

getEJBHome in interface javax.ejb.EJBContext

Returns:

The enterprise bean's remote home interface.

Throws:

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

getEJBLocalHome

public javax.ejb.EJBLocalHome getEJBLocalHome()
                                       throws IllegalStateException

Obtain the enterprise bean's local home interface.

Specified by:

getEJBLocalHome in interface javax.ejb.EJBContext

Returns:

The enterprise bean's local home interface.

Throws:

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

Since:

EJB 2.0

getEnvironment

public Properties getEnvironment()

Deprecated. Use the JNDI naming context java:comp/env to access enterprise bean's environment.

Obtain the enterprise bean's environment properties.

Note: If the enterprise bean has no environment properties this method returns an empty java.util.Properties object. This method never returns null.

Specified by:

getEnvironment in interface javax.ejb.EJBContext

Returns:

The environment properties for the enterprise bean.

getCallerIdentity

public Identity getCallerIdentity()

Deprecated. Use Principal getCallerPrincipal() instead.

Obtain the java.security.Identity of the caller.

This method is deprecated in EJB 1.1. The Container is allowed to return always null from this method. The enterprise bean should use the getCallerPrincipal method instead.

Specified by:

getCallerIdentity in interface javax.ejb.EJBContext

Returns:

The Identity object that identifies the caller.

getCallerPrincipal

public Principal getCallerPrincipal()
                             throws IllegalStateException

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

Specified by:

getCallerPrincipal in interface javax.ejb.EJBContext

Returns:

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

Throws:

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

Since:

EJB 1.1

isCallerInRole

public boolean isCallerInRole(Identity role)

Deprecated. Use boolean isCallerInRole(String roleName) instead.

Test if the caller has a given role.

This method is deprecated in EJB 1.1. The enterprise bean should use the isCallerInRole(String roleName) method instead.

Specified by:

isCallerInRole in interface javax.ejb.EJBContext

Parameters:

role - The java.security.Identity of the role to be tested.

Returns:

True if the caller has the specified role.

isCallerInRole

public boolean isCallerInRole(String roleName)
                       throws IllegalStateException

Test if the caller has a given security role.

Specified by:

isCallerInRole in interface javax.ejb.EJBContext

Parameters:

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

Returns:

True if the caller has the specified role.

Throws:

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

Since:

EJB 1.1

getUserTransaction

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.

Specified by:

getUserTransaction in interface javax.ejb.EJBContext

Returns:

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

Throws:

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).

setRollbackOnly

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.

Specified by:

setRollbackOnly in interface javax.ejb.EJBContext

Throws:

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

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.

Specified by:

getRollbackOnly in interface javax.ejb.EJBContext

Returns:

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

Throws:

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

public javax.ejb.TimerService getTimerService()
                                       throws IllegalStateException

Get access to the EJB Timer Service.

Specified by:

getTimerService in interface javax.ejb.EJBContext

Throws:

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

lookup

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");

Specified by:

lookup in interface javax.ejb.EJBContext

Parameters:

name - Name of the entry

Throws:

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

Since:

EJB 3.0

getContextData

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.

Specified by:

getContextData in interface javax.ejb.EJBContext

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.

Since:

EJB 3.1