org.glassfish.deployapi
Class SunDeploymentManager

java.lang.Object
  org.glassfish.deployapi.SunDeploymentManager

All Implemented Interfaces:

DeploymentManager

public class SunDeploymentManager
extends Object
implements DeploymentManager

Author:

Jerome Dochez, Tim Quinn

Nested Class Summary

protected static class	SunDeploymentManager.DeploymentFacilityModuleWork Encapsulates information used with a single invocation of a DeploymentFacility method-- that is, one item of "work" the DeploymentFacility is being asked to perform.
protected static class	SunDeploymentManager.TargetModuleIDCollection Organizes the target module IDs passed by a JSR88 client for easy processing one module ID at a time.

Constructor Summary

SunDeploymentManager()
Creates a new instance of DeploymentManager

SunDeploymentManager(ServerConnectionIdentifier sci)
Creates a new instance of DeploymentManager

Method Summary

DeploymentConfiguration	createConfiguration(DeployableObject dObj) Retrieve the object that provides server-specific deployment configuration information for the J2EE deployable component.
ProgressObject	distribute(Target[] targetList, Archive moduleArchive, Archive deploymentPlan, Object deploymentOptions) 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.
ProgressObject	distribute(Target[] targetList, File moduleArchive, File deploymentPlan) 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.
ProgressObject	distribute(Target[] targetList, InputStream moduleArchive, InputStream deploymentPlan) 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.
ProgressObject	distribute(Target[] targetList, ModuleType type, InputStream moduleArchive, InputStream deploymentPlan) 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.
Archive	getArchive(URI path, String name) Creates a new instance of Archive which can be used to store application elements in a layout that can be directly used by the application server.
TargetModuleID[]	getAvailableModules(ModuleType moduleType, Target[] targetList) Retrieve the list of all J2EE application modules running or not running on the identified targets.
Locale	getCurrentLocale() Returns the active locale this implementation of javax.enterprise.deploy.spi subpackages is running.
DConfigBeanVersionType	getDConfigBeanVersion() Returns the J2EE platform version number for which the configuration beans are provided.
Locale	getDefaultLocale() Returns the default locale supported by this implementation of javax.enterprise.deploy.spi subpackages.
TargetModuleID[]	getNonRunningModules(ModuleType moduleType, Target[] targetList) Retrieve the list of J2EE application modules distributed to the identified targets and that are currently not running on the associated server or servers.
protected Properties	getProperties()
TargetModuleID[]	getRunningModules(ModuleType moduleType, Target[] targetList) Retrieve the list of J2EE application modules distributed to the identified targets and that are currently running on the associated server or servers.
Locale[]	getSupportedLocales() Returns an array of supported locales for this implementation.
Target[]	getTargets() Retrieve the list of deployment targets supported by this DeploymentManager.
boolean	isDConfigBeanVersionSupported(DConfigBeanVersionType version) Returns 'true' if the configuration beans support the J2EE platform version specified.
boolean	isLocaleSupported(Locale locale) Reports if this implementation supports the designated locale.
boolean	isRedeploySupported() This method designates whether this platform vendor provides application redeployment functionality.
ProgressObject	redeploy(TargetModuleID[] moduleIDList, File moduleArchive, File deploymentPlan) (optional) The redeploy method provides a means for updating currently deployed J2EE applications.
ProgressObject	redeploy(TargetModuleID[] moduleIDList, InputStream moduleArchive, InputStream deploymentPlan) (optional) The redeploy method provides a means for updating currently deployed J2EE applications.
void	release() The release method is the mechanism by which the tool signals to the DeploymentManager that the tool does not need it to continue running connected to the platform.
void	setDConfigBeanVersion(DConfigBeanVersionType version) Set the configuration beans to be used to the J2EE platform version specificed.
void	setLocale(Locale locale) Set the active locale for this implementation of javax.enterprise.deploy.spi subpackages to run.
void	setServerConnectionEnvironment(ServerConnectionEnvironment env) Set additional env vars for the jmx https connector, provided by the client.
ProgressObject	start(TargetModuleID[] moduleIDList) Start the application running.
ProgressObject	stop(TargetModuleID[] moduleIDList) Stop the application running.
ProgressObject	undeploy(TargetModuleID[] moduleIDList) Remove the application from the target server.

Methods inherited from class java.lang.Object

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

