org.ow2.ishmael.deploy.spi
Class BasicConnectedDeploymentManager

java.lang.Object
  org.ow2.ishmael.deploy.spi.BasicDeploymentManager
      org.ow2.ishmael.deploy.spi.BasicConnectedDeploymentManager

All Implemented Interfaces:

javax.enterprise.deploy.spi.DeploymentManager

public class BasicConnectedDeploymentManager
extends BasicDeploymentManager

BasicDeploymentManager.java This is the disconnected-mode JSR-88 DeploymentManager for JOnAS. Created: Fri Nov 22 15:36:32 2002

Nested Class Summary

protected class

BasicConnectedDeploymentManager.JOnASTarget

Field Summary

static java.lang.String	APPLICATION_FILE_NAME Path of the application.xml deploymnet descriptor file
static java.lang.String	CLIENT_FILE_NAME The path to the application-client.xml file.
static java.lang.String	EJB_JAR_FILE_NAME ejb-jar.xml filename
static java.lang.String	JONAS_APPLICATION_FILE_NAME Path of the jonas-application.xml deploymnet descriptor file
static java.lang.String	JONAS_CLIENT_FILE_NAME The path to the jonas-client.xml file.
static java.lang.String	JONAS_EJB_JAR_FILE_NAME jonas-ejb-jar.xml filename
static java.lang.String	JONAS_RA_FILE_NAME Path of the jonas-ra.xml deploymnet descriptor file
static java.lang.String	JONAS_WEB_FILE_NAME The path to the jonas-web.xml file.
static java.lang.String	JONAS_WS_EJBJAR_FILE_NAME jonas-ejb-jar.xml filename
static java.lang.String	JONAS_WS_WEBAPP_FILE_NAME jonas-ejb-jar.xml filename
static java.lang.String	RA_FILE_NAME Path of the ra.xml deploymnet descriptor file
static java.lang.String	WEB_FILE_NAME The path to the web.xml file.
static java.lang.String	WS_EJBJAR_FILE_NAME ejb-jar.xml filename
static java.lang.String	WS_WEBAPP_FILE_NAME ejb-jar.xml filename
static java.lang.String	WSGENClASSNAME Class of JOnAS WsGen generator

Constructor Summary

BasicConnectedDeploymentManager(java.lang.String uri, java.lang.String userName, java.lang.String password)

Method Summary

javax.enterprise.deploy.spi.status.ProgressObject	distribute(javax.enterprise.deploy.spi.Target[] targets, java.io.File fileArchive, java.io.File plan) The distribute method performs three tasks; it validates the deployment configuration data, generates all container specific classes and interfaces, and moves the fully baked archive to the designated deployment targets.
javax.enterprise.deploy.spi.status.ProgressObject	distribute(javax.enterprise.deploy.spi.Target[] targets, java.io.InputStream archive, java.io.InputStream plan) The distribute method performs three tasks; it validates the deployment configuration data, generates all container specific classes and interfaces, and moves the fully baked archive to the designated deployment targets.
javax.enterprise.deploy.spi.status.ProgressObject	distribute(javax.enterprise.deploy.spi.Target[] arg0, javax.enterprise.deploy.shared.ModuleType arg1, java.io.InputStream arg2, java.io.InputStream arg3)
javax.enterprise.deploy.spi.TargetModuleID[]	getAvailableModules(javax.enterprise.deploy.shared.ModuleType param1, javax.enterprise.deploy.spi.Target[] param2) Retrieve the list of all J2EE application modules running or not running on the identified targets.
javax.enterprise.deploy.spi.TargetModuleID[]	getNonRunningModules(javax.enterprise.deploy.shared.ModuleType param1, javax.enterprise.deploy.spi.Target[] param2)
javax.enterprise.deploy.spi.TargetModuleID[]	getRunningModules(javax.enterprise.deploy.shared.ModuleType param1, javax.enterprise.deploy.spi.Target[] param2) Retrieve the list of J2EE application modules distributed to the identified targets and that are currently running on the associated server or servers
javax.enterprise.deploy.spi.Target[]	getTargets()
void	release()
javax.enterprise.deploy.spi.status.ProgressObject	start(javax.enterprise.deploy.spi.TargetModuleID[] param1) Start one or more targets.
javax.enterprise.deploy.spi.status.ProgressObject	stop(javax.enterprise.deploy.spi.TargetModuleID[] param1) Stop one or more targets.
javax.enterprise.deploy.spi.status.ProgressObject	undeploy(javax.enterprise.deploy.spi.TargetModuleID[] param1) Remove the application from the target server.

Methods inherited from class org.ow2.ishmael.deploy.spi.BasicDeploymentManager

createConfiguration, getCurrentLocale, getDConfigBeanVersion, getDefaultLocale, getSupportedLocales, isDConfigBeanVersionSupported, isLocaleSupported, isRedeploySupported, redeploy, redeploy, setDConfigBeanVersion, setLocale

