org.jboss.deployment
Class EARDeployer

java.lang.Object
  extended byorg.jboss.mx.util.JBossNotificationBroadcasterSupport (src) 
      extended byorg.jboss.system.ServiceMBeanSupport (src) 
          extended byorg.jboss.deployment.SubDeployerSupport (src) 
              extended byorg.jboss.deployment.EARDeployer
All Implemented Interfaces:
MBeanRegistration (src) , NotificationBroadcaster (src) , NotificationEmitter (src) , Service (src) , ServiceMBean (src) , SubDeployer (src)

public class EARDeployer
extends SubDeployerSupport (src)

Enterprise Archive Deployer.


Nested Class Summary
 
Nested classes inherited from class org.jboss.deployment.SubDeployerSupport (src)
SubDeployerSupport.ClassConfiguration (src)
 
Field Summary
 
Fields inherited from class org.jboss.deployment.SubDeployerSupport (src)
CONFIGURATION, mainDeployer, nativePrefix, nativeSuffix, relativeOrder, suffixes, tempDeployDir
 
Fields inherited from class org.jboss.system.ServiceMBeanSupport (src)
log, server, SERVICE_CONTROLLER_SIG, serviceName
 
Fields inherited from interface org.jboss.deployment.SubDeployer (src)
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
 
Fields inherited from interface org.jboss.system.ServiceMBean (src)
CREATE_EVENT, CREATED, DESTROY_EVENT, DESTROYED, FAILED, REGISTERED, START_EVENT, STARTED, STARTING, states, STOP_EVENT, STOPPED, STOPPING, UNREGISTERED
 
Constructor Summary
EARDeployer()
           
 
Method Summary
 boolean accepts(DeploymentInfo (src)  di)
          The accepts method is called by MainDeployer to determine which deployer is suitable for a DeploymentInfo.
 void create(DeploymentInfo (src)  di)
          Sub-classes should override this method to provide custom 'create' logic.
 void destroy(DeploymentInfo (src)  di)
          Describe destroy method here.
 void init(DeploymentInfo (src)  di)
          Sub-classes should override this method to provide custom 'init' logic.
protected  void initLoaderRepository(DeploymentInfo (src)  di, org.w3c.dom.Element loader)
          Build the ear scoped repository
 boolean isCallByValue()
           
protected  boolean isDeployable(java.lang.String name, java.net.URL url)
          Add -ds.xml and -service.xml as legitimate deployables.
 boolean isIsolated()
           
protected  void processNestedDeployments(DeploymentInfo (src)  di)
          Override the default behavior of looking into the archive for deployables as only those explicitly listed in the application.xml and jboss-app.xml should be deployed.
 void setCallByValue(boolean callByValue)
           
 void setIsolated(boolean isolated)
           
 void start(DeploymentInfo (src)  di)
          Sub-classes should override this method to provide custom 'start' logic.
protected  void startService()
          Performs SubDeployer registration.
 void stop(DeploymentInfo (src)  di)
          Sub-classes should override this method to provide custom 'stop' logic.
 
Methods inherited from class org.jboss.deployment.SubDeployerSupport (src)
addDeployableFiles, addDeployableJar, createService, deployUrl, destroyService, emitNotification, getRelativeOrder, getSuffixes, setRelativeOrder, setSuffixes, stopService
 
Methods inherited from class org.jboss.system.ServiceMBeanSupport (src)
create, destroy, 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 (src)
addNotificationListener, getNotificationInfo, handleNotification, 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.SubDeployer (src)
getServiceName
 

Constructor Detail

EARDeployer

public EARDeployer()
Method Detail

isIsolated

public boolean isIsolated()
Returns:
whether ear deployments should be isolated

setIsolated

public void setIsolated(boolean isolated)
Parameters:
isolated - whether ear deployments should be isolated

isCallByValue

public boolean isCallByValue()
Returns:
whether ear deployments should be call by value

setCallByValue