Constructor Detail

SunDeploymentManager

public SunDeploymentManager()

Creates a new instance of DeploymentManager

SunDeploymentManager

public SunDeploymentManager(ServerConnectionIdentifier sci)

Creates a new instance of DeploymentManager

Method Detail

setServerConnectionEnvironment

public void setServerConnectionEnvironment(ServerConnectionEnvironment env)

Set additional env vars for the jmx https connector, provided by the client. This method is expected to be called right after the client retrieves the DeploymentManager, before the client makes any calls on the DM that requires MBean Server connection.

getTargets

public Target[] getTargets()
                    throws IllegalStateException

Retrieve the list of deployment targets supported by this DeploymentManager.

Specified by:

getTargets in interface DeploymentManager

Returns:

A list of deployment Target designators the user may select for application deployment or 'null' if there are none.

Throws:

IllegalStateException - is thrown when there is a problem getting Connection Source

getRunningModules

public TargetModuleID[] getRunningModules(ModuleType moduleType,
                                          Target[] targetList)
                                   throws TargetException,
                                          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 DeploymentManager

Parameters:

moduleType - A predefined designator for a J2EE module type.

targetList - A list of deployment Target designators the user wants checked for module run status.

Returns:

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

Throws:

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

TargetException - An invalid Target designator encountered.

getNonRunningModules

public TargetModuleID[] getNonRunningModules(ModuleType moduleType,
                                             Target[] targetList)
                                      throws TargetException,
                                             IllegalStateException

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

Specified by:

getNonRunningModules in interface DeploymentManager

Parameters:

moduleType - A predefined designator for a J2EE module type.

targetList - A list of deployment Target designators the user wants checked for module not running status.

Returns:

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

Throws:

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

TargetException - An invalid Target designator encountered.

getAvailableModules

public TargetModuleID[] getAvailableModules(ModuleType moduleType,
                                            Target[] targetList)
                                     throws TargetException,
                                            IllegalStateException

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

Specified by:

getAvailableModules in interface DeploymentManager

Parameters:

moduleType - A predefined designator for a J2EE module type.

targetList - A list of deployment Target designators the user wants checked for module not running status.

Returns:

An array of TargetModuleID objects representing all deployed modules running or not or 'null' if there are no deployed modules.

Throws:

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

TargetException - An invalid Target designator encountered.

createConfiguration

public DeploymentConfiguration createConfiguration(DeployableObject dObj)
                                            throws InvalidModuleException

Retrieve the object that provides server-specific deployment configuration information for the J2EE deployable component.

Specified by:

createConfiguration in interface DeploymentManager

Parameters:

dObj - An object representing a J2EE deployable component.

Throws:

InvalidModuleException - The DeployableObject is an unknown or unsupport component for this configuration tool.

distribute

public ProgressObject distribute(Target[] targetList,
                                 File moduleArchive,
                                 File deploymentPlan)
                          throws 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 DeploymentManager

Parameters:

targetList - A list of server targets the user is specifying this application be deployed to.

moduleArchive - The file name of the application archive to be disrtibuted.

deploymentPlan - The XML file containing the runtime configuration information associated with this application archive.

Returns:

ProgressObject an object that tracks and reports the status of the distribution process.

Throws:

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

distribute

public ProgressObject distribute(Target[] targetList,
                                 InputStream moduleArchive,
                                 InputStream deploymentPlan)
                          throws 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 DeploymentManager

Parameters:

targetList - A list of server targets the user is specifying this application be deployed to.

moduleArchive - The input stream containing the application archive to be disrtibuted.

deploymentPlan - The input stream containing the deployment configuration information associated with this application archive.

Returns:

ProgressObject an object that tracks and reports the status of the distribution process.

Throws:

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

distribute

public ProgressObject distribute(Target[] targetList,
                                 ModuleType type,
                                 InputStream moduleArchive,
                                 InputStream deploymentPlan)
                          throws 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 DeploymentManager

Parameters:

targetList - A list of server targets the user is specifying this application be deployed to.

moduleType - The module type of this application archive.

moduleArchive - The input stream containing the application archive to be disrtibuted.

deploymentPlan - The input stream containing the deployment configuration information associated with this application archive.

Returns:

ProgressObject an object that tracks and reports the status of the distribution process.

Throws:

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

