Java Persistence API (JPA) Sample

The JPA sample contains a server definition which includes the Servlet, JDBC and JPA features. It also contains a very simple JPA application, jpaApp.war, which contains a single servlet, JPAServlet. This servlet persists a JPA entity (named "Thing") to a derby database and then retrieves the entiry from the database.

Running in Eclipse with Maven

1. Clone this project and import into Eclipse as an 'Existing Maven Project'.
2. Right-click the project and select Run As > Maven Clean.
3. Right-click the project and select Run As > Maven Install.
4. Right-click the project and select Run As > Maven Build... then run the goal liberty:run-server.
5. You should see the following in the console: Application JPA Sample started in XX.XX seconds.

Running with Maven

This project can be built with Apache Maven. The project uses Liberty Maven Plug-in to automatically download and install Liberty profile runtime from the Liberty repository. Liberty Maven Plug-in is also used to create, configure, and run the application on the Liberty server.

Use the following steps to run the application with Maven:

1. Execute full Maven build. This will cause Liberty Maven Plug-in to download and install Liberty profile server.

   $ mvn clean install

2. To run the server with the Servlet sample execute:

   $ mvn liberty:run-server

In your browser, enter the URL for the application: http://localhost:9080/jpaApp/ (where port 9080 assumes the httpEndpoint provided in the sample server.xml has not been modified). In your browser, you should see the message Hello JPA World followed by information about the entity being persisted to and retrieved from the database.

Running in Eclipse with Gradle

1. Go to Help > Eclipse Marketplace > Install Buildship Gradle Integration 2.0
2. Clone this project and import into Eclipse as an 'Existing Gradle Project'.
3. Go to Window > Show View > Other > Gradle Executions & Gradle Tasks
4. Go to Gradle Tasks view and run clean in build folder, then build in build folder, then libertyStart in liberty folder.
5. You should see the following in the console: Application JPA Sample started in XX.XX seconds.

Running with Gradle

This project can also be built and run with Gradle. The provided build.gradle file applies the Liberty Gradle Plug-in and is configured to automatically download and install the Liberty Java EE7 Web Profile runtime from Maven Central. The Liberty Gradle Plug-in has built-in tasks that can be used to create, configure, and run the application on the Liberty server.

Use the following steps to run the application with Gradle:

1. Execute the full Gradle build. The Liberty Gradle Plug-in will download and install the Liberty server.

   $ gradle clean build

2. To start the server with the Servlet sample execute:

   $ gradle libertyStart

   Alternatively, execute the run command:

   $ gradle libertyRun --no-daemon

Once the server has started, the application will be available under http://localhost:9080/jpaApp.

3. To stop the server, execute:

   $ gradle libertyStop

Please refer to the ci.gradle repository for documentation about using the Liberty Gradle Plug-in.

Notice

© Copyright IBM Corporation 2017.

License

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.