javax.ejb
Class EJBContainer

java.lang.Object
  javax.ejb.EJBContainer

Direct Known Subclasses:

EJBContainerWrapper

public abstract class EJBContainer
extends Object

Used to execute an EJB application in an embeddable container.

Since:

3.1

Version:

$Revision: $

Author:

Carlo de Wolf

Field Summary

static String	EMBEDDABLE_APP_NAME_PROPERTY
static String	EMBEDDABLE_INITIAL Deprecated.
static String	EMBEDDABLE_INITIAL_PROPERTY
static 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(Map<?,?> properties) Create and initialize an embeddable EJB container with an set of configuration properties and names of modules to be initialized.
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 String EMBEDDABLE_APP_NAME_PROPERTY

See Also:

Constant Field Values

EMBEDDABLE_INITIAL_PROPERTY

public static final String EMBEDDABLE_INITIAL_PROPERTY

See Also:

Constant Field Values

EMBEDDABLE_INITIAL

@Deprecated
public static final String EMBEDDABLE_INITIAL

Deprecated.

See Also:

Constant Field Values

EMBEDDABLE_MODULES_PROPERTY

public static final 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(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 Context getContext()

Retrieve a naming context for looking up references to session beans executing in the embeddable container.

Returns:

The naming context.