start

public ProgressObject start(TargetModuleID[] moduleIDList)
                     throws IllegalStateException

Start the application running.

Only the TargetModuleIDs which represent a root module are valid for being started. A root TargetModuleID has no parent. A TargetModuleID with a parent can not be individually started. A root TargetModuleID module and all its child modules will be started.

Specified by:

start in interface DeploymentManager

Parameters:

moduleIDList - A array of TargetModuleID objects representing the modules to be started.

Returns:

ProgressObject an object that tracks and reports the status of the start operation.

Throws:

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

stop

public ProgressObject stop(TargetModuleID[] moduleIDList)
                    throws IllegalStateException

Stop the application running.

Only the TargetModuleIDs which represent a root module are valid for being stopped. A root TargetModuleID has no parent. A TargetModuleID with a parent can not be individually stopped. A root TargetModuleID module and all its child modules will be stopped.

Specified by:

stop in interface DeploymentManager

Parameters:

moduleIDList - A array of TargetModuleID objects representing the modules to be stopped.

Returns:

ProgressObject an object that tracks and reports the status of the stop operation.

Throws:

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

undeploy

public ProgressObject undeploy(TargetModuleID[] moduleIDList)
                        throws 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 DeploymentManager

Parameters:

moduleIDList - An array of TargetModuleID objects representing the root modules to be stopped.

Returns:

ProgressObject an object that tracks and reports the status of the stop operation.

Throws:

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

isRedeploySupported

public boolean isRedeploySupported()

This method designates whether this platform vendor provides application redeployment functionality. A value of true means it is supported. False means it is not.

Specified by:

isRedeploySupported in interface DeploymentManager

Returns:

A value of true means redeployment is supported by this vendor's DeploymentManager. False means it is not.

redeploy

public ProgressObject redeploy(TargetModuleID[] moduleIDList,
                               File moduleArchive,
                               File deploymentPlan)
                        throws UnsupportedOperationException,
                               IllegalStateException

(optional) The redeploy method provides a means for updating currently deployed J2EE applications. This is an optional method for vendor implementation. Redeploy replaces a currently deployed application with an updated version. The runtime configuration information for the updated application must remain identical to the application it is updating. When an application update is redeployed, all existing client connections to the original running application must not be disrupted; new clients will connect to the application update. This operation is valid for TargetModuleIDs that represent a root module. A root TargetModuleID has no parent. A root TargetModuleID module and all its child modules will be redeployed. A child TargetModuleID module cannot be individually redeployed. The redeploy operation is complete only when this action for all the modules has completed.

Specified by:

redeploy in interface DeploymentManager

Parameters:

moduleIDList - An array of designators of the applications to be updated.

moduleArchive - The file name of the application archive to be disrtibuted.

deploymentPlan - The deployment configuration information associated with this application archive.

Returns:

ProgressObject an object that tracks and reports the status of the redeploy operation.

Throws:

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

UnsupportedOperationException - this optional command is not supported by this implementation.

redeploy

public ProgressObject redeploy(TargetModuleID[] moduleIDList,
                               InputStream moduleArchive,
                               InputStream deploymentPlan)
                        throws UnsupportedOperationException,
                               IllegalStateException

(optional) The redeploy method provides a means for updating currently deployed J2EE applications. This is an optional method for vendor implementation. Redeploy replaces a currently deployed application with an updated version. The runtime configuration information for the updated application must remain identical to the application it is updating. When an application update is redeployed, all existing client connections to the original running application must not be disrupted; new clients will connect to the application update. This operation is valid for TargetModuleIDs that represent a root module. A root TargetModuleID has no parent. A root TargetModuleID module and all its child modules will be redeployed. A child TargetModuleID module cannot be individually redeployed. The redeploy operation is complete only when this action for all the modules has completed.

Specified by:

redeploy in interface DeploymentManager

Parameters:

moduleIDList - An array of designators of the applications to be updated.

moduleArchive - The input stream containing the application archive to be disrtibuted.

deploymentPlan - The input stream containing the runtime configuration information associated with this application archive.

Returns:

ProgressObject an object that tracks and reports the status of the redeploy operation.

Throws:

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

UnsupportedOperationException - this optional command is not supported by this implementation.

release

public void release()

