Class WeblogicDeploymentTool
- All Implemented Interfaces:
- EJBDeploymentTool
- Direct Known Subclasses:
- WeblogicTOPLinkDeploymentTool
- 
Field SummaryFieldsModifier and TypeFieldDescriptionprotected static final Stringprotected static final Stringprotected static final Stringprotected static final Stringprotected static final StringWebLogic 5.1 dtd locationprotected static final Stringprotected static final Stringprotected static final StringWebLogic 6.0 ejb 1.1 dtd locationprotected static final StringWebLogic 6.0 ejb 2.0 dtd locationprotected static final Stringstatic final StringEJB11 idstatic final StringEJB20 idstatic final StringWebLogic 5.1.0 idstatic final StringWebLogic 6.0.0 idstatic final StringWebLogic 7.0.0 idprotected static final Stringprotected static final StringFields inherited from class org.apache.tools.ant.taskdefs.optional.ejb.GenericDeploymentToolANALYZER_CLASS_FULL, ANALYZER_CLASS_SUPER, ANALYZER_FULL, ANALYZER_NONE, ANALYZER_SUPER, DEFAULT_ANALYZER, DEFAULT_BUFFER_SIZE, EJB_DD, JAR_COMPRESS_LEVEL, MANIFEST, META_DIR
- 
Constructor SummaryConstructors
- 
Method SummaryModifier and TypeMethodDescriptionvoidAdd a nested sysproperty element.protected voidaddVendorFiles(Hashtable<String, File> ejbFiles, String ddPrefix) Add any vendor specific files which should be included in the EJB Jar.Get the classpath to the WebLogic classpaths.protected ClassLoadergetClassLoaderFromJar(File classjar) Helper method invoked by isRebuildRequired to get a ClassLoader for a Jar File passed to it.Get the ejbc compiler class.Get the debug level.protected DescriptorHandlergetWeblogicDescriptorHandler(File srcDir) Get the WebLogic descriptor handler.protected booleanisRebuildRequired(File genericJarFile, File weblogicJarFile) Helper method to check to see if a WebLogic EJB 1.1 jar needs to be rebuilt using ejbc.protected voidregisterKnownDTDs(DescriptorHandler handler) Register the DTDs.voidAny optional extra arguments pass to the weblogic.ejbc tool.voidsetCompiler(String compiler) The compiler (switch-compiler) to use; optional.voidsetEjbcClass(String ejbcClass) Set the classname of the ejbc compiler; optional Normally ejbjar determines the appropriate class based on the DTD used for the EJB.voidDeprecated.voidsetJvmargs(String args) Set any additional arguments to pass to the WebLogic JVM; optional.voidsetJvmDebugLevel(Integer jvmDebugLevel) Sets the weblogic.StdoutSeverityLevel to use when running the JVM that executes ejbc; optional.voidsetKeepgenerated(String inValue) Controls whether WebLogic will keep the generated Java files used to build the class files added to the jar.voidsetKeepgeneric(boolean inValue) controls whether the generic file used as input to ejbc is retained; defaults to falsevoidsetNewCMP(boolean newCMP) If this is set to true, the new method for locating CMP descriptors will be used; optional, default false.voidsetNoEJBC(boolean noEJBC) Do not EJBC the jar after it has been put together; optional, default falsevoidsetOldCMP(boolean oldCMP) Set the value of the oldCMP scheme.voidsetOutputDir(File outputDir) If set ejbc will use this directory as the output destination rather than a jar file.voidsetRebuild(boolean rebuild) Set the rebuild flag to false to only update changes in the jar rather than rerunning ejbc; optional, default true.voidSetter used to store the suffix for the generated WebLogic jar file.voidsetWeblogicdtd(String inString) Deprecated.voidsetWLClasspath(Path wlClasspath) Optional classpath to WL6.0.voidDeprecated.voidCalled to validate that the tool parameters have been configured.protected voidMethod used to encapsulate the writing of the JAR file.Methods inherited from class org.apache.tools.ant.taskdefs.optional.ejb.GenericDeploymentTooladdFileToJar, addSupportClasses, checkAndAddDependants, checkConfiguration, configure, createClasspath, getClassLoaderForBuild, getCombinedClasspath, getConfig, getDescriptorHandler, getDestDir, getJarBaseName, getLocation, getManifestFile, getPublicId, getTask, getVendorDDPrefix, log, needToRebuild, parseEjbFiles, processDescriptor, setClasspath, setDestdir, setGenericJarSuffix, setTask, usingBaseJarName
- 
Field Details- 
PUBLICID_EJB11
- 
PUBLICID_EJB20
- 
PUBLICID_WEBLOGIC_EJB510
- 
PUBLICID_WEBLOGIC_EJB600
- 
PUBLICID_WEBLOGIC_EJB700
- 
DEFAULT_WL51_EJB11_DTD_LOCATION
- 
DEFAULT_WL60_EJB11_DTD_LOCATIONWebLogic 6.0 ejb 1.1 dtd location- See Also:
 
