Assembler

java.lang.Object
- org.apache.openejb.assembler.classic.AssemblerTool
- - org.apache.openejb.assembler.classic.Assembler

All Implemented Interfaces:: JndiConstants, Assembler

public class Assembler
extends AssemblerTool
implements Assembler, JndiConstants

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`Assembler.DeploymentListenerObserver`
`static class`	`Assembler.LazyResource`
`static class`	`Assembler.ResourceAdapterReference`
`static class`	`Assembler.ResourceInstance`

Field Summary

Fields
Modifier and Type	Field and Description
`protected OpenEjbConfiguration`	`config`
`protected OpenEjbConfigurationFactory`	`configFactory`
`Logger`	`logger`
`static java.lang.String`	`OPENEJB_JPA_DEPLOY_TIME_ENHANCEMENT_PROP`
`static java.lang.String`	`OPENEJB_TIMERS_ON`
`static java.lang.String`	`OPENEJB_URL_PKG_PREFIX`
`static java.lang.String`	`PROPAGATE_APPLICATION_EXCEPTIONS`
`java.lang.String`	`resourceDestroyTimeout`
`boolean`	`threadStackOnTimeout`
`static java.lang.String`	`TIMER_STORE_CLASS`
`protected SafeToolkit`	`toolkit`
`static java.lang.Class<?>[]`	`VALIDATOR_FACTORY_INTERFACES`
`static java.lang.Class<?>[]`	`VALIDATOR_INTERFACES`

Fields inherited from class org.apache.openejb.assembler.classic.AssemblerTool
props, serviceInterfaces

Fields inherited from interface org.apache.openejb.JndiConstants
JAVA_OPENEJB_NAMING_CONTEXT, OPENEJB_RESOURCE_JNDI_PREFIX, PERSISTENCE_UNIT_NAMING_CONTEXT, VALIDATOR_FACTORY_NAMING_CONTEXT, VALIDATOR_NAMING_CONTEXT

Constructor Summary

Constructors
Constructor and Description

Assembler()

Assembler(JndiFactory jndiFactory)

