javax.ejb
Class EJBContainer

java.lang.Object
  extended by javax.ejb.EJBContainer
Direct Known Subclasses:
EJBContainerWrapper

public abstract class EJBContainer
extends java.lang.Object

Used to execute an EJB application in an embeddable container.

Since:
3.1

Field Summary
static java.lang.String EMBEDDABLE_INITIAL
           
static java.lang.String EMBEDDABLE_MODULES_PROPERTY
           
 
Constructor Summary
EJBContainer()
           
 
Method Summary
abstract  void close()
          Shutdown an embeddable EJBContainer instance.
static EJBContainer createEJBContainer()
          Create and initialize an embeddable EJB container.
static EJBContainer createEJBContainer(java.util.Map<?,?> properties)
          Create and initialize an embeddable EJB container with an set of configuration properties and names of modules to be initialized.
 javax.naming.Context getContext()
          Retrieve a naming context for looking up references to session beans executing in the embeddable container.
static EJBContainer getCurrentEJBContainer()
          Retrieve the last EJBContainer instance to be successfully returned from an invocation to a createEJBContainer method.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

EMBEDDABLE_INITIAL

public static final java.lang.String EMBEDDABLE_INITIAL
See Also:
Constant Field Values

EMBEDDABLE_MODULES_PROPERTY

public static final java.lang.String EMBEDDABLE_MODULES_PROPERTY
See Also:
Constant Field Values
Constructor Detail

EJBContainer

public EJBContainer()
Method Detail

close

public abstract void close()
Shutdown an embeddable EJBContainer instance.


createEJBContainer

public static EJBContainer createEJBContainer()
                                       throws EJBException
Create and initialize an embeddable EJB container. JVM classpath is searched for all ejb-jars or exploded ejb-jars in directory format.

Returns:
EJBContainer instance
Throws:
EJBException - Thrown if the container or application could not be successfully initialized.

createEJBContainer

public static EJBContainer createEJBContainer(java.util.Map<?,?> properties)
                                       throws EJBException
Create and initialize an embeddable EJB container with an set of configuration properties and names of modules to be initialized.

Parameters:
properties - One or more spec-defined or vendor-specific properties. The spec reserves the prefix "javax.ejb." for spec-defined properties.
Returns:
EJBContainer instance
Throws:
EJBException - Thrown if the container or application could not be successfully initialized.

getCurrentEJBContainer

public static EJBContainer getCurrentEJBContainer()
Retrieve the last EJBContainer instance to be successfully returned from an invocation to a createEJBContainer method.

Returns:
EJBContainer instance, or null if none exists or if the last EJBContainer instance has been closed.

getContext

public javax.naming.Context getContext()
Retrieve a naming context for looking up references to session beans executing in the embeddable container.

Returns:
The naming context.