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_APP_NAME_PROPERTY
           
static java.lang.String EMBEDDABLE_INITIAL
          Deprecated. 
static java.lang.String EMBEDDABLE_INITIAL_PROPERTY
           
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()
          Deprecated. 
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

EMBEDDABLE_APP_NAME_PROPERTY

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

EMBEDDABLE_INITIAL_PROPERTY

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

EMBEDDABLE_INITIAL

@Deprecated
public static final java.lang.String EMBEDDABLE_INITIAL
Deprecated. 
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

@Deprecated
public static EJBContainer getCurrentEJBContainer()
Deprecated. 

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.