- 
DEFAULT_WL60_EJB20_DTD_LOCATIONWebLogic 6.0 ejb 2.0 dtd location- See Also:
 
- 
DEFAULT_WL51_DTD_LOCATION- See Also:
 
- 
DEFAULT_WL60_51_DTD_LOCATION- See Also:
 
- 
DEFAULT_WL60_DTD_LOCATION- See Also:
 
- 
DEFAULT_WL70_DTD_LOCATION- See Also:
 
- 
DEFAULT_COMPILER- See Also:
 
- 
WL_DD- See Also:
 
- 
WL_CMP_DD- See Also:
 
- 
COMPILER_EJB11- See Also:
 
- 
COMPILER_EJB20- See Also:
 
 
- 
- 
Constructor Details- 
WeblogicDeploymentToolpublic WeblogicDeploymentTool()
 
- 
- 
Method Details- 
addSyspropertyAdd a nested sysproperty element.- Parameters:
- sysp- the element to add.
 
- 
createWLClasspathGet the classpath to the WebLogic classpaths.- Returns:
- the classpath to configure.
 
- 
setOutputDirIf set ejbc will use this directory as the output destination rather than a jar file. This allows for the generation of "exploded" jars.- Parameters:
- outputDir- the directory to be used.
 
- 
setWLClasspathOptional classpath to WL6.0. WebLogic 6.0 will give a warning if the home and remote interfaces of a bean are on the system classpath used to run weblogic.ejbc. In that case, the standard WebLogic classes should be set with this attribute (or equivalent nested element) and the home and remote interfaces located with the standard classpath attribute.- Parameters:
- wlClasspath- the path to be used.
 
- 
setCompilerThe compiler (switch-compiler) to use; optional. This allows for the selection of a different compiler to be used for the compilation of the generated Java files. This could be set, for example, to Jikes to compile with the Jikes compiler. If this is not set and thebuild.compilerproperty is set to jikes, the Jikes compiler will be used. If this is not desired, the value "default" may be given to use the default compiler.- Parameters:
- compiler- the compiler to be used.
 
- 
setRebuildpublic void setRebuild(boolean rebuild) Set the rebuild flag to false to only update changes in the jar rather than rerunning ejbc; optional, default true. This flag controls whether weblogic.ejbc is always invoked to build the jar file. In certain circumstances, such as when only a bean class has been changed, the jar can be generated by merely replacing the changed classes and not rerunning ejbc. Setting this to false will reduce the time to run ejbjar.- Parameters:
- rebuild- a- booleanvalue.
 
- 
setJvmDebugLevelSets the weblogic.StdoutSeverityLevel to use when running the JVM that executes ejbc; optional. Set to 16 to avoid the warnings about EJB Home and Remotes being in the classpath- Parameters:
- jvmDebugLevel- the value to use.
 
- 
getJvmDebugLevel
- 
setSuffixSetter used to store the suffix for the generated WebLogic jar file.- Parameters:
- inString- the string to use as the suffix.
 
- 
setKeepgenericpublic void setKeepgeneric(boolean inValue) controls whether the generic file used as input to ejbc is retained; defaults to false- Parameters:
- inValue- true for keep generic
 
- 
setKeepgeneratedControls whether WebLogic will keep the generated Java files used to build the class files added to the jar. This can be useful when debugging; default is false.- Parameters:
- inValue- either 'true' or 'false'
 
- 
setArgsAny optional extra arguments pass to the weblogic.ejbc tool.- Parameters:
- args- extra arguments to pass to the ejbc tool.
 
- 
setJvmargsSet any additional arguments to pass to the WebLogic JVM; optional.- Parameters:
- args- the arguments to be passed to the JVM
 
- 
setEjbcClassSet the classname of the ejbc compiler; optional Normally ejbjar determines the appropriate class based on the DTD used for the EJB. The EJB 2.0 compiler featured in WebLogic 6 has, however, been deprecated in version 7. When using with version 7 this attribute should be set to "weblogic.ejbc" to avoid the deprecation warning.- Parameters:
- ejbcClass- the name of the class to use.
 
- 
getEjbcClassGet the ejbc compiler class.- Returns:
- the name of the ejbc compiler class.
 
