Building the Examples

Most of the examples in the Java WSDP are distributed with a build file for Ant, a portable build tool contained in the Java WSDP. For information about Ant, visit http://ant.apache.org/. Directions for building the examples are provided in each chapter. Most of the tutorial examples in the J2EE Tutorial are distributed with a configuration file for asant, a portable build tool contained in the Application Server. This tool is an extension of the Ant tool developed by the Apache Software Foundation (http://ant.apache.org). The asant utility contains additional tasks that invoke the Application Server administration utility asadmin. Directions for building the examples are provided in each chapter.

To run the asant scripts in the J2EE Tutorial, you must set two common build properties as follows:

Set the j2ee.home property in the file <INSTALL>/j2eetutorial14/examples/common/build.properties to the location of your Application Server installation. The build process uses the j2ee.home property to include the libraries in <J2EE_HOME>/lib/ in the classpath. All examples that run on the Application Server include the J2EE library archive--<J2EE_HOME>/lib/j2ee.jar--in the build classpath. Some examples use additional libraries in <J2EE_HOME>/lib/ and <J2EE_HOME>/lib/endorsed/; the required libraries are enumerated in the individual technology chapters. <J2EE_HOME> refers to the directory where you have installed the Application Server or the J2EE 1.4 SDK.

Note: On Windows, you must escape any backslashes in the j2ee.home property with another backslash or use forward slashes as a path separator. So, if your Application Server installation is C:\Sun\AppServer, you must set j2ee.home as follows:

j2ee.home = C:\\Sun\\AppServeror

j2ee.home=C:/Sun/AppServer

If you did not use port 8080 when you installed the Application Server, set the value of the domain.resources.port property in <INSTALL>/j2eetutorial14/examples/common/build.properties to the correct port.

Set the admin.user and admin.password properties in the file <INSTALL>/j2eetutorial14/examples/common/build.properties to the values you specified when you installed the J2EE 1.4 Application Server. The build scripts use these values when you invoke an administration task such as creating a database pool. The default value for admin.user is set to the installer's default value, which is admin.

In order to run the Ant scripts, you must configure your environment and properties files as follows:

Add the bin directory of your J2SE SDK installation to the front of your path.

Add <JWSDP_HOME>/jwsdp-shared/bin to the front of your path so the Java WSDP 1.4 scripts that are shared by multiple components override other installations.

Add <JWSDP_HOME>/apache-ant/bin to the front of your path so that the Java WSDP 1.4 Ant script overrides other installations.

All of the material in The Java(TM) Web Services Tutorial is copyright-protected and may not be published in other works without express written permission from Sun Microsystems.