org.jboss.ejb
Class EJBDeployer

java.lang.Object
  org.jboss.mx.util.JBossNotificationBroadcasterSupport
      org.jboss.system.ServiceMBeanSupport
          org.jboss.deployment.SubDeployerSupport
              org.jboss.ejb.EJBDeployer

All Implemented Interfaces:

javax.management.MBeanRegistration, javax.management.NotificationBroadcaster, javax.management.NotificationEmitter, org.jboss.deployment.SubDeployer, org.jboss.deployment.SubDeployerExt, org.jboss.deployment.SubDeployerExtMBean, org.jboss.deployment.SubDeployerMBean, EJBDeployerMBean, org.jboss.system.Service, org.jboss.system.ServiceMBean

public class EJBDeployer
extends org.jboss.deployment.SubDeployerSupport
implements EJBDeployerMBean

A EJBDeployer 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.

Version:

$Revision: 1.59.4.5 $

Author:

Rickard Öberg, Marc Fleury, Juha Lindfors, Sebastien Alborini, Peter Antman, Scott Stark, Sacha Labourey, Jason Dillon, Christoph G. Jung, Thomas Diesler, Dimitris Andreadis

See Also:

Container

Nested Class Summary

Nested classes/interfaces inherited from class org.jboss.deployment.SubDeployerSupport

org.jboss.deployment.SubDeployerSupport.ClassConfiguration

Field Summary

Fields inherited from class org.jboss.deployment.SubDeployerSupport

CONFIGURATION, enhancedSuffixes, mainDeployer, nativePrefix, nativeSuffix, relativeOrder, suffixes, tempDeployDir

Fields inherited from class org.jboss.system.ServiceMBeanSupport

log, server, SERVICE_CONTROLLER_SIG, serviceName

Fields inherited from interface org.jboss.ejb.EJBDeployerMBean

OBJECT_NAME

Fields inherited from interface org.jboss.system.ServiceMBean

CREATE_EVENT, CREATED, DESTROY_EVENT, DESTROYED, FAILED, REGISTERED, START_EVENT, STARTED, STARTING, states, STOP_EVENT, STOPPED, STOPPING, UNREGISTERED

Fields inherited from interface org.jboss.deployment.SubDeployer

CREATE_NOTIFICATION, DESTROY_NOTIFICATION, INIT_NOTIFICATION, RELATIVE_ORDER_100, RELATIVE_ORDER_200, RELATIVE_ORDER_300, RELATIVE_ORDER_400, RELATIVE_ORDER_500, RELATIVE_ORDER_600, RELATIVE_ORDER_700, RELATIVE_ORDER_800, RELATIVE_ORDER_900, START_NOTIFICATION, STOP_NOTIFICATION

Constructor Summary

EJBDeployer()
Default CTOR

Method Summary

boolean	accepts(org.jboss.deployment.DeploymentInfo di)
void	create(org.jboss.deployment.DeploymentInfo di)
void	destroy(org.jboss.deployment.DeploymentInfo di)
boolean	getStrictVerifier() Returns the mode of the bean verifier (strict/non-strict mode)
javax.management.ObjectName	getTransactionManagerServiceName() Get the TransactionManagerServiceName value.
boolean	getValidateDTDs() Get the flag indicating that ejb-jar.dtd, jboss.dtd & jboss-web.dtd conforming documents should be validated against the DTD.
boolean	getVerifierVerbose() Returns the state of the bean verifier (verbose/non-verbose mode)
boolean	getVerifyDeployments() Returns the state of bean verifier (on/off)
javax.management.ObjectName	getWebServiceName() Get the WebServiceName value.
void	init(org.jboss.deployment.DeploymentInfo di)
boolean	isCallByValue()
boolean	isMetricsEnabled() Checks if this container factory initializes the metrics interceptor.
Iterator	listDeployedApplications() Returns the deployed applications.
protected void	processNestedDeployments(org.jboss.deployment.DeploymentInfo di) This is here as a reminder that we may not want to allow ejb jars to have arbitrary sub deployments.
void	setCallByValue(boolean callByValue) Whether ear deployments should be call by value
void	setMetricsEnabled(boolean enable) Enables/disables the metrics interceptor for containers.
void	setStrictVerifier(boolean strictVerifier) Enables/disables the strict mode on the verifier.
void	setTransactionManagerServiceName(javax.management.ObjectName transactionManagerServiceName) Set the TransactionManagerServiceName value.
void	setValidateDTDs(boolean validate) Set the flag indicating that ejb-jar.dtd, jboss.dtd & jboss-web.dtd conforming documents should be validated against the DTD.
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	setWebServiceName(javax.management.ObjectName webServiceName) Set the WebServiceName value.
void	start(org.jboss.deployment.DeploymentInfo di)
protected void	startService() Get a reference to the ServiceController
void	stop(org.jboss.deployment.DeploymentInfo di)
protected void	stopService() Implements the template method in superclass.

