Use the asant command to automate repetitive development and deployment tasks. asant is a shell script that invokes the underlying Ant infrastructure after initializing the environment to pick up the Communications Server installed targets.
To use Ant as part of the Communications Server, verify that your PATH includes the provided asant (UNIX) or ant.bat(Windows) script.
The bundled sample applications use asant extensively; however, asant can be used in any development or operational environments.
The build targets are represented in the build.xml files that accompany the sample applications.
To use the Ant tool to compile and reassemble the sample applications, verify that the $AS_INSTALL/bin directory is on your environment's path. On UNIX, add the $AS_INSTALL/bin directory to your PATH environment variable. On Windows, after installing the Sun ONE Communications Server, set the system path by adding $AS_INSTALL\bin to the user PATH. You can access the PATH system variable from: Start menu, Settings, Control Panel, System, Advanced, Environment Variables, User Variables for Administrator, PATH.
The target_list is one or more space separated tasks as described below.
compiles all Java source code.
assembles the EJB JAR module.
assembles the WAR file in sample_dir/assemble/war
assembles the EAR file in sample_dir/assemble/ear
(default) compiles all sources, builds stubs and skeletons; and assembles EJB JAR, WAR and EAR files. This is the default target for all build.xml files shipped in the Sun ONE Communications Server.
creates Java docs in sample_dir/javadocs
builds core and javadocs , verifies and deploys the application, and adds the resources..
deploys the application and automatically expands the EJB JAR; does not install Javadocs.
removes the deployed sample from the Communications Server.
removes appname/build/ and appname/assemble/ and appname/javadocs directories.
verifies the deployment descriptors in the sample.
Using the simple stateless EJB sample as an example, execute several of the build targets as follows:
Execute the compile target to compile the Java sources as follows:
Execute the war, ear, and ejbjar target to assemble the J2EE module files and the EAR file as follows by:
asant jar asant war asant ear
Alternatively, all the above tasks can be accomplished by:
Since the default build target is core you can execute asant without any arguments to rebuild the entire application.
You can build everything, including installing Javadocs, and deploying the application by:
Additionally, you can build everything, except the Javadocs, but deploy the application by:
asant core or just, asant then, asant deploy
To rebuild the ear after you have modified the deployment descriptors without recompiling:
asant ear asant deploy
SUNWant documentation is located in /usr/sfw/share/doc/ant.
See also asadmin(1M).
See the Communications Server Developer's Guide for information about special Ant tasks you can use.