org.jboss.ejb
Class ContainerFactory

java.lang.Object
  |
  +--javax.management.NotificationBroadcasterSupport
        |
        +--org.jboss.util.ServiceMBeanSupport
              |
              +--org.jboss.ejb.ContainerFactory

All Implemented Interfaces:

ContainerFactoryMBean, javax.management.MBeanRegistration, javax.management.NotificationBroadcaster, Service, ServiceMBean

public class ContainerFactory

extends ServiceMBeanSupport

implements ContainerFactoryMBean

A ContainerFactory is used to deploy EJB applications. It can be given a URL to an EJB-jar or EJB-JAR XML file, which will be used to instantiate containers and make them available for invocation. Now also works with message driven beans

Version:

$Revision: 1.67 $

Author:

Rickard Öberg (rickard.oberg@telkel.com), Marc Fleury, Juha Lindfors, Sebastien Alborini, Peter Antman (peter.antman@tim.se), Scott Stark(Scott_Stark@displayscape.com)

See Also:

Container

Field Summary

static java.lang.String	DEFAULT_ENTITY_BMP_CONFIGURATION
static java.lang.String	DEFAULT_ENTITY_CMP_CONFIGURATION
static java.lang.String	DEFAULT_MESSAGEDRIVEN_CONFIGURATION
static java.lang.String	DEFAULT_STATEFUL_CONFIGURATION
static java.lang.String	DEFAULT_STATELESS_CONFIGURATION

Fields inherited from class org.jboss.util.ServiceMBeanSupport

log, STARTED, STARTING, states, STOPPED, STOPPING

Fields inherited from interface org.jboss.ejb.ContainerFactoryMBean

OBJECT_NAME

Constructor Summary

ContainerFactory()

Method Summary

void	deploy(java.lang.String url) Deploy the file at this URL.
void	deploy(java.lang.String appUrl, java.lang.String[] jarUrls)
void	deploy(java.net.URL url) Deploy EJBs pointed to by an URL.
void	deploy(java.net.URL appUrl, java.net.URL[] jarUrls)
void	destroyService() Implements the template method in superclass.
java.util.Iterator	getDeployedApplications() Returns the deployed applications.
java.lang.String	getName() Implements the abstract getName() method in superclass to return the name of this object.
javax.management.ObjectName	getObjectName(javax.management.MBeanServer server, javax.management.ObjectName name) Implements the abstract getObjectName() method in superclass to return this service's name.
boolean	getVerifierVerbose() Returns the state of the bean verifier (verbose/non-verbose mode)
boolean	getVerifyDeployments() Returns the state of bean verifier (on/off)
boolean	isDeployed(java.lang.String url) is the aplication with this url deployed
boolean	isDeployed(java.net.URL url) check if the application with this url is deployed
boolean	isMetricsEnabled() Checks if this container factory initializes the metrics interceptor.
void	setBeanCacheJMSMonitoringEnabled(boolean enable) Set JMS monitoring of the bean cache.
void	setMetricsEnabled(boolean enable) Enables/disables the metrics interceptor for containers.
void	setVerifierVerbose(boolean verbose) Enables/disables the verbose mode on the verifier.
void	setVerifyDeployments(boolean verify) Enables/disables the application bean verification upon deployment.
void	stopService() Implements the template method in superclass.
void	undeploy(java.lang.String url) Undeploy the file at this URL.
void	undeploy(java.net.URL url) Remove previously deployed EJBs.

Methods inherited from class org.jboss.util.ServiceMBeanSupport

destroy, getState, getStateString, init, initService, postDeregister, postRegister, preDeregister, preRegister, start, startService, stop

Methods inherited from class javax.management.NotificationBroadcasterSupport

addNotificationListener, getNotificationInfo, removeNotificationListener, sendNotification

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.jboss.util.ServiceMBean

getState, getStateString

Methods inherited from interface org.jboss.util.Service

destroy, init, start, stop

Field Detail

DEFAULT_STATELESS_CONFIGURATION

public static java.lang.String DEFAULT_STATELESS_CONFIGURATION

DEFAULT_STATEFUL_CONFIGURATION

public static java.lang.String DEFAULT_STATEFUL_CONFIGURATION

DEFAULT_ENTITY_BMP_CONFIGURATION

public static java.lang.String DEFAULT_ENTITY_BMP_CONFIGURATION

DEFAULT_ENTITY_CMP_CONFIGURATION

public static java.lang.String DEFAULT_ENTITY_CMP_CONFIGURATION

DEFAULT_MESSAGEDRIVEN_CONFIGURATION

public static java.lang.String DEFAULT_MESSAGEDRIVEN_CONFIGURATION

Constructor Detail

ContainerFactory

public ContainerFactory()

Method Detail

getDeployedApplications

public java.util.Iterator getDeployedApplications()