Methods inherited from class org.jboss.deployment.SubDeployerSupport

addDeployableFiles, addDeployableJar, createService, deployUrl, destroyService, emitNotification, getEnhancedSuffixes, getRelativeOrder, getSuffixes, isDeployable, setEnhancedSuffixes, setRelativeOrder, setSuffixes

Methods inherited from class org.jboss.system.ServiceMBeanSupport

create, destroy, getDeploymentInfo, getLog, getName, getNextNotificationSequenceNumber, getObjectName, getServer, getServiceName, getState, getStateString, jbossInternalCreate, jbossInternalDescription, jbossInternalDestroy, jbossInternalLifecycle, jbossInternalStart, jbossInternalStop, postDeregister, postRegister, preDeregister, preRegister, start, stop

Methods inherited from class org.jboss.mx.util.JBossNotificationBroadcasterSupport

addNotificationListener, getNotificationInfo, handleNotification, nextNotificationSequenceNumber, removeNotificationListener, 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.deployment.SubDeployerExtMBean

getEnhancedSuffixes, setEnhancedSuffixes

Methods inherited from interface org.jboss.deployment.SubDeployerMBean

getRelativeOrder, getServiceName, getSuffixes

Methods inherited from interface org.jboss.system.ServiceMBean

getName, getState, getStateString, jbossInternalLifecycle

Methods inherited from interface org.jboss.system.Service

create, destroy, start, stop

Methods inherited from interface org.jboss.deployment.SubDeployer

getServiceName

Constructor Detail

EJBDeployer

public EJBDeployer()

Default CTOR

Method Detail

isCallByValue

public boolean isCallByValue()

Specified by:

isCallByValue in interface EJBDeployerMBean

Returns:

whether ear deployments should be call by value

setCallByValue

public void setCallByValue(boolean callByValue)

Description copied from interface: EJBDeployerMBean

Whether ear deployments should be call by value

Specified by:

setCallByValue in interface EJBDeployerMBean

Parameters:

callByValue - whether ear deployments should be call by value

listDeployedApplications

public Iterator listDeployedApplications()

Returns the deployed applications.

Specified by:

listDeployedApplications in interface EJBDeployerMBean

Returns:

an iterator over DeploymentInfo instances

startService

protected void startService()
                     throws Exception

Get a reference to the ServiceController

Overrides:

startService in class org.jboss.deployment.SubDeployerSupport

Throws:

Exception

stopService

protected void stopService()
                    throws Exception

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

Overrides:

stopService in class org.jboss.deployment.SubDeployerSupport

Throws:

Exception

setVerifyDeployments

public void setVerifyDeployments(boolean verify)

Enables/disables the application bean verification upon deployment.

Specified by:

setVerifyDeployments in interface EJBDeployerMBean

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 EJBDeployerMBean

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 EJBDeployerMBean

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 EJBDeployerMBean

Returns:

true if enabled; false otherwise

setStrictVerifier

public void setStrictVerifier(boolean strictVerifier)

Enables/disables the strict mode on the verifier.

Specified by:

setStrictVerifier in interface EJBDeployerMBean

Parameters:

strictVerifier - true to enable; false to disable

getStrictVerifier

public boolean getStrictVerifier()

Returns the mode of the bean verifier (strict/non-strict mode)

Specified by:

getStrictVerifier in interface EJBDeployerMBean

Returns:

true if the Verifier is in strict mode, false otherwise

setMetricsEnabled

public void setMetricsEnabled(boolean enable)

Enables/disables the metrics interceptor for containers.

Specified by:

setMetricsEnabled in interface EJBDeployerMBean

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 EJBDeployerMBean

Returns:

true if metrics are enabled; false otherwise