- 
setWeblogicdtdDeprecated. Defines the location of the ejb-jar DTD in the WebLogic class hierarchy. Should not be needed, and the nested <dtd> element is recommended when it is.- Parameters:
- inString- the string to use as the DTD location.
 
- 
setWLdtdDeprecated. Defines the location of WebLogic DTD in the WebLogic class hierarchy. Should not be needed, and the nested <dtd> element is recommended when it is.- Parameters:
- inString- the string to use as the DTD location.
 
- 
setEJBdtdDeprecated. Defines the location of Sun's EJB DTD in the WebLogic class hierarchy. Should not be needed, and the nested <dtd> element is recommended when it is.- Parameters:
- inString- the string to use as the DTD location.
 
- 
setOldCMPpublic void setOldCMP(boolean oldCMP) Set the value of the oldCMP scheme. This is an antonym for newCMP- Parameters:
- oldCMP- a- booleanvalue.
 
- 
setNewCMPpublic void setNewCMP(boolean newCMP) If this is set to true, the new method for locating CMP descriptors will be used; optional, default false.The old CMP scheme locates the WebLogic CMP descriptor based on the naming convention where the WebLogic CMP file is expected to be named with the bean name as the prefix. Under this scheme the name of the CMP descriptor does not match the name actually used in the main WebLogic EJB descriptor. Also, descriptors which contain multiple CMP references could not be used. - Parameters:
- newCMP- a- booleanvalue.
 
- 
setNoEJBCpublic void setNoEJBC(boolean noEJBC) Do not EJBC the jar after it has been put together; optional, default false- Parameters:
- noEJBC- a- booleanvalue.
 
- 
registerKnownDTDsRegister the DTDs.- Overrides:
- registerKnownDTDsin class- GenericDeploymentTool
- Parameters:
- handler- the handler to use.
 
- 
getWeblogicDescriptorHandlerGet the WebLogic descriptor handler.- Parameters:
- srcDir- the source directory.
- Returns:
- the descriptor.
 
- 
addVendorFilesAdd any vendor specific files which should be included in the EJB Jar.- Overrides:
- addVendorFilesin class- GenericDeploymentTool
- Parameters:
- ejbFiles- the hash table to be populated.
- ddPrefix- the prefix to use.
 
- 
writeJarprotected void writeJar(String baseName, File jarFile, Hashtable<String, File> files, String publicId) throws BuildExceptionMethod used to encapsulate the writing of the JAR file. Iterates over the filenames/java.io.Files in the Hashtable stored on the instance variable ejbFiles.- Overrides:
- writeJarin class- GenericDeploymentTool
- Parameters:
- baseName- the base name.
- jarFile- the jar file to populate.
- files- the hash table of files to write.
- publicId- the id to use.
- Throws:
- BuildException- if there is a problem.
 
- 
validateConfiguredCalled to validate that the tool parameters have been configured.- Specified by:
- validateConfiguredin interface- EJBDeploymentTool
- Overrides:
- validateConfiguredin class- GenericDeploymentTool
- Throws:
- BuildException- if there is an error.
 
- 
isRebuildRequiredHelper method to check to see if a WebLogic EJB 1.1 jar needs to be rebuilt using ejbc. Called from writeJar it sees if the "Bean" classes are the only thing that needs to be updated and either updates the Jar with the Bean classfile or returns true, saying that the whole WebLogic jar needs to be regenerated with ejbc. This allows faster build times for working developers.The way WebLogic ejbc works is it creates wrappers for the publicly defined methods as they are exposed in the remote interface. If the actual bean changes without changing the the method signatures then only the bean classfile needs to be updated and the rest of the WebLogic jar file can remain the same. If the Interfaces, ie. the method signatures change or if the xml deployment descriptors changed, the whole jar needs to be rebuilt with ejbc. This is not strictly true for the xml files. If the JNDI name changes then the jar doesn't have to be rebuild, but if the resources references change then it does. At this point the WebLogic jar gets rebuilt if the xml files change at all. - Parameters:
- genericJarFile- java.io.File The generic jar file.
- weblogicJarFile- java.io.File The WebLogic jar file to check to see if it needs to be rebuilt.
- Returns:
- true if the jar needs to be rebuilt.
 
- 
getClassLoaderFromJarHelper method invoked by isRebuildRequired to get a ClassLoader for a Jar File passed to it.- Parameters:
- classjar- java.io.File representing jar file to get classes from.
- Returns:
- the classloader for the jarfile.
- Throws:
- IOException- if there is a problem.
 
 
-