Returns the deployed applications.

Specified by:

getDeployedApplications in interface ContainerFactoryMBean

getObjectName

public javax.management.ObjectName getObjectName(javax.management.MBeanServer server,
                                                 javax.management.ObjectName name)
                                          throws javax.management.MalformedObjectNameException

Implements the abstract getObjectName() method in superclass to return this service's name.

Overrides:

getObjectName in class ServiceMBeanSupport

Parameters:

server -

name -

Returns:

Throws:

MalformedObjectNameException -

getName

public java.lang.String getName()

Implements the abstract getName() method in superclass to return the name of this object.

Specified by:

getName in interface ServiceMBean

Overrides:

getName in class ServiceMBeanSupport

Returns:

'Container factory'

stopService

public void stopService()

Implements the template method in superclass. This method stops all the applications in this server.

Overrides:

stopService in class ServiceMBeanSupport

destroyService

public void destroyService()

Implements the template method in superclass. This method destroys all the applications in this server and clears the deployments list.

Overrides:

destroyService in class ServiceMBeanSupport

setVerifyDeployments

public void setVerifyDeployments(boolean verify)

Enables/disables the application bean verification upon deployment.

Specified by:

setVerifyDeployments in interface ContainerFactoryMBean

Parameters:

verify - true to enable; false to disable

getVerifyDeployments

public boolean getVerifyDeployments()

Returns the state of bean verifier (on/off)

Specified by:

getVerifyDeployments in interface ContainerFactoryMBean

Returns:

true if enabled; false otherwise

setVerifierVerbose

public void setVerifierVerbose(boolean verbose)

Enables/disables the verbose mode on the verifier.

Specified by:

setVerifierVerbose in interface ContainerFactoryMBean

Parameters:

verbose - true to enable; false to disable

getVerifierVerbose

public boolean getVerifierVerbose()

Returns the state of the bean verifier (verbose/non-verbose mode)

Specified by:

getVerifierVerbose in interface ContainerFactoryMBean

Returns:

true if enabled; false otherwise

setMetricsEnabled

public void setMetricsEnabled(boolean enable)

Enables/disables the metrics interceptor for containers.

Specified by:

setMetricsEnabled in interface ContainerFactoryMBean

Parameters:

enable - true to enable; false to disable

isMetricsEnabled

public boolean isMetricsEnabled()

Checks if this container factory initializes the metrics interceptor.

Specified by:

isMetricsEnabled in interface ContainerFactoryMBean

Returns:

true if metrics are enabled; false otherwise

setBeanCacheJMSMonitoringEnabled

public void setBeanCacheJMSMonitoringEnabled(boolean enable)

Set JMS monitoring of the bean cache.

Specified by:

setBeanCacheJMSMonitoringEnabled in interface ContainerFactoryMBean

deploy

public void deploy(java.lang.String url)
            throws java.net.MalformedURLException,
                   DeploymentException

Deploy the file at this URL. This method is typically called from remote administration tools that cannot handle java.net.URL's as parameters to methods

Specified by:

deploy in interface ContainerFactoryMBean

Parameters:

url -

Throws:

java.net.MalformedURLException -

DeploymentException -

deploy

public void deploy(java.lang.String appUrl,
                   java.lang.String[] jarUrls)
            throws java.net.MalformedURLException,
                   DeploymentException

Specified by:

deploy in interface ContainerFactoryMBean

undeploy

public void undeploy(java.lang.String url)
              throws java.net.MalformedURLException,
                     DeploymentException

Undeploy the file at this URL. This method is typically called from remote administration tools that cannot handle java.net.URL's as parameters to methods

Specified by:

undeploy in interface ContainerFactoryMBean

Parameters:

url -

Throws:

java.net.MalformedURLException -

DeploymentException -

deploy

public void deploy(java.net.URL url)
            throws DeploymentException

Deploy EJBs pointed to by an URL. The URL may point to an EJB-JAR, an EAR-JAR, or an codebase whose structure resembles that of an EJB-JAR.

The latter is useful for development since no packaging is required.

Parameters:

url - URL where EJB deployment information is contained

Throws:

DeploymentException -

deploy

public void deploy(java.net.URL appUrl,
                   java.net.URL[] jarUrls)
            throws DeploymentException

undeploy

public void undeploy(java.net.URL url)
              throws DeploymentException

Remove previously deployed EJBs.

Parameters:

url -

Throws:

DeploymentException -

isDeployed

public boolean isDeployed(java.lang.String url)
                   throws java.net.MalformedURLException

is the aplication with this url deployed

Specified by:

isDeployed in interface ContainerFactoryMBean

Parameters:

url -

Throws:

java.net.MalformedURLException -

isDeployed

public boolean isDeployed(java.net.URL url)

check if the application with this url is deployed

Parameters:

url -

Returns:

true if deployed