Constructors
Constructor and Description
`Assembler()`
`Assembler(JndiFactory jndiFactory)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`void`	`addDeploymentListener(DeploymentListener deploymentListener)`
`void`	`bindGlobals(java.util.Map<java.lang.String,java.lang.Object> bindings)`
`void`	`build()` Gets the configuration from `OpenEjbConfigurationFactory` and builds the `ContainerSystem` and fire `ContainerSystemPostCreate` event.
`void`	`buildContainerSystem(OpenEjbConfiguration configInfo)` When given a complete OpenEjbConfiguration graph this method will construct an entire container system and return a reference to that container system, as ContainerSystem instance.
`java.lang.ClassLoader`	`createAppClassLoader(AppInfo appInfo)`
`AppContext`	`createApplication(AppInfo appInfo)`
`AppContext`	`createApplication(AppInfo appInfo, java.lang.ClassLoader classLoader)`
`AppContext`	`createApplication(EjbJarInfo ejbJar)`
`AppContext`	`createApplication(EjbJarInfo ejbJar, java.lang.ClassLoader classLoader)`
`AppContext`	`createClient(ClientInfo clientInfo)`
`AppContext`	`createClient(ClientInfo clientInfo, java.lang.ClassLoader classLoader)`
`void`	`createConnectionManager(ConnectionManagerInfo serviceInfo)`
`AppContext`	`createConnector(ConnectorInfo connectorInfo)`
`AppContext`	`createConnector(ConnectorInfo connectorInfo, java.lang.ClassLoader classLoader)`
`void`	`createContainer(ContainerInfo serviceInfo)`
`AppContext`	`createEjbJar(EjbJarInfo ejbJar)`
`AppContext`	`createEjbJar(EjbJarInfo ejbJar, java.lang.ClassLoader classLoader)`
`void`	`createExternalContext(JndiContextInfo contextInfo)`
`void`	`createProxyFactory(ProxyFactoryInfo serviceInfo)`
`void`	`createResource(java.util.Collection<ServiceInfo> infos, ResourceInfo serviceInfo)`
`void`	`createResource(ResourceInfo serviceInfo)` Deprecated.
`void`	`createSecurityService(SecurityServiceInfo serviceInfo)`
`void`	`createService(ServiceInfo serviceInfo)`
`void`	`createTransactionManager(TransactionServiceInfo serviceInfo)`
`AppContext`	`createWebApp(WebAppInfo webAppInfo)`
`AppContext`	`createWebApp(WebAppInfo webAppInfo, java.lang.ClassLoader classLoader)`
`void`	`destroy()` Destroys the container system and all associated resources.
`void`	`destroyApplication(AppContext appContext)` Deprecated.
`void`	`destroyApplication(AppInfo appInfo)`
`void`	`destroyApplication(java.lang.String filePath)`
`AppInfo`	`getAppInfo(java.lang.String path)`
`ContainerSystem`	`getContainerSystem()` Gets the configured `ContainerSystem` instance.
`static java.util.Map<java.lang.String,java.lang.Object>`	`getContext()`
`java.util.Collection<AppInfo>`	`getDeployedApplications()`
`protected OpenEjbConfiguration`	`getOpenEjbConfiguration()`
`SecurityService`	`getSecurityService()` Gets the system wide configured `SecurityService` instance.
`TransactionManager`	`getTransactionManager()` Gets the system wide configured `TransactionManager` instance.
`void`	`init(java.util.Properties props)` Initialize the assembler with the given properties.
`java.util.List<BeanContext>`	`initEjbs(java.lang.ClassLoader classLoader, AppInfo appInfo, AppContext appContext, java.util.Set<Injection> injections, java.util.List<BeanContext> allDeployments, java.lang.String webappId)`
`static void`	`installNaming()`
`static void`	`installNaming(java.lang.String prefix)`
`static void`	`installNaming(java.lang.String prefix, boolean clean)`
`boolean`	`isDeployed(java.lang.String path)`
`static void`	`logUnusedProperties(ObjectRecipe serviceRecipe, ServiceInfo info)`
`static void`	`mergeServices(AppInfo appInfo)`
`static ObjectRecipe`	`prepareRecipe(ServiceInfo info)`
`void`	`removeContainer(java.lang.String containerId)`
`void`	`removeDeploymentListener(DeploymentListener deploymentListener)`
`ResourceInfo`	`removeResourceInfo(java.lang.String name)`
`static void`	`setContext(java.util.Map<java.lang.String,java.lang.Object> map)`
`void`	`startEjbs(boolean start, java.util.List<BeanContext> allDeployments)`

Methods inherited from class org.apache.openejb.assembler.classic.AssemblerTool
checkImplementation

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

Field Detail

OPENEJB_URL_PKG_PREFIX

public static final java.lang.String OPENEJB_URL_PKG_PREFIX

OPENEJB_JPA_DEPLOY_TIME_ENHANCEMENT_PROP

public static final java.lang.String OPENEJB_JPA_DEPLOY_TIME_ENHANCEMENT_PROP

See Also:: Constant Field Values

PROPAGATE_APPLICATION_EXCEPTIONS

public static final java.lang.String PROPAGATE_APPLICATION_EXCEPTIONS

See Also:: Constant Field Values

TIMER_STORE_CLASS

public static final java.lang.String TIMER_STORE_CLASS

See Also:: Constant Field Values

OPENEJB_TIMERS_ON

public static final java.lang.String OPENEJB_TIMERS_ON

See Also:: Constant Field Values

VALIDATOR_FACTORY_INTERFACES

public static final java.lang.Class<?>[] VALIDATOR_FACTORY_INTERFACES

VALIDATOR_INTERFACES

public static final java.lang.Class<?>[] VALIDATOR_INTERFACES

logger
```
public final Logger logger
```

resourceDestroyTimeout

public final java.lang.String resourceDestroyTimeout

threadStackOnTimeout

public final boolean threadStackOnTimeout

configFactory

protected OpenEjbConfigurationFactory configFactory

toolkit
```
protected SafeToolkit toolkit
```

config
```
protected OpenEjbConfiguration config
```

Constructor Detail

Assembler
```
public Assembler()
```

Assembler

public Assembler(JndiFactory jndiFactory)

Method Detail

getContainerSystem
```
public ContainerSystem getContainerSystem()
```
Description copied from interface: Assembler

Gets the configured ContainerSystem instance.

Specified by:

getContainerSystem in interface Assembler

Returns:

the ContainerSystem instance

getTransactionManager
```
public TransactionManager getTransactionManager()
```
Description copied from interface: Assembler

Gets the system wide configured TransactionManager instance.

Specified by:

getTransactionManager in interface Assembler

Returns:

the TransactionManager instance.

getSecurityService
```
public SecurityService getSecurityService()
```
Description copied from interface: Assembler

Gets the system wide configured SecurityService instance.

Specified by:

getSecurityService in interface Assembler

Returns:

the SecurityService instance.

addDeploymentListener

public void addDeploymentListener(DeploymentListener deploymentListener)

removeDeploymentListener

public void removeDeploymentListener(DeploymentListener deploymentListener)

init
```
public void init(java.util.Properties props)
          throws OpenEJBException