getValidateDTDs

public boolean getValidateDTDs()

Get the flag indicating that ejb-jar.dtd, jboss.dtd & jboss-web.dtd conforming documents should be validated against the DTD.

Specified by:

getValidateDTDs in interface EJBDeployerMBean

setValidateDTDs

public void setValidateDTDs(boolean validate)

Set the flag indicating that ejb-jar.dtd, jboss.dtd & jboss-web.dtd conforming documents should be validated against the DTD.

Specified by:

setValidateDTDs in interface EJBDeployerMBean

getWebServiceName

public javax.management.ObjectName getWebServiceName()

Get the WebServiceName value.

Specified by:

getWebServiceName in interface EJBDeployerMBean

Returns:

the WebServiceName value.

setWebServiceName

public void setWebServiceName(javax.management.ObjectName webServiceName)

Set the WebServiceName value.

Specified by:

setWebServiceName in interface EJBDeployerMBean

Parameters:

webServiceName - The new WebServiceName value.

getTransactionManagerServiceName

public javax.management.ObjectName getTransactionManagerServiceName()

Get the TransactionManagerServiceName value.

Specified by:

getTransactionManagerServiceName in interface EJBDeployerMBean

Returns:

the TransactionManagerServiceName value.

setTransactionManagerServiceName

public void setTransactionManagerServiceName(javax.management.ObjectName transactionManagerServiceName)

Set the TransactionManagerServiceName value.

Specified by:

setTransactionManagerServiceName in interface EJBDeployerMBean

Parameters:

transactionManagerServiceName - The new TransactionManagerServiceName value.

accepts

public boolean accepts(org.jboss.deployment.DeploymentInfo di)

Specified by:

accepts in interface org.jboss.deployment.SubDeployer

Specified by:

accepts in interface org.jboss.deployment.SubDeployerMBean

Overrides:

accepts in class org.jboss.deployment.SubDeployerSupport

init

public void init(org.jboss.deployment.DeploymentInfo di)
          throws org.jboss.deployment.DeploymentException

Specified by:

init in interface org.jboss.deployment.SubDeployer

Specified by:

init in interface org.jboss.deployment.SubDeployerMBean

Overrides:

init in class org.jboss.deployment.SubDeployerSupport

Throws:

org.jboss.deployment.DeploymentException

processNestedDeployments

protected void processNestedDeployments(org.jboss.deployment.DeploymentInfo di)
                                 throws org.jboss.deployment.DeploymentException

This is here as a reminder that we may not want to allow ejb jars to have arbitrary sub deployments. Currently we do.

Overrides:

processNestedDeployments in class org.jboss.deployment.SubDeployerSupport

Parameters:

di -

Throws:

org.jboss.deployment.DeploymentException

create

public void create(org.jboss.deployment.DeploymentInfo di)
            throws org.jboss.deployment.DeploymentException

Specified by:

create in interface org.jboss.deployment.SubDeployer

Specified by:

create in interface org.jboss.deployment.SubDeployerMBean

Overrides:

create in class org.jboss.deployment.SubDeployerSupport

Throws:

org.jboss.deployment.DeploymentException

start

public void start(org.jboss.deployment.DeploymentInfo di)
           throws org.jboss.deployment.DeploymentException

Specified by:

start in interface org.jboss.deployment.SubDeployer

Specified by:

start in interface org.jboss.deployment.SubDeployerMBean

Overrides:

start in class org.jboss.deployment.SubDeployerSupport

Throws:

org.jboss.deployment.DeploymentException

stop

public void stop(org.jboss.deployment.DeploymentInfo di)
          throws org.jboss.deployment.DeploymentException

Specified by:

stop in interface org.jboss.deployment.SubDeployer

Specified by:

stop in interface org.jboss.deployment.SubDeployerMBean

Overrides:

stop in class org.jboss.deployment.SubDeployerSupport

Throws:

org.jboss.deployment.DeploymentException

destroy

public void destroy(org.jboss.deployment.DeploymentInfo di)
             throws org.jboss.deployment.DeploymentException

Specified by:

destroy in interface org.jboss.deployment.SubDeployer

Specified by:

destroy in interface org.jboss.deployment.SubDeployerMBean

Overrides:

destroy in class org.jboss.deployment.SubDeployerSupport

Throws:

org.jboss.deployment.DeploymentException