Description:
Task to compile EJB stubs and skeletons for the iPlanet Application Server 6.0. Given a standard EJB 1.1 XML descriptor as well as an iAS-specific EJB descriptor, this task will generate the stubs and skeletons required to deploy the EJB to iAS. Since the XML descriptors can include multiple EJBs, this is a convenient way of specifying many EJBs in a single Ant task.
For each EJB specified, the task will locate the three classes that comprise the EJB in the destination directory. If these class files cannot be located in the destination 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 the iAS ejbc utility be called to generate new stubs and skeletons.
Parameters
Attribute | Description | Required
|
---|---|---|
ejbdescriptor | Standard EJB 1.1 XML descriptor (typically titled "ejb-jar.xml"). | Yes |
iasdescriptor | iAS-specific EJB XML descriptor (typically titled "ias-ejb-jar.xml"). | Yes |
dest | The is the base directory where the RMI stubs and skeletons are written. In addition, the class files for each bean (home interface, remote interface, and EJB implementation) must be found in this directory. | Yes |
classpath | The classpath used when generating EJB stubs and skeletons. If omitted, the classpath specified when Ant was started will be used. Nested "classpath" elements may also be used. | No |
keepgenerated | Indicates whether or not the Java source files which are generated by ejbc will be saved or automatically deleted. If "yes", the source files will be retained. If omitted, it defaults to "no". | No |
debug | Indicates whether or not the ejbc utility should log additional debugging statements to the standard output. If "yes", the additional debugging statements will be generated. If omitted, it defaults to "no". | No |
iashome | May be used to specify the "home" directory for this iAS installation. This is used to find the ejbc utility if it isn't included in the user's system path. If specified, it should refer to the "[install-location]/iplanet/ias6/ias" directory. If omitted, the ejbc utility must be on the user's system path. | No |
Examples
<iplanet-ejbc ejbdescriptor="ejb-jar.xml" iasdescriptor="ias-ejb-jar.xml" dest="${build.classesdir}" classpath="${ias.ejbc.cpath}"/> <iplanet-ejbc ejbdescriptor="ejb-jar.xml" iasdescriptor="ias-ejb-jar.xml" dest="${build.classesdir}" keepgenerated="yes" debug="yes" iashome="${ias.home}"> <classpath> <pathelement path="."/> <pathelement path="${build.classpath}"/> </classpath> </iplanet-ejbc>