Oracle Fusion Middleware
Oracle WebLogic Server API Reference
11g Release 1 (10.3.4)

Part Number E13941-04

weblogic.management.deploy
Class DeploymentData

java.lang.Object
  extended by weblogic.management.deploy.DeploymentData
All Implemented Interfaces:
Serializable

Deprecated. since WLS 9.0 . Use WebLogicDeploymentManager

public class DeploymentData
extends Object
implements Serializable

Describes the targets involved in an application deployment and other deployment options. DeploymentData objects are used when invoking deployments via the DeployerRuntimeMBean methods.

See Also:
Serialized Form

Field Summary
static int CLUSTER
          Deprecated. Target is a Cluster
static int JMSSERVER
          Deprecated. Target is a JMS Server
static int SAFAGENT
          Deprecated. Target is a SAF agent
static int SERVER
          Deprecated. Target is a Server
static String STANDALONE_MODULE
          Deprecated.  
static int UNKNOWN
          Deprecated. Target type is unknown either because it has not been set or is not available.
static int VIRTUALHOST
          Deprecated. Target is a Virtual Host
 
Constructor Summary
DeploymentData()
          Deprecated. Creates empty DeploymentData object, one with no targets defined and no file list.
DeploymentData(String[] files)
          Deprecated. Creates DeploymentData object, with no targets defined and a file list.
 
Method Summary
 void addGlobalTarget(String targetName)
          Deprecated.  
 void addModuleTarget(String moduleName, String newtarget)
          Deprecated.  
 void addModuleTargets(String moduleName, String[] newtargets)
          Deprecated.  
 void addModuleToTarget(String target, String module)
          Deprecated. Since 9.0. Use DeploymentData.addModuleTargets(java.lang.String, java.lang.String[])
 void addOrUpdateSubModuleTargets(Map givenSMTs)
          Deprecated.  
 void addOrUpdateSubModuleTargetsFor(String moduleName, Map submodules)
          Deprecated.  
 void addSubModuleTarget(String moduleName, String subModuleName, String[] newtargets)
          Deprecated. Adds a target list specific to a submodule in a given module.
 void addTarget(String target, String[] modules)
          Deprecated. Since 9.0. Use DeploymentData.addTarget(java.lang.String, java.lang.String[]), DeploymentData.setGlobalTargets(java.lang.String[]) or DeploymentData.addModuleTargets(java.lang.String, java.lang.String[])
 void addTargetsForComponent(weblogic.management.configuration.ApplicationMBean mbean, String compName)
          Deprecated. Since 9.0. Use DeploymentData.addModuleTargets(java.lang.String, java.lang.String[])
 void addTargetsFromConfig(weblogic.management.configuration.BasicDeploymentMBean dmb)
          Deprecated. Adds targets to this object based on contents of the config bean.
 Map getAllModuleTargets()
          Deprecated.  
 Map getAllSubModuleTargets()
          Deprecated.  
 Set getAllTargetedServers(Set logicalTargets, weblogic.management.configuration.DomainMBean editDomain)
          Deprecated.  
 String getAltDescriptorPath()
          Deprecated.  
 String getAltWLSDescriptorPath()
          Deprecated.  
 boolean getClusterConstraints()
          Deprecated.  
 String getConfigDirectory()
          Deprecated.  
 boolean getDelete()
          Deprecated.  
 DeploymentOptions getDeploymentOptions()
          Deprecated.  
 String getDeploymentPlan()
          Deprecated.  
 String getDeploymentPrincipalName()
          Deprecated.  
 String[] getFiles()
          Deprecated. Returns the files specific to this deployment
 String[] getGlobalTargets()
          Deprecated. Returns a list of targets which apply to the whole deployable unit.
 String[] getModules()
          Deprecated. Since 9.0.
 String[] getModulesForTarget(String target)
          Deprecated. Since 9.0
 String[] getModuleTargets(String moduleName)
          Deprecated. Returns module specific targets for a given module.
 String getRootDirectory()
          Deprecated.  
 String getSecurityModel()
          Deprecated.  
 Map getSubModuleTargets(String moduleName)
          Deprecated.  
 String[] getTargets()
          Deprecated. since 9.0 use DeploymentData.getGlobalTargets() , #getModuleTargets or {@link #getSubModuleTargets}
 Set getTargetsForModule(String module)
          Deprecated. Since 9.0.
 int getTargetType(String target)
          Deprecated. Specifies the type of target involved.
 int getTimeOut()
          Deprecated. Timeout value (in milliseconds) used for 2 phase deployments.
 boolean hasFiles()
          Deprecated.  
 boolean hasGlobalTarget(String targetname)
          Deprecated.  
 boolean hasModuleTargets()
          Deprecated.  
 boolean hasSubModuleTargets()
          Deprecated.  
 boolean hasTargets()
          Deprecated.  
 boolean isLibrary()
          Deprecated.  
 boolean isSecurityValidationEnabled()
          Deprecated.  
 boolean isStandaloneModule()
          Deprecated.  
 boolean removeSubModuleTarget(String mod, String sub, String target)
          Deprecated.  
 void setAltDescriptorPath(String dd)
          Deprecated.  
 void setAltWLSDescriptorPath(String dd)
          Deprecated.  
 void setClusterConstraints(boolean clusterConstraints)
          Deprecated. Sets the attribute indicating if strict cluster constraints need to be enforced on clustered deployments.
 void setConfigDirectory(String config)
          Deprecated.  
 void setDelete(boolean deleteFlag)
          Deprecated.  
 void setDeploymentOptions(DeploymentOptions opts)
          Deprecated.  
 void setDeploymentPlan(String plan)
          Deprecated.  
 void setDeploymentPrincipalName(String principal)
          Deprecated.  
 void setFile(String[] files)
          Deprecated. Indicates whether to add or remove files from the application's staging area.
 void setGlobalTargets(String[] targetNames)
          Deprecated.  
 void setLibrary(boolean isLibrary)
          Deprecated.  
 void setPlanUpdate(boolean b)
          Deprecated.  
 void setRootDirectory(String dir)
          Deprecated.  
 void setSecurityModel(String model)
          Deprecated.  
 void setSecurityValidationEnabled(boolean enable)
          Deprecated.  
 void setTargetType(String target, int type)
          Deprecated. Specifies the type of target involved.
 void setTimeOut(int timeInMillis)
          Deprecated. Overrides deployment timeout value.
 String toString()
          Deprecated. Constructs a String representation of the object.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