Methods inherited from class java.lang.Object

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

Field Detail

APPLICATION_FILE_NAME

public static final java.lang.String APPLICATION_FILE_NAME

Path of the application.xml deploymnet descriptor file

See Also:

Constant Field Values

JONAS_APPLICATION_FILE_NAME

public static final java.lang.String JONAS_APPLICATION_FILE_NAME

Path of the jonas-application.xml deploymnet descriptor file

See Also:

Constant Field Values

RA_FILE_NAME

public static final java.lang.String RA_FILE_NAME

Path of the ra.xml deploymnet descriptor file

See Also:

Constant Field Values

JONAS_RA_FILE_NAME

public static final java.lang.String JONAS_RA_FILE_NAME

Path of the jonas-ra.xml deploymnet descriptor file

See Also:

Constant Field Values

CLIENT_FILE_NAME

public static final java.lang.String CLIENT_FILE_NAME

The path to the application-client.xml file.

See Also:

Constant Field Values

JONAS_CLIENT_FILE_NAME

public static final java.lang.String JONAS_CLIENT_FILE_NAME

The path to the jonas-client.xml file.

See Also:

Constant Field Values

EJB_JAR_FILE_NAME

public static final java.lang.String EJB_JAR_FILE_NAME

ejb-jar.xml filename

See Also:

Constant Field Values

JONAS_EJB_JAR_FILE_NAME

public static final java.lang.String JONAS_EJB_JAR_FILE_NAME

jonas-ejb-jar.xml filename

See Also:

Constant Field Values

WEB_FILE_NAME

public static final java.lang.String WEB_FILE_NAME

The path to the web.xml file.

See Also:

Constant Field Values

JONAS_WEB_FILE_NAME

public static final java.lang.String JONAS_WEB_FILE_NAME

The path to the jonas-web.xml file.

See Also:

Constant Field Values

WS_EJBJAR_FILE_NAME

public static final java.lang.String WS_EJBJAR_FILE_NAME

ejb-jar.xml filename

See Also:

Constant Field Values

JONAS_WS_EJBJAR_FILE_NAME

public static final java.lang.String JONAS_WS_EJBJAR_FILE_NAME

jonas-ejb-jar.xml filename

See Also:

Constant Field Values

WS_WEBAPP_FILE_NAME

public static final java.lang.String WS_WEBAPP_FILE_NAME

ejb-jar.xml filename

See Also:

Constant Field Values

JONAS_WS_WEBAPP_FILE_NAME

public static final java.lang.String JONAS_WS_WEBAPP_FILE_NAME

jonas-ejb-jar.xml filename

See Also:

Constant Field Values

WSGENClASSNAME

public static final java.lang.String WSGENClASSNAME

Class of JOnAS WsGen generator

See Also:

Constant Field Values

Constructor Detail

BasicConnectedDeploymentManager

public BasicConnectedDeploymentManager(java.lang.String uri,
                                       java.lang.String userName,
                                       java.lang.String password)
                                throws IshmaelDeploymentManagerCreationException

Throws:

IshmaelDeploymentManagerCreationException

Method Detail

start

public javax.enterprise.deploy.spi.status.ProgressObject start(javax.enterprise.deploy.spi.TargetModuleID[] param1)
                                                        throws java.lang.IllegalStateException

Start one or more targets.

Specified by:

start in interface javax.enterprise.deploy.spi.DeploymentManager

Overrides:

start in class BasicDeploymentManager

Throws:

java.lang.IllegalStateException - thrown because we're in disconnected mode

stop

public javax.enterprise.deploy.spi.status.ProgressObject stop(javax.enterprise.deploy.spi.TargetModuleID[] param1)
                                                       throws java.lang.IllegalStateException

Stop one or more targets.

Specified by:

stop in interface javax.enterprise.deploy.spi.DeploymentManager

Overrides:

stop in class BasicDeploymentManager

Throws:

java.lang.IllegalStateException - thrown because we're in disconnected mode

getTargets

public javax.enterprise.deploy.spi.Target[] getTargets()
                                                throws java.lang.IllegalStateException

Specified by:

getTargets in interface javax.enterprise.deploy.spi.DeploymentManager

Overrides:

getTargets in class BasicDeploymentManager

Throws:

java.lang.IllegalStateException - thrown because we're in disconnected mode

getRunningModules

public javax.enterprise.deploy.spi.TargetModuleID[] getRunningModules(javax.enterprise.deploy.shared.ModuleType param1,
                                                                      javax.enterprise.deploy.spi.Target[] param2)
                                                               throws javax.enterprise.deploy.spi.exceptions.TargetException,
                                                                      java.lang.IllegalStateException

Retrieve the list of J2EE application modules distributed to the identified targets and that are currently running on the associated server or servers

Specified by:

getRunningModules in interface javax.enterprise.deploy.spi.DeploymentManager

Overrides:

