Print-friendly Version

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

Java Pet Store Demo 1.3.1 > Using the Demo

Using the Demo

This section describes how to use the Java Pet Store Demo. It starts by describing the high-level components of the demo, and how to use the demo through its various user interfaces.

• Demo at a Glance

• Using the Storefront

  • Visiting the Storefront

  • Creating a New User

  • Placing an Order

• Using the Administrator Client

  • Opening the Admin Client

  • Viewing Non-Pending Orders

  • Approving/Denying Orders

• Managing the Supplier

  • Opening the Supplier Client

  • Viewing and Editing Inventory

Demo at a Glance

The Java Pet Store Demo consists of the following high-level components:

• The Storefront presents the main user interface in a Web front-end. Customers use the Storefront to place orders for pets.

• The Order Processing Center (OPC) receives orders from the Storefront.

• The Supplier fulfills orders from the OPC from inventory and invoices the OPC.

• The Admin presents the administrator interface in a JFC/Swing front-end. Administrators use the Admin to examine pending orders and approve or deny them.

Using the Storefront

Visiting the Storefront

Using a browser, go to the following URL:

http://localhost:8000/petstore


If you have installed the Java Web Services Developer Pack, the URL changes to: 

http://localhost:8080/petstore


Creating a New User

If this is your first time visiting the store, create a new user before making a purchase.

1. Click Sign In on the home page.

2. Fill out the form titled, "I would like to sign up for an account", and click Create New Account.

3. Enter your account info, and click Submit.

Placing an Order

To purchase a bulldog, for example, follow these steps:

1. On the home page, select Dogs.

2. Click Bulldog.

3. Click Add to Cart in the row for the Male Adult Bulldog.

4. Click Check Out.

   A form for your billing and shipping info appears. For your convenience, it's already filled out.

5. Click Submit.

When you complete the order, the Storefront sends the order info asyncronously to the OPC. Because the order is less than $500, the OPC approves it automatically.

Using the Admin Client

Opening the Admin Client

Orders are reviewed and modified using a Java administrator client.

Using a browser, go to the following URL:

http://localhost:8000/admin/


If you have installed the Java Web Services Developer Pack, the URL changes to: 

http://localhost:8080/admin


To launch the administrator rich client interface, click Launch Rich Client at the home screen. The client is launched using Java Web Start.

When the client appears, you will see two panes for displaying pending and non-pending orders. The bulldog order from the previous section would be non-pending, because it was less than $500, and all orders under $500 are automatically approved.

If you have enabled Web-services in the demo, you can also use a stand-alone version of this Java client that communicates to the server using Web-services. To run this client, do the following:

If you are using Unix, open a shell prompt and enter these commands:

cd <petstore.home>/webservices
sh adminwsclient.sh localhost 8080
If you are using Windows, open a command prompt and enter these commands:
cd <petstore.home>\webservices
adminwsclient.bat localhost 8080

Viewing Non-Pending Orders

The View Non-Pending Orders panel shows non-pending orders. Each of these orders has been approved, denied, or committed (fulfilled). To load the orders, click the Refresh button.

To create or edit inventory for the Supplier, see Managing the Supplier.

Approving/Denying Orders

You approve or deny pending orders using the Process Pending Orders panel. An order appears as pending if its total value is greater than $500.

To approve or deny an order:

1. Click the Process Pending Orders tab.

2. Click the row of the order.

3. Click its Status cell.

4. Select a new status.

You can approve or deny as many orders as you wish. To save your changes, click Commit. To see your changes, click the Refresh button.

Managing the Supplier

Opening the Supplier Client

The supplier and its inventory are managed using a simple Web interface. Make sure to first logout of the admin client, before using the supplier. 

Using a browser, go to the following URL:

http://localhost:8000/supplier/


If you have installed the Java Web Services Developer Pack, the URL changes to: 

http://localhost:8080/supplier/


Viewing and Editing Inventory

To view and edit inventory, click Display Inventory at the home screen.

A table shows the quantity for each item in the inventory. To edit that item's quantity, edit the New Quantity cell in the item's entry, and check the Update box. After making all your changes, commit your edits to the database by clicking Submit.

Any time you update the database, the Supplier notifies the OPC about the changes to the inventory. The OPC examines these changes to see if it can fulfill any orders that it previously could not. If it can fullill an order, it will mark the order as completed.