```
Description copied from interface: Assembler

Initialize the assembler with the given properties.

Specified by:

init in interface Assembler

Parameters:

props - initialization properties

Throws:

OpenEJBException - if the initialization phase faces an exception

installNaming
```
public static void installNaming()
```

installNaming

public static void installNaming(java.lang.String prefix)

installNaming

public static void installNaming(java.lang.String prefix,
                                 boolean clean)

setContext

public static void setContext(java.util.Map<java.lang.String,java.lang.Object> map)

getContext

public static java.util.Map<java.lang.String,java.lang.Object> getContext()

build
```
public void build()
           throws OpenEJBException
```
Description copied from interface: Assembler

Gets the configuration from OpenEjbConfigurationFactory and builds the ContainerSystem and fire ContainerSystemPostCreate event.

Specified by:

build in interface Assembler

Throws:

OpenEJBException - if the build phase faces an exception

getOpenEjbConfiguration

protected OpenEjbConfiguration getOpenEjbConfiguration()
                                                throws OpenEJBException

Throws:: OpenEJBException

buildContainerSystem
```
public void buildContainerSystem(OpenEjbConfiguration configInfo)
                          throws java.lang.Exception
```
When given a complete OpenEjbConfiguration graph this method will construct an entire container system and return a reference to that container system, as ContainerSystem instance. This method leverage the other assemble and apply methods which can be used independently. Assembles and returns the CoreContainerSystem using the information from the OpenEjbConfiguration object passed in.
```
 This method performs the following actions(in order):

 1  Assembles ProxyFactory
 2  Assembles External JNDI Contexts
 3  Assembles TransactionService
 4  Assembles SecurityService
 5  Assembles ConnectionManagers
 6  Assembles Connectors
 7  Assembles Containers
 8  Assembles Applications
 
