JavaEE Web API 8.0.1 · javax.ejb.embeddable.EJBContainer

Field Summary

Modifier and Type	Field and Description
public static final String	APP_NAME Standard property name for specifying the application name of the EJB modules executing within the embeddable container.
public static final String	MODULES Standard property name for specifying the set of modules to be initialized.
private static final String	newLine
public static final String	PROVIDER Standard property name for specifying the embeddable container implementation bootstrap class.
private static final ServiceLoader<EJBContainerProvider>	providers

Constructor Summary

Access	Constructor and Description
public	EJBContainer()

Method Summary

Modifier and Type	Method and Description
public abstract void	close() Redeclares java.lang.AutoCloseable.close. Shutdown an embeddable EJBContainer instance.
public static EJBContainer	Returns: EJBContainer instance createEJBContainer() Create and initialize an embeddable EJB container.
public static EJBContainer	Returns: EJBContainer instance createEJBContainer(Map<?, ?> Spec-defined and/or vendor-specific properties. The spec reserves the prefix `"javax.ejb."` for spec-defined properties. properties) Create and initialize an embeddable EJB container with a set of configuration properties.
private static String	createErrorMessage(Throwable t)
public abstract Context	Returns: naming context getContext() Retrieve a naming context for looking up references to session beans executing in the embeddable container.
private static void	reportError(Map<?, ?> the properties passed as an argument to the createEJBContainer() method properties, Map<String, String> the Map of errors encountered during the createEJBContainer() call errors, Set<String> the Set of providers that returned null on createEJBContainer() call returnedNull) Create a meaningful EJBException in case no EJBContainer provider had been found.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

APP_NAME	back to summary
public static final String APP_NAME Standard property name for specifying the application name of the EJB modules executing within the embeddable container. If specified, the property value applies to the `<app-name>` portion of the portable global JNDI name syntax. If this property is not specified, the `<app-name>` portion of the portable global JNDI name syntax does not apply.

MODULES	back to summary
public static final String MODULES Standard property name for specifying the set of modules to be initialized. Property value is one of the following : a single module name String from the JVM classpath a String[] array of module names from the JVM classpath a java.io.File representing an ejb-jar or exploded ejb-jar directory a java.io.File array, each element of which represents an ejb-jar or exploded ejb-jar directory

MODULES

back to summary

public static final String MODULES

Standard property name for specifying the set of modules to be initialized. Property value is one of the following :

a single module name String from the JVM classpath
a String[] array of module names from the JVM classpath
a java.io.File representing an ejb-jar or exploded ejb-jar directory
a java.io.File array, each element of which represents an ejb-jar or exploded ejb-jar directory

newLine	back to summary
private static final String newLine

PROVIDER	back to summary
public static final String PROVIDER Standard property name for specifying the embeddable container implementation bootstrap class. Property value is a fully-qualified class name.

providers	back to summary
private static final ServiceLoader<EJBContainerProvider> providers

Constructor Detail

EJBContainer	back to summary
public EJBContainer()

Method Detail

close back to summary

close	back to summary
public abstract void close() Redeclares java.lang.AutoCloseable.close. Shutdown an embeddable EJBContainer instance. Embeddable applications should always call `close()` in order to free up the resources associated with the embeddable container.

public abstract void close()

Redeclares java.lang.AutoCloseable.close.

Shutdown an embeddable EJBContainer instance. Embeddable applications should always call close() in order to free up the resources associated with the embeddable container.

createEJBContainer	back to summary
public static EJBContainer createEJBContainer() Create and initialize an embeddable EJB container. JVM classpath is searched for all ejb-jars or exploded ejb-jars in directory format. Returns:EJBContainer EJBContainer instance Exceptions EJBException: Thrown if the container or application could not be successfully initialized.

createEJBContainer

back to summary

public static EJBContainer createEJBContainer()

Create and initialize an embeddable EJB container. JVM classpath is searched for all ejb-jars or exploded ejb-jars in directory format.

Returns:EJBContainer

EJBContainer instance

Exceptions

EJBException:: Thrown if the container or application could not be successfully initialized.

createEJBContainer back to summary

createEJBContainer	back to summary
public static EJBContainer createEJBContainer(Map<?, ?> properties) Create and initialize an embeddable EJB container with a set of configuration properties. Parameters properties:Map<?, ?> Spec-defined and/or vendor-specific properties. The spec reserves the prefix `"javax.ejb."` for spec-defined properties. Returns:EJBContainer EJBContainer instance Exceptions EJBException: Thrown if the container or application could not be successfully initialized.

public static EJBContainer createEJBContainer(Map<?, ?> properties)

Create and initialize an embeddable EJB container with a set of configuration properties.

Parameters

properties:Map<?, ?>: Spec-defined and/or vendor-specific properties. The spec reserves the prefix "javax.ejb." for spec-defined properties.

Returns:EJBContainer

EJBContainer instance

Exceptions

EJBException:: Thrown if the container or application could not be successfully initialized.

createErrorMessage	back to summary
private static String createErrorMessage(Throwable t)

getContext	back to summary
public abstract Context getContext() Retrieve a naming context for looking up references to session beans executing in the embeddable container. Returns:Context naming context

getContext

back to summary

public abstract Context getContext()

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

Returns:Context: naming context

reportError	back to summary
private static void reportError(Map<?, ?> properties, Map<String, String> errors, Set<String> returnedNull) throws EJBException Create a meaningful EJBException in case no EJBContainer provider had been found. Parameters properties:Map<?, ?> the properties passed as an argument to the createEJBContainer() method errors:Map<String, String> the Map of errors encountered during the createEJBContainer() call returnedNull:Set<String> the Set of providers that returned null on createEJBContainer() call

reportError

back to summary

private static void reportError(Map<?, ?> properties, Map<String, String> errors, Set<String> returnedNull) throws EJBException

Create a meaningful EJBException in case no EJBContainer provider had been found.

Parameters

properties:Map<?, ?>: the properties passed as an argument to the createEJBContainer() method
errors:Map<String, String>: the Map of errors encountered during the createEJBContainer() call
returnedNull:Set<String>: the Set of providers that returned null on createEJBContainer() call

public abstract Class EJBContainer

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail