javax.ejb
Class EJBContainer

java.lang.Object
  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.