getRunningModules in class BasicDeploymentManager

Parameters:

param1 - module J2EE module type.

param2 - target A list of deployment Target designators

Returns:

An array of TargetModuleID objects representing the running modules or 'null' if there are none

Throws:

javax.enterprise.deploy.spi.exceptions.TargetException - An invalid Target designator encountered.

java.lang.IllegalStateException - is thrown when the method is called when running in disconnected mode

getNonRunningModules

public javax.enterprise.deploy.spi.TargetModuleID[] getNonRunningModules(javax.enterprise.deploy.shared.ModuleType param1,
                                                                         javax.enterprise.deploy.spi.Target[] param2)
                                                                  throws javax.enterprise.deploy.spi.exceptions.TargetException,
                                                                         java.lang.IllegalStateException

Specified by:

getNonRunningModules in interface javax.enterprise.deploy.spi.DeploymentManager

Overrides:

getNonRunningModules in class BasicDeploymentManager

Parameters:

param1 -

param2 -

Returns:

non running modules = availables modules

Throws:

javax.enterprise.deploy.spi.exceptions.TargetException -

java.lang.IllegalStateException -

getAvailableModules

public javax.enterprise.deploy.spi.TargetModuleID[] getAvailableModules(javax.enterprise.deploy.shared.ModuleType param1,
                                                                        javax.enterprise.deploy.spi.Target[] param2)
                                                                 throws javax.enterprise.deploy.spi.exceptions.TargetException,
                                                                        java.lang.IllegalStateException

Retrieve the list of all J2EE application modules running or not running on the identified targets.

Specified by:

getAvailableModules in interface javax.enterprise.deploy.spi.DeploymentManager

Overrides:

getAvailableModules in class BasicDeploymentManager

Parameters:

param1 - ModuleType

param2 - Target[]

Returns:

TargetModuleID : available modules = non deployed| undeployed |stopped modules

Throws:

javax.enterprise.deploy.spi.exceptions.TargetException -

java.lang.IllegalStateException -

distribute

public javax.enterprise.deploy.spi.status.ProgressObject distribute(javax.enterprise.deploy.spi.Target[] targets,
                                                                    java.io.InputStream archive,
                                                                    java.io.InputStream plan)
                                                             throws java.lang.IllegalStateException

The distribute method performs three tasks; it validates the deployment configuration data, generates all container specific classes and interfaces, and moves the fully baked archive to the designated deployment targets.

Specified by:

distribute in interface javax.enterprise.deploy.spi.DeploymentManager

Overrides:

distribute in class BasicDeploymentManager

Parameters:

param1 -

param2 -

param3 -

Returns:

Throws:

java.lang.IllegalStateException -

distribute

public javax.enterprise.deploy.spi.status.ProgressObject distribute(javax.enterprise.deploy.spi.Target[] arg0,
                                                                    javax.enterprise.deploy.shared.ModuleType arg1,
                                                                    java.io.InputStream arg2,
                                                                    java.io.InputStream arg3)
                                                             throws java.lang.IllegalStateException

Specified by:

distribute in interface javax.enterprise.deploy.spi.DeploymentManager

Overrides:

distribute in class BasicDeploymentManager

Throws:

java.lang.IllegalStateException

distribute

public javax.enterprise.deploy.spi.status.ProgressObject distribute(javax.enterprise.deploy.spi.Target[] targets,
                                                                    java.io.File fileArchive,
                                                                    java.io.File plan)
                                                             throws java.lang.IllegalStateException

The distribute method performs three tasks; it validates the deployment configuration data, generates all container specific classes and interfaces, and moves the fully baked archive to the designated deployment targets.

Specified by:

distribute in interface javax.enterprise.deploy.spi.DeploymentManager

Overrides:

distribute in class BasicDeploymentManager

Parameters:

targets - to distribute

fileArchive - initial archive

plan - jar file containing specific deployment descriptor to inject and a JOnAS Plan

Returns:

ProgressObject

Throws:

java.lang.IllegalStateException -

undeploy

public javax.enterprise.deploy.spi.status.ProgressObject undeploy(javax.enterprise.deploy.spi.TargetModuleID[] param1)
                                                           throws java.lang.IllegalStateException

Remove the application from the target server. Only the TargetModuleIDs which represent a root module are valid for undeployment. A root TargetModuleID has no parent. A TargetModuleID with a parent can not be undeployed. A root TargetModuleID module and all its child modules will be undeployed. The root TargetModuleID module and all its child modules must stopped before they can be undeployed.

Specified by:

undeploy in interface javax.enterprise.deploy.spi.DeploymentManager

Overrides:

undeploy in class BasicDeploymentManager

Parameters:

param1 - target to be undeploy

Returns:

Throws:

java.lang.IllegalStateException -

release

public void release()

Specified by:

release in interface javax.enterprise.deploy.spi.DeploymentManager

Overrides:

release in class BasicDeploymentManager