UNKNOWN

public static final int UNKNOWN
Deprecated. 
Target type is unknown either because it has not been set or is not available.

See Also:
Constant Field Values

CLUSTER

public static final int CLUSTER
Deprecated. 
Target is a Cluster

See Also:
Constant Field Values

SERVER

public static final int SERVER
Deprecated. 
Target is a Server

See Also:
Constant Field Values

VIRTUALHOST

public static final int VIRTUALHOST
Deprecated. 
Target is a Virtual Host

See Also:
Constant Field Values

JMSSERVER

public static final int JMSSERVER
Deprecated. 
Target is a JMS Server

See Also:
Constant Field Values

SAFAGENT

public static final int SAFAGENT
Deprecated. 
Target is a SAF agent

See Also:
Constant Field Values

STANDALONE_MODULE

public static final String STANDALONE_MODULE
Deprecated. 
See Also:
Constant Field Values
Constructor Detail

DeploymentData

public DeploymentData()
Deprecated. 
Creates empty DeploymentData object, one with no targets defined and no file list.


DeploymentData

public DeploymentData(String[] files)
Deprecated. 
Creates DeploymentData object, with no targets defined and a file list.

Parameters:
files - is a list of file names to be deployed. This defines a partial deployment, one where individual files are distributed instead of entire applications. This is only valid for redeployments. The files in the list are relative to the root of the application. This argument may be null.
Method Detail

setPlanUpdate

public void setPlanUpdate(boolean b)
Deprecated. 

hasTargets

public boolean hasTargets()
Deprecated. 

getGlobalTargets

public String[] getGlobalTargets()
Deprecated. 
Returns a list of targets which apply to the whole deployable unit.


hasGlobalTarget

public boolean hasGlobalTarget(String targetname)
Deprecated. 

addGlobalTarget

public void addGlobalTarget(String targetName)
Deprecated. 

setGlobalTargets

public void setGlobalTargets(String[] targetNames)
Deprecated. 

getAllModuleTargets

public Map getAllModuleTargets()
Deprecated. 
Returns:
a Map. Key = module name. Value = String[] of target names.

hasModuleTargets

public boolean hasModuleTargets()
Deprecated. 

getModuleTargets

public String[] getModuleTargets(String moduleName)
Deprecated. 
Returns module specific targets for a given module.


addModuleTarget

public void addModuleTarget(String moduleName,
                            String newtarget)
Deprecated. 

addModuleTargets

public void addModuleTargets(String moduleName,
                             String[] newtargets)
Deprecated. 

isStandaloneModule

public boolean isStandaloneModule()
Deprecated. 

addSubModuleTarget

public void addSubModuleTarget(String moduleName,
                               String subModuleName,
                               String[] newtargets)
                        throws IllegalArgumentException
Deprecated. 
Adds a target list specific to a submodule in a given module.

Parameters:
subModuleName - Required. Must be non-null.
moduleName - If this is null, it is assumed that there is only one module in this deployable unit, the deployable unit itself. And all submodules are part of it. Hence, either all submoduletargets should have a module name or none.
Throws:
IllegalArgumentException - When target list is empty or module names are specified in some targets and nto in others.

addOrUpdateSubModuleTargetsFor

public void addOrUpdateSubModuleTargetsFor(String moduleName,
                                           Map submodules)
Deprecated. 

addOrUpdateSubModuleTargets

public void addOrUpdateSubModuleTargets(Map givenSMTs)
Deprecated. 

getAllTargetedServers

public Set getAllTargetedServers(Set logicalTargets,
                                 weblogic.management.configuration.DomainMBean editDomain)
                          throws weblogic.deploy.beans.factory.InvalidTargetException
Deprecated. 
Throws:
weblogic.deploy.beans.factory.InvalidTargetException

getSubModuleTargets

public Map getSubModuleTargets(String moduleName)
Deprecated. 
Returns:
instance of Map where Key = submodule name & Value = String[] containing target names.

getAllSubModuleTargets

public Map getAllSubModuleTargets()
Deprecated. 
Returns:
key = modulename, val = submoduletarget map. For submoduletargetmap: key = submodulename, value= String[] targetNames

hasSubModuleTargets

public boolean hasSubModuleTargets()
Deprecated. 

addTargetsFromConfig

public void addTargetsFromConfig(weblogic.management.configuration.BasicDeploymentMBean dmb)
Deprecated. 
Adds targets to this object based on contents of the config bean. This is useful for redeploy, undeploy bcos the default target set used in these is the current configuration. REVIEW schopra April-04 -- Eventually we should get rid of this bcos there should be no need to duplicate this data over to DeploymentData. The deployment code should just work off the bean or its copy.

Parameters:
dmb -

getSecurityModel

public String getSecurityModel()
Deprecated. 

setSecurityModel

public void setSecurityModel(String model)
                      throws IllegalArgumentException
Deprecated. 
Throws:
IllegalArgumentException

isSecurityValidationEnabled

public boolean isSecurityValidationEnabled()
Deprecated. 

setSecurityValidationEnabled

public void setSecurityValidationEnabled(boolean enable)
Deprecated. 

isLibrary

public boolean isLibrary()
Deprecated. 

setLibrary

public void setLibrary(boolean isLibrary)
Deprecated. 

setFile

public void setFile(String[] files)
Deprecated. 
Indicates whether to add or remove files from the application's staging area. This only applies when a file list is included.


setDelete

public void setDelete(boolean deleteFlag)
Deprecated. 

getDelete

public boolean getDelete()
Deprecated. 

setClusterConstraints

public void setClusterConstraints(boolean clusterConstraints)
Deprecated. 
Sets the attribute indicating if strict cluster constraints need to be enforced on clustered deployments. If this attribute is set to 'true', any cluster that may be a target of a deployment needs to have all its servers be running for the deployment to succeed. Setting the attribute to 'false' will result in the deployment being attempted only on the servers that are reachable at the time of deployment from the Admin server. Any servers that have been shut down or are temporarily partitioned from the Admin server will retrieve the deployment during server startup or shortly after the network partition is resolved.


getClusterConstraints

public boolean getClusterConstraints()
Deprecated. 

getTimeOut

public int getTimeOut()
Deprecated. 
Timeout value (in milliseconds) used for 2 phase deployments. This value defaults to ApplicationMBean.DEPLOYMENT_TIMEOUT, but can be overriden with DeploymentData.setTimeOut(int) method. Deployment tasks that remain running for more than this time are automatically cancelled, with their state becoming failed. For cluster deployments, this will result in a rollback of the entire deployment.


setTimeOut

public void setTimeOut(int timeInMillis)
Deprecated. 
Overrides deployment timeout value.

See Also:
DeploymentData.getTimeOut()

setAltDescriptorPath

public void setAltDescriptorPath(String dd)
Deprecated. 

getAltDescriptorPath

public String getAltDescriptorPath()
Deprecated. 

setAltWLSDescriptorPath

public void setAltWLSDescriptorPath(String dd)
Deprecated. 

getAltWLSDescriptorPath

public String getAltWLSDescriptorPath()
Deprecated. 

setDeploymentPrincipalName

public void setDeploymentPrincipalName(String principal)
Deprecated. 

getDeploymentPrincipalName

public String getDeploymentPrincipalName()
Deprecated. 

getFiles

