Skip to Content Sun Java Solaris Communities My SDN Account Join SDN

SDN Home > Products & Technologies > Java Technology > Reference > BluePrints > Code > Java Pet Store Demo 1.3.2 >

Java Pet Store Demo 1.3.2

Java Pet Store Demo> Building the Demo

Print-friendly Version

Guidelines, Patterns, and code for end-to-end Java applications.

Java Pet Store Demo 1.3.2 > Building the Demo

Building the Demo

We use Ant version 1.4.1 to build the source code. Ant is a Java-based build tool like make, which has been developed under the auspices of the Apache Software Foundation. A working version of Ant is provided as part of the Java Pet Store Demo bundle.

Note: The Java Pet Store Demo bundle comes with pre-built binaries. To deploy these binaries and avoid building the application, consult the installation instructions.

1.0 Building Pet Store Demo

This section explains how to build the application binaries for the petstore application which uses JMS for communication between the Order Processing Center and the Supplier. Building all the application binaries and performing other tasks with Ant involves running the top-level build script in the root directory of the demo installation.

Before building the application, you need to configure the <petstore.home>/src/build.properties file to match your enviroment. You need to set the following properties:

Property Name	Description	Examples
j2ee.server.name	Host name of the server where the J2EE SDK is installed	localhost
j2ee.server.port	HTTP port where the J2EE SDK can be accessed	8000 or 8080 (after applying JWSDP to J2EE SDK)
j2ee.home	The absolute path to the directory where J2EE SDK is installed	c:\j2sdkee1.3.1 (on Windows) or ~/j2sdkee1.3.1 (on Unix)
j2ee-script-suffix	The suffix of the J2EE scripts	.bat (on Windows) or no suffix (on Unix)
jwsdp-script-suffix	The suffix of the JWSDP scripts	.bat (on Windows) or .sh (on Unix)

Note: On Windows, while writing the paths in the properties files, you need to escape the "\" properly by using "\\" instead. So, for example, c:\j2sdkee1.3.1 will become c:\\j2sdkee1.3.1.

To build the application binaries on Unix, open a shell prompt and enter these commands:

cd <petstore.home>/src
build.sh [argument]

To build the application binaries on Windows, open a shell prompt and enter these commands:

cd <petstore.home>\src
build.bat [argument]

When the build script, build.bat (Windows) or build.sh (Unix), is invoked without any arguments, all the application binaries are built. The binaries are placed in the following folders:

<petstore.home>/src/apps/admin/build/petstoreadmin.ear
<petstore.home>/src/apps/opc/build/opc.ear
<petstore.home>/src/apps/petstore/build/petstore.ear
<petstore.home>/src/apps/supplier/build/supplier.ear

The following table lists possible arguments for the top-level build script:

Arguments for ant


Option	Purpose
`core`	Builds everything. (This is the default build target.)
`clean`	Cleans out the build output directories.
`deploy`	Deploys the application binaries.
`undeploy`	Undeploys the application binaries.
`verify`	Runs the J2EE verifier tool to catch errors in the application packaging.
`docs`	Builds the application Javadocs.

1.1 Building a Single Application

To build a single application, run the build script (build.bat or build.sh) in to <petstore.home>/src/apps/<app>/src , where <app> is one of the following:

petstore, which contains the code for the storefront.

opc, which contains the code for the order processing center.

supplier, which contains the code for the supplier.

admin, which contains the code for the administrative front-end.

The application binary (an EAR file) is placed in <petstore.home>/src/apps/<app>/build . You can deploy this EAR file by running the build script again, but this time using the deploy argument. Alternatively, you can use the J2EE SDK deployment tool.

1.2 Building with the Forte[tm] for Java IDE

The Forte for Java IDE supports Ant build files. Just double click on the build.xml file in various directories to start a build.


	About Sun \| About This Site \| Newsletters \| Contact Us \| Employment How to Buy \| Licensing \| Terms of Use \| Privacy \| Trademarks Copyright Sun Microsystems, Inc.		A Sun Developer Network Site Unless otherwise licensed, code in all technical manuals herein (including articles, FAQs, samples) is provided under this License. Sun Developer RSS Feeds