EJBContainer

java.lang.Object
- jakarta.ejb.embeddable.EJBContainer

All Implemented Interfaces:

java.lang.AutoCloseable
```
public abstract class EJBContainer
extends java.lang.Object
implements java.lang.AutoCloseable
```
Used to execute an enterprise bean application in an embeddable container.

Since:

EJB 3.1

Examples (en):

xa-datasource, webservice-ws-with-resources-config, webservice-holder, webservice-handlerchain, troubleshooting, transaction-rollback, testing-transactions, testing-transactions-bmt, testing-security, testing-security-meta, testing-security-4, testing-security-3, testing-security-2, testcase-injection, spring-data-proxy, spring-data-proxy-meta, simple-webservice, simple-webservice-without-interface, simple-stateless, simple-stateless-callbacks, simple-stateful, simple-stateful-callbacks, simple-singleton, simple-mdb, simple-mdb-with-descriptor, simple-mdb-and-cdi, simple-cdi-interceptor, schedule-methods, schedule-methods-meta, schedule-expression, schedule-events, rest-on-ejb, rest-example, reload-persistence-unit-properties, polling-parent, persistence-fragment, movies-complete, movies-complete-meta, moviefun, moviefun-rest, mbean-auto-registration, lookup-of-ejbs, lookup-of-ejbs-with-descriptor, jpa-hibernate, jpa-enumerated, jpa-eclipselink, injection-of-env-entry, injection-of-entitymanager, injection-of-ejbs, injection-of-datasource, injection-of-connectionfactory, dynamic-proxy-to-access-mbean, dynamic-implementation, dynamic-datasource-routing, dynamic-dao-implementation, decorators, datasource-ciphered-password, custom-injection, connector-war, component-interfaces, cdi-request-scope, cdi-qualifier, cdi-produces-field, cdi-produces-disposes, cdi-interceptors, cdi-events, cdi-dynamic-inject, cdi-basic, cdi-application-scope, cdi-alternative-and-stereotypes, bean-validation-design-by-contract, async-postconstruct, async-methods, alternate-descriptors, access-timeout, access-timeout-meta

Examples (es):

simple-singleton, jpa-hibernate, cdi-application-scope, async-methods, alternate-descriptors, access-timeout, access-timeout-meta

Examples (pt):

xa-datasource, webservice-ws-with-resources-config, webservice-holder, webservice-handlerchain, testing-security, spring-data-proxy, spring-data-proxy-meta, simple-cdi-interceptor, persistence-fragment, moviefun-rest, mbean-auto-registration, jpa-hibernate, jpa-enumerated, jpa-eclipselink, injection-of-env-entry, injection-of-entitymanager, injection-of-ejbs, dynamic-proxy-to-access-mbean, dynamic-datasource-routing, dynamic-dao-implementation, datasource-ciphered-password, cdi-request-scope, cdi-qualifier, cdi-produces-field, cdi-produces-disposes, cdi-interceptors, cdi-events, cdi-dynamic-inject, cdi-basic, cdi-application-scope, cdi-alternative-and-stereotypes, bean-validation-design-by-contract, async-postconstruct, async-methods, alternate-descriptors, access-timeout, access-timeout-meta

Field Summary

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`APP_NAME` Standard property name for specifying the application name of the enterprise bean modules executing within the embeddable container.
`static java.lang.String`	`MODULES` Standard property name for specifying the set of modules to be initialized.
`static java.lang.String`	`PROVIDER` Standard property name for specifying the embeddable container implementation bootstrap class.

Constructor Summary

Constructors
Constructor and Description

EJBContainer()

Constructors
Constructor and Description
`EJBContainer()`

Method Summary

All Methods Static Methods Instance Methods Abstract Methods Concrete Methods
Modifier and Type	Method and Description
`abstract void`	`close()` Shutdown an embeddable EJBContainer instance.
`static EJBContainer`	`createEJBContainer()` Create and initialize an embeddable enterprise bean container.
`static EJBContainer`	`createEJBContainer(java.util.Map<?,?> properties)` Create and initialize an embeddable enterprise bean container with a set of configuration properties.
`abstract javax.naming.Context`	`getContext()` Retrieve a naming context for looking up references to session beans executing in the embeddable container.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - PROVIDER
```
public static final java.lang.String PROVIDER
```
    Standard property name for specifying the embeddable container implementation bootstrap class. Property value is a fully-qualified class name.
    
    See Also:
    
    Constant Field Values
  - MODULES
```
public static final java.lang.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
    See Also:
    
    Constant Field Values
  - APP_NAME
```
public static final java.lang.String APP_NAME
```
    Standard property name for specifying the application name of the enterprise bean 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.
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - EJBContainer
```
public EJBContainer()
```
- Method Detail
  - createEJBContainer
```
public static EJBContainer createEJBContainer()
```
    Create and initialize an embeddable enterprise bean 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)
```
    Create and initialize an embeddable enterprise bean container with a set of configuration properties.
    
    Parameters:
    
    properties - Spec-defined and/or vendor-specific properties. The spec reserves the prefix "jakarta.ejb." for spec-defined properties.
    
    Returns:
    
    EJBContainer instance
    
    Throws:
    
    EJBException - Thrown if the container or application could not be successfully initialized.
  - getContext
```
public abstract javax.naming.Context getContext()
```
    Retrieve a naming context for looking up references to session beans executing in the embeddable container.
    
    Returns:
    
    naming context
  - close
```
public abstract void close()
```
    Shutdown an embeddable EJBContainer instance. Embeddable applications should always call close() in order to free up the resources associated with the embeddable container.
    
    Specified by:
    
    close in interface java.lang.AutoCloseable

Class EJBContainer

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

PROVIDER

MODULES

APP_NAME

Constructor Detail

EJBContainer

Method Detail

createEJBContainer

createEJBContainer

getContext

close