Home | Download | PDF | API | FAQ | Search | Feedback | History

> ## Building, Packaging, Deploying, and Running the Application

> The source code for the Coffee Break application is located in the directory `<``INSTALL``>/javaeetutorial5/examples/coffeebreak/`. Within the `cb` directory are subdirectories for each web application--`cb`, `cb-saaj`, and `cb-jaxws`--and a directory, `cb-common`, for classes shared by the web applications. Each subdirectory contains a `build.xml` file. The web application subdirectories in turn contain a `src` subdirectory for Java classes and configuration files, and a `web` subdirectory for web resources.

> ### Setting the Port

> The JAX-WS and SAAJ services in the Coffee Break application run at the port that you specified when you installed the Application Server. The tutorial examples assume that the Application Server runs on the default port, 8080. If you have changed the port, you must update the port number in the following files before building and running the examples:

> - `<``INSTALL``>/javaeetutorial5/examples/coffeebreak/cb-common/src/com/sun/cb/common/CoffeeBreak.properties`. Update the port in the following URLs:
> - `endpoint.url=http://localhost:8080/jaxws-coffee-supplier/jaxws`
> - `saaj.url=http://localhost:8080/saaj-coffee-supplier`

> ### Building the Common Classes

> The Coffee Break applications share a number of common utility classes. To build the common classes and copy the `CoffeeBreak.properties` file into the `build` directory, do the following:

> 1. In a terminal window, go to `<``INSTALL``>/javaeetutorial5/examples/coffeebreak/cb-common/`.
> 2. Run `ant`.

> ### Building, Packaging, and Deploying the JAX-WS Service

> To build the JAX-WS service and client library and to package and deploy the JAX-WS service, follow these steps:

> 1. In a terminal window, go to `<INSTALL>``/javaeetutorial5/examples/coffeebreak/cb-jaxws/`.
> 2. Run `ant`. This task calls the `default` target, which compiles the source files of the JAX-WS service.
> 3. Make sure the Application Server is running.

> To package and deploy the JAX-WS service using `ant`, run:

>     ant deploy

> ### Building, Packaging, and Deploying the SAAJ Service

> To build the SAAJ service and client library, follow these steps:

> 1. In a terminal window, go to `<``INSTALL``>/javaeetutorial5/examples/coffeebreak/cb-saaj/`.
> 2. Run `ant`. This task calls the `default` target, which creates the client library and compiles the SAAJ service classes.
> 3. Make sure the Application Server is started.

> To package and deploy the SAAJ service using ant, run:

>     ant deploy

> ### Building, Packaging, and Deploying the Coffee Break Server

> To build the Coffee Break server, follow these steps:

> 1. In a terminal window, go to `<``INSTALL``>/javaeetutorial5/examples/coffeebreak/cb/`.
> 2. Run `ant`. This task calls the `default` target, which compiles the server classes.
> 3. Make sure the Application Server is started.

> To package and deploy the JSF server using `ant`, run:

>     ant deploy

> ### Running the Coffee Break Client

> After you have installed all the web applications, check that all the applications are running in the Admin Console. You should see `cb`, `cb-saaj`, and `cb-jaxws` in the list of applications.

> You can run the Coffee Break client by opening this URL in a web browser:

>     http://localhost:8080/cbserver/

> You should see a page something like the one shown in Figure 37-1.

> Figure 37-1 Order Form

> After you have gone through the application screens, you will get an order confirmation that looks like the one shown in Figure 37-2.

> Figure 37-2 Order Confirmation

> ### Removing the Coffee Break Application

> To remove the Coffee Break application, perform the following steps:

> 1. Undeploy the JAX-WS service, SAAJ service, and the Coffee Break server using the Admin Console or by running `ant` `undeploy` in their respective directories.
> 2. Stop the Application Server.

> If you want to remove the `build` and `dist` directories, run `ant` `clean` in each directory, including `<``INSTALL``>/javaeetutorial5/examples/coffeebreak/cb-common/`.