public void setCallByValue(boolean callByValue)
Parameters:
callByValue - whether ear deployments should be call by value

startService

protected void startService()
                     throws java.lang.Exception
Description copied from class: SubDeployerSupport (src)
Performs SubDeployer registration.

Overrides:
startService in class SubDeployerSupport (src)
Throws:
java.lang.Exception

accepts

public boolean accepts(DeploymentInfo (src)  di)
Description copied from interface: SubDeployer (src)
The accepts method is called by MainDeployer to determine which deployer is suitable for a DeploymentInfo.

Parameters:
di - a DeploymentInfo value
Returns:
a boolean value

init

public void init(DeploymentInfo (src)  di)
          throws DeploymentException (src) 
Description copied from class: SubDeployerSupport (src)
Sub-classes should override this method to provide custom 'init' logic.

This method calls the processNestedDeployments(di) method and then issues a JMX notification of type SubDeployer.INIT_NOTIFICATION. This behaviour can overridden by concrete sub-classes. If further initialization needs to be done, and you wish to preserve the functionality, be sure to call super.init(di) at the end of your implementation.

Specified by:
init in interface SubDeployer (src)
Overrides:
init in class SubDeployerSupport (src)
Throws:
DeploymentException (src)

create

public void create(DeploymentInfo (src)  di)
            throws DeploymentException (src) 
Description copied from class: SubDeployerSupport (src)
Sub-classes should override this method to provide custom 'create' logic. This method issues a JMX notification of type SubDeployer.CREATE_NOTIFICATION.

Specified by:
create in interface SubDeployer (src)
Overrides:
create in class SubDeployerSupport (src)
Throws:
DeploymentException (src)

start

public void start(DeploymentInfo (src)  di)
           throws DeploymentException (src) 
Description copied from class: SubDeployerSupport (src)
Sub-classes should override this method to provide custom 'start' logic. This method issues a JMX notification of type SubDeployer.START_NOTIFICATION.

Specified by:
start in interface SubDeployer (src)
Overrides:
start in class SubDeployerSupport (src)
Throws:
DeploymentException (src)

stop

public void stop(DeploymentInfo (src)  di)
          throws DeploymentException (src) 
Description copied from class: SubDeployerSupport (src)
Sub-classes should override this method to provide custom 'stop' logic. This method issues a JMX notification of type SubDeployer.START_NOTIFICATION.

Specified by:
stop in interface SubDeployer (src)
Overrides:
stop in class SubDeployerSupport (src)
Throws:
DeploymentException (src)

destroy

public void destroy(DeploymentInfo (src)  di)
             throws DeploymentException (src) 
Describe destroy method here.

Specified by:
destroy in interface SubDeployer (src)
Overrides:
destroy in class SubDeployerSupport (src)
Parameters:
di - a DeploymentInfo value
Throws:
DeploymentException (src) - if an error occurs

initLoaderRepository

protected void initLoaderRepository(DeploymentInfo (src)  di,
                                    org.w3c.dom.Element loader)
                             throws java.lang.Exception
Build the ear scoped repository

Parameters:
di - the deployment info passed to deploy
loader - the jboss-app/loader-repository element
Throws:
java.lang.Exception

isDeployable

protected boolean isDeployable(java.lang.String name,
                               java.net.URL url)
Add -ds.xml and -service.xml as legitimate deployables.

Overrides:
isDeployable in class SubDeployerSupport (src)
Parameters:
name - The "short-name" of the URL. It will have any trailing '/' characters removed, and any directory structure has been removed.
url - The full url.
Returns:
true iff the name ends in a known archive extension: .jar, .sar, .ear, .rar, .zip, .wsr, .war, or if the name matches the native library conventions.

processNestedDeployments

protected void processNestedDeployments(DeploymentInfo (src)  di)
Override the default behavior of looking into the archive for deployables as only those explicitly listed in the application.xml and jboss-app.xml should be deployed.

Overrides:
processNestedDeployments in class SubDeployerSupport (src)
Parameters:
di -