org.apache.tools.ant.taskdefs.optional.ejb
public class IPlanetDeploymentTool extends GenericDeploymentTool
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.
See Also: IPlanetEjbc
Method Summary | |
---|---|
protected void | addVendorFiles(Hashtable ejbFiles, String ddPrefix)
Add the iAS-specific EJB descriptor to the list of files which will be
written to the JAR file.
|
protected void | checkConfiguration(String descriptorFileName, SAXParser saxParser)
Verifies that the user selections are valid.
|
protected 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 Hashtable | parseEjbFiles(String descriptorFileName, SAXParser saxParser)
This method returns a list of EJB files found when the specified EJB
descriptor is parsed and processed.
|
void | processDescriptor(String descriptorName, SAXParser saxParser) {@inheritDoc}. |
void | setDebug(boolean debug)
Sets whether or not debugging output will be generated when ejbc is
executed.
|
void | setGenericJarSuffix(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(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(String jarSuffix)
Setter method used to specify the filename suffix (for example, ".jar")
for the JAR files to be created.
|
Parameters: ejbFiles Hashtable of EJB class (and other) files to be added to the completed JAR file. ddPrefix not used
Parameters: descriptorFileName String representing the file name of an EJB descriptor to be processed saxParser SAXParser which may be used to parse the XML descriptor
Throws: BuildException If the user selections are invalid.
null
.
Returns: null
.
Parameters: descriptorFileName String representing the file name of an EJB descriptor to be processed saxParser SAXParser which may be used to parse the XML descriptor
Returns: Hashtable of EJB class (and other) files to be added to the completed JAR file
Throws: IOException An IOException from the parser, possibly from the byte stream or character stream SAXException Any SAX exception, possibly wrapping another exception
Parameters: debug A boolean indicating if debugging output should be generated
Parameters: inString the string to use as the suffix. This parameter is ignored.
[install-location]/iplanet/ias6/ias
.
Parameters: iashome The home directory for the user's iAS installation.
Parameters: keepgenerated boolean which, if true
, indicates that
Java source files generated by ejbc for the stubs
and skeletons should be kept.
Parameters: jarSuffix The string to use as the JAR filename suffix.