public String[] getFiles()
Deprecated. 
Returns the files specific to this deployment


hasFiles

public boolean hasFiles()
Deprecated. 

getTargetType

public int getTargetType(String target)
Deprecated. 
Specifies the type of target involved. Can be a cluster, server, web server or virtual host

Parameters:
target - is the name of the target being checked.

setTargetType

public void setTargetType(String target,
                          int type)
Deprecated. 
Specifies the type of target involved. Can be a cluster, server, web server or virtual host

Parameters:
target - is the name of the target being updated.
type - the type of the target.

toString

public String toString()
Deprecated. 
Constructs a String representation of the object.

Overrides:
toString in class Object

getDeploymentPlan

public String getDeploymentPlan()
Deprecated. 

setDeploymentPlan

public void setDeploymentPlan(String plan)
Deprecated. 

getConfigDirectory

public String getConfigDirectory()
Deprecated. 

setConfigDirectory

public void setConfigDirectory(String config)
Deprecated. 

getRootDirectory

public String getRootDirectory()
Deprecated. 

setRootDirectory

public void setRootDirectory(String dir)
Deprecated. 

getDeploymentOptions

public DeploymentOptions getDeploymentOptions()
Deprecated. 

setDeploymentOptions

public void setDeploymentOptions(DeploymentOptions opts)
Deprecated. 

getTargets

public String[] getTargets()
Deprecated. since 9.0 use DeploymentData.getGlobalTargets() , #getModuleTargets or {@link #getSubModuleTargets}

Returns a list of targets (server, web server, virtual hosts and cluster names) An empty array indicates no targets, whereas a null return value implies all configured targets.


addTarget

public void addTarget(String target,
                      String[] modules)
Deprecated. Since 9.0. Use DeploymentData.addTarget(java.lang.String, java.lang.String[]), DeploymentData.setGlobalTargets(java.lang.String[]) or DeploymentData.addModuleTargets(java.lang.String, java.lang.String[])

Adds a target name to this object. The name must be the name of a server, cluster, web server or virtual host. Any number of targets may be added. Each target may be further qualified with module names via the modules parameter. If no modules are specified the deployment applies to all modules. e.g. for an activation, all modules in the application are deployed to the target. If modules are included, then the activation applies only to those modules for the specified target.

Modules may also be added using the DeploymentData.addModuleToTarget(java.lang.String, java.lang.String) method.

Parameters:
target - is the name of a server, cluster or virtual host. Virtual hosts are only valid for web deployments.
modules - is an optional list of module names which are specifically targeted to the named target. A null value indicates all modules. An empty array implies no modules.

getModulesForTarget

public String[] getModulesForTarget(String target)
Deprecated. Since 9.0

Returns list of modules for a particular target defined in this object. A null is returned if all modules configured in the associated application are to be involved in the deployment. An empty list implies that no modules are to be involved in the deployment to the target.


addModuleToTarget

public void addModuleToTarget(String target,
                              String module)
Deprecated. Since 9.0. Use DeploymentData.addModuleTargets(java.lang.String, java.lang.String[])

Adds a module name to an existing target in this object. The target name must already have been added to this object. If it is desired that all modules be involved in the deployment to the target, then there is no need to add module names as qualifiers to the target.

Parameters:
target - is the server, cluster, web server or virtual host to receive the module.
module - is the name of the module to be deployed to this target.

addTargetsForComponent

public void addTargetsForComponent(weblogic.management.configuration.ApplicationMBean mbean,
                                   String compName)
                            throws IllegalArgumentException
Deprecated. Since 9.0. Use DeploymentData.addModuleTargets(java.lang.String, java.lang.String[])

Convenience method. Adds all targets for compName in the application mbean to this DeploymentData as targets for the given component.

Parameters:
mbean - is the application mbean containing the component
compName - is the component whose targets will be added to this object
Throws:
IllegalArgumentException

getTargetsForModule

public Set getTargetsForModule(String module)
Deprecated. Since 9.0.

Returns list of target names associated with a specific module. Targets may be servers, clusters or virtual hosts. An empty list is returned if a module has no targets for this deployment. The Set object returned is capable of remove operations.


getModules

public String[] getModules()
Deprecated. Since 9.0.

Returns list of all modules, regardless of target. The list returned is based on what has been defined for this object and does not represent any configured state of an application.


removeSubModuleTarget

public boolean removeSubModuleTarget(String mod,
                                     String sub,
                                     String target)
Deprecated. 

Copyright 1996, 2010, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Oracle Fusion Middleware
Oracle WebLogic Server API Reference
11g Release 1 (10.3.4)

Part Number E13941-04