```
Parameters:

configInfo - OpenEjbConfiguration

Throws:

java.lang.Exception - if there was a problem constructing the ContainerSystem.

See Also:

OpenEjbConfiguration

getAppInfo

public AppInfo getAppInfo(java.lang.String path)

isDeployed

public boolean isDeployed(java.lang.String path)

getDeployedApplications

public java.util.Collection<AppInfo> getDeployedApplications()

createApplication

public AppContext createApplication(EjbJarInfo ejbJar)
                             throws javax.naming.NamingException,
                                    java.io.IOException,
                                    OpenEJBException

Throws:: javax.naming.NamingException; java.io.IOException; OpenEJBException

createEjbJar

public AppContext createEjbJar(EjbJarInfo ejbJar)
                        throws javax.naming.NamingException,
                               java.io.IOException,
                               OpenEJBException

Throws:: javax.naming.NamingException; java.io.IOException; OpenEJBException

createApplication

public AppContext createApplication(EjbJarInfo ejbJar,
                                    java.lang.ClassLoader classLoader)
                             throws javax.naming.NamingException,
                                    java.io.IOException,
                                    OpenEJBException

Throws:: javax.naming.NamingException; java.io.IOException; OpenEJBException

createEjbJar

public AppContext createEjbJar(EjbJarInfo ejbJar,
                               java.lang.ClassLoader classLoader)
                        throws javax.naming.NamingException,
                               java.io.IOException,
                               OpenEJBException

Throws:: javax.naming.NamingException; java.io.IOException; OpenEJBException

createClient

public AppContext createClient(ClientInfo clientInfo)
                        throws javax.naming.NamingException,
                               java.io.IOException,
                               OpenEJBException

Throws:: javax.naming.NamingException; java.io.IOException; OpenEJBException

createClient

public AppContext createClient(ClientInfo clientInfo,
                               java.lang.ClassLoader classLoader)
                        throws javax.naming.NamingException,
                               java.io.IOException,
                               OpenEJBException

Throws:: javax.naming.NamingException; java.io.IOException; OpenEJBException

createConnector

public AppContext createConnector(ConnectorInfo connectorInfo)
                           throws javax.naming.NamingException,
                                  java.io.IOException,
                                  OpenEJBException

Throws:: javax.naming.NamingException; java.io.IOException; OpenEJBException

createConnector

public AppContext createConnector(ConnectorInfo connectorInfo,
                                  java.lang.ClassLoader classLoader)
                           throws javax.naming.NamingException,
                                  java.io.IOException,
                                  OpenEJBException

Throws:: javax.naming.NamingException; java.io.IOException; OpenEJBException

createWebApp

public AppContext createWebApp(WebAppInfo webAppInfo)
                        throws javax.naming.NamingException,
                               java.io.IOException,
                               OpenEJBException

Throws:: javax.naming.NamingException; java.io.IOException; OpenEJBException

createWebApp

public AppContext createWebApp(WebAppInfo webAppInfo,
                               java.lang.ClassLoader classLoader)
                        throws javax.naming.NamingException,
                               java.io.IOException,
                               OpenEJBException

Throws:: javax.naming.NamingException; java.io.IOException; OpenEJBException

createApplication

public AppContext createApplication(AppInfo appInfo)
                             throws OpenEJBException,
                                    java.io.IOException,
                                    javax.naming.NamingException

Throws:: OpenEJBException; java.io.IOException; javax.naming.NamingException

createApplication

public AppContext createApplication(AppInfo appInfo,
                                    java.lang.ClassLoader classLoader)
                             throws OpenEJBException,
                                    java.io.IOException,
                                    javax.naming.NamingException

Throws:: OpenEJBException; java.io.IOException; javax.naming.NamingException

mergeServices

public static void mergeServices(AppInfo appInfo)
                          throws java.net.URISyntaxException

Throws:: java.net.URISyntaxException

bindGlobals

public void bindGlobals(java.util.Map<java.lang.String,java.lang.Object> bindings)
                 throws javax.naming.NamingException

Throws:: javax.naming.NamingException

initEjbs

public java.util.List<BeanContext> initEjbs(java.lang.ClassLoader classLoader,
                                            AppInfo appInfo,
                                            AppContext appContext,
                                            java.util.Set<Injection> injections,
                                            java.util.List<BeanContext> allDeployments,
                                            java.lang.String webappId)
                                     throws OpenEJBException

Throws:: OpenEJBException

startEjbs

public void startEjbs(boolean start,
                      java.util.List<BeanContext> allDeployments)
               throws OpenEJBException

Throws:: OpenEJBException

destroy
```
public void destroy()
```
Description copied from interface: Assembler

Destroys the container system and all associated resources.

Specified by:

destroy in interface Assembler

removeResourceInfo

public ResourceInfo removeResourceInfo(java.lang.String name)

destroyApplication

public void destroyApplication(java.lang.String filePath)
                        throws UndeployException,
                               NoSuchApplicationException

Throws:: UndeployException; NoSuchApplicationException

destroyApplication

@Deprecated
public void destroyApplication(AppContext appContext)
                                    throws UndeployException

Deprecated.

Throws:: UndeployException

destroyApplication

public void destroyApplication(AppInfo appInfo)
                        throws UndeployException

Throws:: UndeployException

createAppClassLoader

public java.lang.ClassLoader createAppClassLoader(AppInfo appInfo)
                                           throws OpenEJBException,
                                                  java.io.IOException

Throws:: OpenEJBException; java.io.IOException

createExternalContext

public void createExternalContext(JndiContextInfo contextInfo)
                           throws OpenEJBException

Throws:: OpenEJBException

createContainer

public void createContainer(ContainerInfo serviceInfo)
                     throws OpenEJBException

Throws:: OpenEJBException

removeContainer

public void removeContainer(java.lang.String containerId)

createService

public void createService(ServiceInfo serviceInfo)
                   throws OpenEJBException

Throws:: OpenEJBException

createProxyFactory

public void createProxyFactory(ProxyFactoryInfo serviceInfo)
                        throws OpenEJBException

Throws:: OpenEJBException

createResource

@Deprecated
public void createResource(ResourceInfo serviceInfo)
                                throws OpenEJBException

Deprecated.

Throws:: OpenEJBException

createResource

public void createResource(java.util.Collection<ServiceInfo> infos,
                           ResourceInfo serviceInfo)
                    throws OpenEJBException

Throws:: OpenEJBException

createConnectionManager

public void createConnectionManager(ConnectionManagerInfo serviceInfo)
                             throws OpenEJBException

Throws:: OpenEJBException

createSecurityService

public void createSecurityService(SecurityServiceInfo serviceInfo)
                           throws OpenEJBException

Throws:: OpenEJBException

createTransactionManager

public void createTransactionManager(TransactionServiceInfo serviceInfo)
                              throws OpenEJBException

Throws:: OpenEJBException

logUnusedProperties

public static void logUnusedProperties(ObjectRecipe serviceRecipe,
                                       ServiceInfo info)

prepareRecipe

public static ObjectRecipe prepareRecipe(ServiceInfo info)

Class Assembler

Nested Class Summary

Field Summary

Fields inherited from class org.apache.openejb.assembler.classic.AssemblerTool

Fields inherited from interface org.apache.openejb.JndiConstants

Constructor Summary

Method Summary

Methods inherited from class org.apache.openejb.assembler.classic.AssemblerTool

Methods inherited from class java.lang.Object

Field Detail

OPENEJB_URL_PKG_PREFIX

OPENEJB_JPA_DEPLOY_TIME_ENHANCEMENT_PROP

PROPAGATE_APPLICATION_EXCEPTIONS

TIMER_STORE_CLASS

OPENEJB_TIMERS_ON

VALIDATOR_FACTORY_INTERFACES

VALIDATOR_INTERFACES

logger

resourceDestroyTimeout

threadStackOnTimeout

configFactory

toolkit

config

Constructor Detail

Assembler

Assembler

Method Detail

getContainerSystem

getTransactionManager

getSecurityService

addDeploymentListener

removeDeploymentListener

init

installNaming

installNaming

installNaming

setContext

getContext

build

getOpenEjbConfiguration

buildContainerSystem

getAppInfo

isDeployed

getDeployedApplications

createApplication

createEjbJar

createApplication

createEjbJar

createClient

createClient

createConnector

createConnector

createWebApp

createWebApp

createApplication

createApplication

mergeServices

bindGlobals

initEjbs

startEjbs

destroy

removeResourceInfo

destroyApplication

destroyApplication

destroyApplication

createAppClassLoader

createExternalContext

createContainer

removeContainer

createService

createProxyFactory

createResource

createResource

createConnectionManager

createSecurityService

createTransactionManager

logUnusedProperties

prepareRecipe