|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--org.apache.tools.ant.taskdefs.optional.ejb.GenericDeploymentTool | +--org.apache.tools.ant.taskdefs.optional.ejb.IPlanetDeploymentTool
This class is used to generate iPlanet Application Server (iAS) 6.0 stubs and
skeletons and build an EJB Jar file. It is designed to be used with the Ant
ejbjar
task. If only stubs and skeletons need to be generated
(in other words, if no JAR file needs to be created), refer to the
iplanet-ejbc
task and the IPlanetEjbcTask
class.
The following attributes may be specified by the user:
[install-location]/iplanet/ias6/ias
directory). If omitted, the ejbc utility
must be on the user's system path.
For each EJB descriptor found in the "ejbjar" parent task, this deployment
tool will locate the three classes that comprise the EJB. If these class
files cannot be located in the specified srcdir
directory, the
task will fail. The task will also attempt to locate the EJB stubs and
skeletons in this directory. If found, the timestamps on the stubs and
skeletons will be checked to ensure they are up to date. Only if these files
cannot be found or if they are out of date will ejbc be called.
IPlanetEjbc
Field Summary |
Fields inherited from class org.apache.tools.ant.taskdefs.optional.ejb.GenericDeploymentTool |
ANALYZER_CLASS_FULL, ANALYZER_CLASS_SUPER, ANALYZER_FULL, ANALYZER_NONE, ANALYZER_SUPER, DEFAULT_ANALYZER, EJB_DD, MANIFEST, META_DIR |
Constructor Summary | |
IPlanetDeploymentTool()
|
Method Summary | |
protected void |
addVendorFiles(java.util.Hashtable ejbFiles,
java.lang.String ddPrefix)
Add the iAS-specific EJB descriptor to the list of files which will be written to the JAR file. |
protected void |
checkConfiguration(java.lang.String descriptorFileName,
javax.xml.parsers.SAXParser saxParser)
Verifies that the user selections are valid. |
protected java.lang.String |
getPublicId()
The iAS ejbc utility doesn't require the Public ID of the descriptor's DTD for it to process correctly--this method always returns null
. |
protected java.util.Hashtable |
parseEjbFiles(java.lang.String descriptorFileName,
javax.xml.parsers.SAXParser saxParser)
This method returns a list of EJB files found when the specified EJB descriptor is parsed and processed. |
void |
processDescriptor(java.lang.String descriptorName,
javax.xml.parsers.SAXParser saxParser)
Process a deployment descriptor, generating the necessary vendor specific deployment files. |
void |
setDebug(boolean debug)
Sets whether or not debugging output will be generated when ejbc is executed. |
void |
setGenericJarSuffix(java.lang.String inString)
Since iAS doesn't generate a "generic" JAR as part of its processing, this attribute is ignored and a warning message is displayed to the user. |
void |
setIashome(java.io.File iashome)
Setter method used to store the "home" directory of the user's iAS installation. |
void |
setKeepgenerated(boolean keepgenerated)
Setter method used to specify whether the Java source files generated by the ejbc utility should be saved or automatically deleted. |
void |
setSuffix(java.lang.String jarSuffix)
Setter method used to specify the filename suffix (for example, ".jar") for the JAR files to be created. |
Methods inherited from class org.apache.tools.ant.taskdefs.optional.ejb.GenericDeploymentTool |
addFileToJar, addSupportClasses, checkAndAddDependants, configure, createClasspath, getClassLoaderForBuild, getCombinedClasspath, getConfig, getDescriptorHandler, getDestDir, getJarBaseName, getLocation, getManifestFile, getTask, getVendorDDPrefix, log, needToRebuild, registerKnownDTDs, setClasspath, setDestdir, setTask, usingBaseJarName, validateConfigured, writeJar |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
public IPlanetDeploymentTool()
Method Detail |
public void setIashome(java.io.File iashome)
[install-location]/iplanet/ias6/ias
.
iashome
- The home directory for the user's iAS installation.public void setKeepgenerated(boolean keepgenerated)
keepgenerated
- boolean which, if true
, indicates that
Java source files generated by ejbc for the stubs
and skeletons should be kept.public void setDebug(boolean debug)
debug
- A boolean indicating if debugging output should be generatedpublic void setSuffix(java.lang.String jarSuffix)
jarSuffix
- The string to use as the JAR filename suffix.public void setGenericJarSuffix(java.lang.String inString)
setGenericJarSuffix
in class GenericDeploymentTool
inString
- the string to use as the suffix. This parameter is
ignored.public void processDescriptor(java.lang.String descriptorName, javax.xml.parsers.SAXParser saxParser)
EJBDeploymentTool
processDescriptor
in interface EJBDeploymentTool
processDescriptor
in class GenericDeploymentTool
descriptorName
- the name of the deployment descriptorsaxParser
- a SAX parser which can be used to parse the deployment descriptor.protected void checkConfiguration(java.lang.String descriptorFileName, javax.xml.parsers.SAXParser saxParser) throws BuildException
checkConfiguration
in class GenericDeploymentTool
descriptorFileName
- String representing the file name of an EJB
descriptor to be processedsaxParser
- SAXParser which may be used to parse the XML
descriptor
BuildException
- If the user selections are invalid.protected java.util.Hashtable parseEjbFiles(java.lang.String descriptorFileName, javax.xml.parsers.SAXParser saxParser) throws java.io.IOException, org.xml.sax.SAXException
parseEjbFiles
in class GenericDeploymentTool
descriptorFileName
- String representing the file name of an EJB
descriptor to be processedsaxParser
- SAXParser which may be used to parse the XML
descriptor
java.io.IOException
- An IOException from the parser, possibly from
the byte stream or character stream
org.xml.sax.SAXException
- Any SAX exception, possibly wrapping another
exceptionprotected void addVendorFiles(java.util.Hashtable ejbFiles, java.lang.String ddPrefix)
addVendorFiles
in class GenericDeploymentTool
ejbFiles
- Hashtable of EJB class (and other) files to be added to
the completed JAR file.ddPrefix
- not usedprotected java.lang.String getPublicId()
null
.
getPublicId
in class GenericDeploymentTool
null
.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |