Java Pet Store Tutorial

The Java Pet Store is a popular J2EE example application in the J2EE Blueprints series, created by Sun Microsystems. It models an e-commerce application where customers can purchase pets online using a Web browser. The purpose of this application is to demonstrate the capabilities of the J2EE platform and is written for learning purposes (for example to illustrate the many different design patterns on various part of J2EE). It is not coded for performance and is not intended for performance benchmarks.

The Java Pet Store 1.3.2 follows the J2EE 1.3 specs which is a set of related specifications and can be seen as a single standard for implementing and deploying enterprise applications. Java Pet Store 1.3.2 demonstrates the following:
  • How to use Java Server Pages (jsp).
  • How to use Java Servlets.
  • How to use Enterprise JavaBeans (EJB).
  • How to use Java Message Service (JMS).
  • How to use JSP Standard Tag Library (JSTL).
  • How to use the Java API for XML-based RPC (JAX-RPC).
  • How to use SOAP.
  • How to exchange and process XML-based documents.
  • How to develop flexible, scalable, cross-plaform enterprise applications.
  • How to use the Java BluePrints guidelines and patterns.
  • Illustrate basic usage of J2EE technology with current best practices.
The Pet Store application comes with full source code and documentation, and the latest release can be downloaded from:

More information about Pet Store can be found at:

The is no longer available at the site. discourage people from investing time in learning it since its old, and instead encourage developers to learn the newer material.

However there are several companies using the old BluePrints Web Application Framework (WAF) where the petstore 1.3.2 demo is based on. Download the file.

Start Java Pet Store 1.3.2


Operating system used
Windows XP Home Edition Version 5.1 SP 2

Software prerequisites
Java Pet Store 1.3.2

  1. Start Cloudscape:
       cd %J2EE_HOME%/bin
       cloudscape -start
    If all went well, you should see: [RmiJdbc] RmiJdbcServer bound in rmi registry
  2. Start the J2EE server:
       cd %J2EE_HOME%\bin
       j2ee.bat -verbose
    If all went well, you should see: J2EE server startup complete.
    To verify if the J2EE server is running: http://localhost:8000/index.html

  3. Run the Pet Store Application:

    About Java Pet Store

  4. Click the link "enter the store". The following message will be displayed:
    Please wait while the Java Pet Store Application is being populated...
    After a few seconds you sould see:

    Java Pet Store

  5. Here below an overview of all the Pet Store links:

    DescriptionEar FileURL
    The Storefront presents the main user interface in a Web front-end. Customers use the Storefront to place orders for pets. petstore.ear http//localhost:8000/petstore
    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. petstoreadmin.ear http//localhost:8000/admin
    The Supplier fulfills orders from the OPC from inventory and invoices the OPC. supplier.ear http//localhost:8000/supplier
    The Order Processing Center (OPC) receives orders from the Storefront. opc.ear -