The release method is the mechanism by which the tool signals to the DeploymentManager that the tool does not need it to continue running connected to the platform. The tool may be signaling it wants to run in a disconnected mode or it is planning to shutdown. When release is called the DeploymentManager may close any J2EE resource connections it had for deployment configuration and perform other related resource cleanup. It should not accept any new operation requests (i.e., distribute, start stop, undeploy, redeploy. It should finish any operations that are currently in process. Each ProgressObject associated with a running operation should be marked as released (see the ProgressObject).

Specified by:

release in interface DeploymentManager

getDefaultLocale

public Locale getDefaultLocale()

Returns the default locale supported by this implementation of javax.enterprise.deploy.spi subpackages.

Specified by:

getDefaultLocale in interface DeploymentManager

Returns:

Locale the default locale for this implementation.

getCurrentLocale

public Locale getCurrentLocale()

Returns the active locale this implementation of javax.enterprise.deploy.spi subpackages is running.

Specified by:

getCurrentLocale in interface DeploymentManager

Returns:

Locale the active locale of this implementation.

setLocale

public void setLocale(Locale locale)
               throws UnsupportedOperationException

Set the active locale for this implementation of javax.enterprise.deploy.spi subpackages to run.

Specified by:

setLocale in interface DeploymentManager

Throws:

UnsupportedOperationException - the provide locale is not supported.

getSupportedLocales

public Locale[] getSupportedLocales()

Returns an array of supported locales for this implementation.

Specified by:

getSupportedLocales in interface DeploymentManager

Returns:

Locale[] the list of supported locales.

isLocaleSupported

public boolean isLocaleSupported(Locale locale)

Reports if this implementation supports the designated locale.

Specified by:

isLocaleSupported in interface DeploymentManager

Returns:

A value of 'true' means it is support and 'false' it is not.

getDConfigBeanVersion

public DConfigBeanVersionType getDConfigBeanVersion()

Returns the J2EE platform version number for which the configuration beans are provided. The beans must have been compiled with the J2SE version required by the J2EE platform.

Specified by:

getDConfigBeanVersion in interface DeploymentManager

Returns:

a DConfigBeanVersionType object representing the platform version number for which these beans are provided.

isDConfigBeanVersionSupported

public boolean isDConfigBeanVersionSupported(DConfigBeanVersionType version)

Returns 'true' if the configuration beans support the J2EE platform version specified. It returns 'false' if the version is not supported.

Specified by:

isDConfigBeanVersionSupported in interface DeploymentManager

Parameters:

version - a DConfigBeanVersionType object representing the J2EE platform version for which support is requested.

Returns:

'true' if the version is supported and 'false if not.

setDConfigBeanVersion

public void setDConfigBeanVersion(DConfigBeanVersionType version)
                           throws DConfigBeanVersionUnsupportedException

Set the configuration beans to be used to the J2EE platform version specificed.

Specified by:

setDConfigBeanVersion in interface DeploymentManager

Parameters:

version - a DConfigBeanVersionType object representing the J2EE platform version for which support is requested.

Throws:

DConfigBeanVersionUnsupportedException - when the requested bean version is not supported.

getProperties

protected Properties getProperties()

distribute

public ProgressObject distribute(Target[] targetList,
                                 Archive moduleArchive,
                                 Archive deploymentPlan,
                                 Object deploymentOptions)
                          throws 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.

Parameters:

targetList - A list of server targets the user is specifying this application be deployed to.

moduleArchive - The abstraction for the application archive to be disrtibuted.

deploymentPlan - The archive containing the deployment configuration information associated with this application archive.

deploymentOptions - is a JavaBeans compliant component containing all deployment options for this deployable unit. This object must be created using the BeanInfo instance returned by DeploymentConfiguration.getDeploymentOptions

Returns:

ProgressObject an object that tracks and reports the status of the distribution process.

Throws:

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

getArchive

public Archive getArchive(URI path,
                          String name)
                   throws IOException

Creates a new instance of Archive which can be used to store application elements in a layout that can be directly used by the application server. Implementation of this method should carefully return the appropriate implementation of the interface that suits the server needs and provide the fastest deployment time. An archive may already exist at the location and elements may be read but not changed or added depending on the underlying medium.

Parameters:

path - the directory in which to create this archive if local storage is a possibility.

name - is the desired name for the archive

Returns:

the writable archive instance

Throws:

IOException