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 application server installed targets.
To use Ant as part of the Sun Java System Application 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 Application 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.
Example 1. Compiling and Assembling a Sample Application
Using the simple stateless EJB sample as an example, execute several
of the build targets as follows:
cd install_root/samples/ejb/stateless/simple/src
Execute the compile target to compile the Java sources
as follows:
asant compile
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:
asant core
Since the default build target is core you can execute asant without any arguments to rebuild the entire application.
Example 2. Building Web-based Applications
You can build everything, including installing Javadocs, and deploying
the application by:
asant all
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