org.apache.tools.ant.taskdefs.optional.ejb
public class IPlanetEjbc extends Object
Because this class (and it's assorted inner classes) may be bundled into the iPlanet Application Server distribution at some point (and removed from the Ant distribution), the class has been written to be independent of all Ant-specific classes. It is also for this reason (and to avoid cluttering the Apache Ant source files) that this utility has been packaged into a single source file.
For more information on Ant Tasks for iPlanet Application Server, see the
IPlanetDeploymentTool
and IPlanetEjbcTask
classes.
See Also: IPlanetDeploymentTool IPlanetEjbcTask
UNKNOWN: ignore="true"
Nested Class Summary | |
---|---|
class | IPlanetEjbc.EjbcException
This inner class is used to signal any problems during the execution of
the ejbc compiler.
|
Constructor Summary | |
---|---|
IPlanetEjbc(File stdDescriptor, File iasDescriptor, File destDirectory, String classpath, SAXParser parser)
Constructs an instance which may be used to process EJB descriptors and
generate EJB stubs and skeletons, if needed.
|
Method Summary | |
---|---|
protected void | checkConfiguration()
Verifies that the user selections are valid.
|
void | execute()
Compiles the stub and skeletons for the specified EJBs, if they need to
be updated.
|
String[] | getCmpDescriptors()
Returns the list of CMP descriptors referenced in the EJB descriptors.
|
String | getDisplayName()
Returns the display-name element read from the standard EJB descriptor.
|
Hashtable | getEjbFiles()
Returns a Hashtable which contains a list of EJB class files processed by
the ejbc utility (both "source" class files as well as stubs and
skeletons). |
static void | main(String[] args)
Main application method for the iPlanet Application Server ejbc utility.
|
void | registerDTD(String publicID, String location)
Registers the location of a local DTD file or resource. |
void | setDebugOutput(boolean debugOutput)
If true, enables debugging output when ejbc is executed.
|
void | setIasHomeDir(File iasHomeDir)
May be used to specify the "home" directory for this iAS installation.
|
void | setRetainSource(boolean retainSource)
If true, the Java source files which are generated by the
ejbc process are retained.
|
Parameters: stdDescriptor File referencing a standard EJB descriptor. iasDescriptor File referencing an iAS-specific EJB descriptor. destDirectory File referencing the base directory where both EJB "source" files are found and where stubs and skeletons will be written. classpath String representation of the classpath to be used by the iAS ejbc utility. parser SAXParser to be used to process both of the EJB descriptors.
UNKNOWN: classpathElements is not needed here, its never used (at least IDEA tells me so! :)
Throws: EjbcException If the user selections are invalid.
Throws: EjbcException If the ejbc utility cannot be correctly configured or if one or more of the EJB "source" classes cannot be found in the destination directory IOException If the parser encounters a problem reading the XML file SAXException If the parser encounters a problem processing the XML descriptor (it may wrap another exception)
Returns: An array of CMP descriptors.
Returns: The EJB-JAR display name.
Returns: The list of EJB files processed by the ejbc utility.
Parameters: args The commandline arguments passed to the application.
Parameters: publicID The public DTD identifier found in an XML document. location The file or resource name for the appropriate DTD stored on the local machine.
Parameters: debugOutput A boolean indicating if debugging output should be generated
[install-location]/iplanet/ias6/ias
.
Parameters: iasHomeDir The home directory for the user's iAS installation.
Parameters: retainSource A boolean indicating if the Java source files for the stubs and skeletons should be retained.
UNKNOWN: This is not documented in the HTML. On purpose?