com.ibm.websphere.ant.tasks
Class ServiceDeployTask
- java.lang.Object
Task
com.ibm.websphere.ant.tasks.ServiceDeployTask
- public final class ServiceDeployTask
- extends Task
The wasHome attribute is optional if WAS_HOME/bin/ws_ant is used to run ANT. It is required if ws_ant is not used to run ANT. This attribute is the location of a WebSphere Process Server installation that provides the serviceDeploy capabilities.
The workingDirectory attribute is optional and controls where the directory in which serviceDeploy will generate a temporary workspace.
The outputApplication attribute is optional and controls the name and location of the generated J2EE ear file. If this attribute is not specified, then the ear file will be named according to the sca module name and will be generated in the location from which the ANT process was launched.
The freeForm attribute is optional and controls whether jsp and html files will be copied from the optional j2ee folder of an sca jar file and copied to the generated war file. By default, jsp and html files are not copied into the war file.
The cleanStagingModules attribute is optional and controls whether imported staging modules should be deleted before running the deployer. By default, imported staging modules are not deleted.
The keep attribute is optional and controls whether the generated workspace should be preserved when the deployer task is complete. By default, the generated workspace is deleted after deployment.
The ignoreErrors attribute is optional and controls whether an ear file should be generated despite validation errors. By default, an ear file will not be generated if validation errors were flagged during deployment.
The classPath attribute is optional and controls which external archives (jar, rar, and zip) should be appended to the classpath. By default, no external archives are used during deployment.
The libraryMode attribute is optional and controls whether serviceDeploy allows a stand-alone library as input.
The uniqueCellID attribute is optional and may be used to create a unique instance of the application.
The vmArgs attribute is optional and may be used to specify jvm arguments for the deploy process.
The debug attribute is optional and may be used to specify a trace .options file to enable tracing.
The noValidate attribute is optional and may be used to specify whether validation should be skipped.
The clean attribute attribute is optional and is passed to eclipse so that eclipse will regenerate its stored plugin configuration.
To use this task, add the following to your ANT build.xml
Copyright IBM Corp. 2011
Field Summary
Modifier and Type | Field and Description |
---|---|
|
excluded_props
The jvm launched by the serviceDeploy task is initialized with the ANT process's system properties except for those
properties listed in the
excluded_props field:java.assistive ,
java.runtime.name ,
sun.boot.library.path ,
java.vm.version ,
java.vm.vendor ,
java.vendor.url ,
path.separator ,
java.vm.name ,
user.country ,
sun.os.patch.level ,
java.vm.specification.name ,
user.dir ,
java.runtime.version ,
java.fullversion ,
java.awt.graphicsenv ,
java.endorsed.dirs ,
os.arch ,
com.ibm.vm.bitmode ,
java.io.tmpdir ,
line.separator ,
java.vm.specification.vendor ,
user.variant ,
java.awt.fonts ,
os.name ,
sun.java2d.fontpath ,
java.library.path ,
java.specification.name ,
java.class.version ,
invokedviajava ,
java.util.prefs.PreferencesFactory ,
os.version ,
user.home ,
user.timezone ,
java.awt.printerjob ,
java.specification.version ,
java.class.path ,
user.name ,
java.vm.specification.version ,
java.home ,
sun.arch.data.model ,
user.language ,
java.specification.vendor ,
awt.toolkit ,
java.vm.info ,
java.version ,
sun.boot.class.path ,
java.vendor ,
file.separator ,
java.vendor.url.bug ,
java.compiler ,
java.util.logging.configureByServer ,
java.util.logging.manager
Any jvm properties may explicitly be passed by the setVMArgs method.
|
Constructor Summary
Constructor and Description |
---|
ServiceDeployTask()
|
Method Summary
Modifier and Type | Method and Description |
---|---|
|
execute()
This launches the serviceDeploy application in a child jvm, configured according to the user-specified attributes.
|
|
setClassPath(java.lang.String classPath)
The classPath attribute is optional and is used to specify additional archives (jar, rar, or zip) that must be added to the classpath to successfully generate the
J2EE application.
|
|
setClean(boolean clean)
The clean attribute is optional and is passed to eclipse so that eclipse will regenerate its plugin configuration.
|
|
setCleanStagingModules(boolean cleanStagingModules)
The cleanStagingModules attribute is optional and controls whether imported staging modules should be deleted before running the deployer.
|
|
setDebug(java.lang.String debug)
The debug attribute is optional and may be used to specify a .options file to enable tracing .
|
|
setFileEncoding(java.lang.String fileEncoding)
Deprecated. set the -Dfile.encoding jvm parameter instead
|
|
setFreeForm(boolean freeForm)
The freeForm attribute is optional and controls whether jsp and html files will be copied from the optional j2ee folder of an sca jar file and copied to the generated
war file.
|
|
setIgnoreErrors(boolean ignoreErrors)
The ignoreErrors attribute is optional and indicates whether an ear file should be exported despite compile or validation errors.
|
|
setInternalOptions(java.lang.String internalOptions)
|
|
setJavaDebug(java.lang.String javaDebug)
Deprecated. no longer applicable
|
|
setKeep(boolean keep)
The keep attribute is optional and controls whether the generated workspace should be preserved when the deployer task is complete.
|
|
setLibraryMode(boolean libraryMode)
The libraryMode attribute is optional and controls whether serviceDeploy allows a stand-alone library as input.
|
|
setNoJ2EEDeploy(boolean noJ2EEDeploy)
Deprecated. no longer applicable
|
|
setNoJavaSource(boolean noJavaSource)
Deprecated. no longer applicable
|
|
setNoValidate(boolean noValidate)
The noValidate attribute is optional and may be used to specify whether validation should be skipped.
|
|
setOutputApplication(java.lang.String outputApplication)
The outputApplication attribute is optional and controls the path and name of the generated ear file.
|
|
setProgressMonitor(java.lang.String progressMonitor)
Deprecated. no longer applicable
|
|
setScaModule(java.lang.String scaModule)
The scaModule attribute is mandatory and is the only required attribute for the serviceDeploy task.
|
|
setSkipXsdValidate(boolean skipXsdValidate)
The skipXsdValidate attribute is optional and may be used to specify whether XSD and WSDL validation should be skipped.
|
|
setUniqueCellID(java.lang.String uniqueCellID)
The uniqueCellID attribute is optional and may be used to create a unique instance of the application.
|
|
setVmArgs(java.lang.String vmArgs)
The vmArgs attribute is optional and may be used to specify jvm arguments for the deploy process.
|
|
setWasHome(java.lang.String home)
The wasHome attribute is optional if WAS_HOME/bin/ws_ant is used to run ANT.
|
|
setWorkingDirectory(java.lang.String workingDirectory)
The workingDirectory attribute is optional and controls where the directory in which serviceDeploy will generate a temporary workspace.
|
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail
excluded_props
- public static final java.lang.String[] excluded_props
See Also:
Constructor Detail
ServiceDeployTask
- public ServiceDeployTask()
Method Detail
execute
- public void execute()
- throws BuildException
This launches the serviceDeploy application in a child jvm, configured according to the user-specified attributes.
Throws:
BuildException
See Also:
org.apache.tools.ant.Task#execute()
setScaModule
- public void setScaModule(java.lang.String scaModule)
The scaModule attribute is mandatory and is the only required attribute for the serviceDeploy task. This module may be in the project interchange format exported from
the WebSphere Integration Developer or it may be a jar file that contains at least the sca.module file plus any other supporting resources.
Parameters:
scaModule
- The scaModule to set. setClassPath
- public void setClassPath(java.lang.String classPath)
The classPath attribute is optional and is used to specify additional archives (jar, rar, or zip) that must be added to the classpath to successfully generate the
J2EE application.
Parameters:
classPath
- A semi-colon delimited list of jar, rar, and zip files that are required on the deploy classpath setFreeForm
- public void setFreeForm(boolean freeForm)
The freeForm attribute is optional and controls whether jsp and html files will be copied from the optional j2ee folder of an sca jar file and copied to the generated
war file. By default, jsp and html files are not copied into the war file. This attribute should not be used when deploying project interchange files, in which case
user-provided jsp and html files should be located in user-developed web projects.
Parameters:
freeForm
- A boolean indicating whether the temporary workspace should be preserved. setIgnoreErrors
- public void setIgnoreErrors(boolean ignoreErrors)
The ignoreErrors attribute is optional and indicates whether an ear file should be exported despite compile or validation errors. By default, an ear file will not be
generated if compile or validation errors were encountered during deploy.
Parameters:
ignoreErrors
- A boolean indicating whether an ear file should be generated despite reported compilation or validation errors. setCleanStagingModules
- public void setCleanStagingModules( boolean cleanStagingModules)
The cleanStagingModules attribute is optional and controls whether imported staging modules should be deleted before running the deployer. By default, imported
staging modules are not deleted. For an sca module named X, the staging modules will be named XApp, XEJB, XEJBClient, and XWeb.
Parameters:
cleanStagingModules
- A boolean indicating whether the staging modules should be deleting and regenerated during deployment. setKeep
- public void setKeep(boolean keep)
The keep attribute is optional and controls whether the generated workspace should be preserved when the deployer task is complete. By default, the generated
workspace is deleted after deployment. This option can be useful when troubleshooting unexpected problems that might be encountered during deployment.
Parameters:
keep
- A boolean indicating whether the temporary workspace should be retained following deployment. setNoJ2EEDeploy
- public void setNoJ2EEDeploy(boolean noJ2EEDeploy)
Deprecated. no longer applicable
Parameters:
noJ2EEDeploy
- setNoJavaSource
- public void setNoJavaSource(boolean noJavaSource)
Deprecated. no longer applicable
Parameters:
noJavaSource
- setOutputApplication
- public void setOutputApplication( java.lang.String outputApplication)
The outputApplication attribute is optional and controls the path and name of the generated ear file. If the outputApplication attribute is not specified, then an ear
file named XApp.ear will be generated in the directory from which ANT was launched for an SCA module named X.
Parameters:
outputApplication
- The fully-qualified path for the generated application. setProgressMonitor
- public void setProgressMonitor( java.lang.String progressMonitor)
Deprecated. no longer applicable
Parameters:
progressMonitor
- setUniqueCellID
- public void setUniqueCellID(java.lang.String uniqueCellID)
The uniqueCellID attribute is optional and may be used to create a unique instance of the application.
Parameters:
uniqueCellID
- Unique ID in the context of the cell that is used to create a unique instance of the application. setWorkingDirectory
- public void setWorkingDirectory( java.lang.String workingDirectory)
The workingDirectory attribute is optional and controls where the directory in which serviceDeploy will generate a temporary workspace. By default, the temporary
workspace will be generated in the current project's directory. The name of the temporary workspace will be the system time in milliseconds expressed in hexadecimal; for
example, 10eab458774.
Parameters:
workingDirectory
- The location at which the temporary workspace should be generated. setFileEncoding
- public void setFileEncoding(java.lang.String fileEncoding)
Deprecated. set the -Dfile.encoding jvm parameter instead
Parameters:
fileEncoding
- setDebug
- public void setDebug(java.lang.String debug)
The debug attribute is optional and may be used to specify a .options file to enable tracing .
Parameters:
debug
- The file that contains trace enablement settings. setJavaDebug
- public void setJavaDebug(java.lang.String javaDebug)
Deprecated. no longer applicable
setClean
- public void setClean(boolean clean)
The clean attribute is optional and is passed to eclipse so that eclipse will regenerate its plugin configuration. This attribute should generally not be required
unless a patch was made to a plugin under ${WAS_HOME}/plugins.
Parameters:
clean
- A boolean indicating whether the eclipse plugin configuration should be recalculated. setSkipXsdValidate
- public void setSkipXsdValidate( boolean skipXsdValidate)
The skipXsdValidate attribute is optional and may be used to specify whether XSD and WSDL validation should be skipped.
Parameters:
skipXsdValidate
- setNoValidate
- public void setNoValidate(boolean noValidate)
The noValidate attribute is optional and may be used to specify whether validation should be skipped.
Parameters:
noValidate
- A boolean indicating whether validation should be skipped. setLibraryMode
- public void setLibraryMode(boolean libraryMode)
The libraryMode attribute is optional and controls whether serviceDeploy allows a stand-alone library as input.
setVmArgs
- public void setVmArgs(java.lang.String vmArgs)
The vmArgs attribute is optional and may be used to specify jvm arguments for the deploy process. The child jvm will inherit the system properties of the ANT jvm
except for those specified in the excluded_props field. Inherited properties may be overridden and new properties may be defined by the vmArgs attribute. For example,
setVmArgs("-Xms128m -Dsome.property=true");
Parameters:
vmArgs
- A space-delimited list of java properties. setInternalOptions
- public void setInternalOptions( java.lang.String internalOptions)
setWasHome
- public void setWasHome(java.lang.String home)
The wasHome attribute is optional if WAS_HOME/bin/ws_ant is used to run ANT. It is required if ws_ant is not used to run ANT. This attribute specifies the location of
a WebSphere Process Server installation that provides the serviceDeploy capabilities. If the wasHome property is not explicitly set, then the location of the WebSphere
Process Server will be calculated by the following system properties, in order:
- was.install.root
- was.root
- was.home
Parameters:
home
- The location of the WebSphere Process Server used to run this deploy task.
excluded_props
field:Any jvm properties may explicitly be passed by the setVMArgs method.