Sun GlassFish Enterprise Server

Samples Main Page

# The Java Persistence API Advanced Mapping Sample

This sample demonstrates the use of Derived Identities and Maps.

## Application Structure

The application is built and deployed as a WAR file.

### Web Module

The web module consists of:

- Three entities
  - Order : It represents an order placed by a customer. Apart from id and customer name, it also contains a map from entity Item to LineItem mapped as a OneToMany relationship.
  - LineItem : It represents a LineItem of an Order. It has a composite primary key consisting of lineItemNumber and order id. The order id part of the key is also mapped as ManyToOne relationship using the derived id feature introduced in JPA 2.0
  - Item : It represents an item available for sell.

- A session bean that acts as a facade to operate on these entities. Methods createData and queryData demonstrates how to create and query data for entities using above mapping features

- A servlet that facilitates calling into above session bean

### Test Client

The Test client consist of

- A Java SE client with main(). The client calls into the servlet to create and query data.

## Building, Deploying, and Running the Application

Perform the following steps to build, deploy, and run the application:

1. Set up your build environment and configure the application server with which the build system has to work by following the common build instructions.
2. `app_dir` is the sample application base directory: `samples_install_dir/javaee6/jpa/advancedMapping`.
3. ````Change directory to `app_dir.
   `
4. Build, deploy, and run the sample application using the `all` target.``

`app_dir> ant all`

You can replace the `ant all` command with the following set of commands:

`app_dir> ant default` compiles and packages the application

`app_dir> ant deploy` deploys it to application server

`app_dir> ant run` runs the test java client

5. Use the target clean to undeploy the sample application and to remove the temporary directories such as build and dist.

   `app_dir> ant clean`

## Building, Deploying, and Running the Application in NetBeans IDE

Perform the following steps to build, deploy, and run the application using NetBeans IDE:

1. Refer to the common build instructions for setting up NetBeans IDE and Sun GlassFish Enterprise Server.
2. In the NetBeans IDE, choose File → Open Project (Ctrl-Shift-O), navigate to the `samples_install_dir/javaee6/jpa/` directory, select `advancedMapping`, and click Open Project.
3. In the Projects tab, right click `advancedMapping` and select Run to build, deploy, and run the project.

## Troubleshooting

If you have problems when running the application, refer the troubleshooting document.

Copyright © 2009 Sun Microsystems, Inc. All rights reserved.