Difference between revisions of "EclipseLink/Examples/JPARS/Simple"

From Eclipsepedia

Jump to: navigation, search
m (Installation and Configuration)
m (Installation and Configuration)
Line 61: Line 61:
 
     git clone git://git.eclipse.org/gitroot/eclipselink/examples.git
 
     git clone git://git.eclipse.org/gitroot/eclipselink/examples.git
  
3. Configure datasource. Create an XA Datasource connection pool called "'''JPARSStudentDS'''" and define a new&nbsp;JDBC Resource using this connection pool. You can use any of the databases supported by the eclipselink. Your database driver should be place under $GLASSFISH_HOME/glassfish/domains/<your_domain_folder>/lib/ext. Use "Additional Properties" tab to define database URL, User and Password.  <br> <br> [[Image:2013-03-07 12 31 16-.png|Configuring JDBC Connection Pool]] <br> <br> [[Image:JDBC Resource.png|JDBC Resource]] <br>  
+
3. Configure datasource. Create an XA Datasource connection pool called "'''JPARSStudentDS'''" and define a new&nbsp;JDBC Resource using this connection pool. You can use any of the databases supported by the eclipselink. Your database driver should be place under $GLASSFISH_HOME/glassfish/domains/<your_domain_folder>/lib/ext. Use "Additional Properties" (shown below) tab to define database URL, User and Password (and other mandatory properties that the database you use might require).  <br> <br> [[Image:2013-03-07 12 31 16-.png|Configuring JDBC Connection Pool]] <br> <br> [[Image:JDBC Resource.png|JDBC Resource]] <br>  
  
 
<br>  
 
<br>  

Revision as of 16:53, 9 April 2013

Simple Example - student

The "student" example is intended to provide a simple example of using JPA-RS with a single entity persistence unit in a web application.

Environment

The following are the minimal requirements for this example.

Overview

The following steps will be performed in setting up and running this example in your own environment

  1. Installation & Configuration
    • Install Glassfish 3.1.2.2 or later 
    • Check out student example from GIT
    • Database connectivity
    • GlassFish - Datasource configuration
    • Verify config
    • Deploy web application
  2. Running the Example
    • View metadata
    • Create entity
    • Update entity
    • Query entity
    • Delete entity

Installation and Configuration

1. If you are using Glassfish earlier than Glassfish 4.0 (http://dlc.sun.com.edgesuite.net/glassfish/4.0/promoted/) you will need to download newer version of EclipseLink 2.4.2 binaries from  http://www.eclipse.org/eclipselink/downloads/nightly.php (2.4.2 Nightly Build Results) and replace following files under $GLASSFISH_HOME/glassfish/modules with corresponding jars you downloaded above:

  • org.eclipse.persistence.antlr.jar
  • org.eclipse.persistence.jpa.jar
  • org.eclipse.persistence.asm.jar
  • org.eclipse.persistence.jpa.modelgen.jar
  • org.eclipse.persistence.core.jar
  • org.eclipse.persistence.oracle.jar
  • javax.persistence.jar
  • org.eclipse.persistence.dbws.jar
  • org.eclipse.persistence.jpa.jpql.jar


Make sure you clear Glassfish osgi cache by removing the $GLASSFISH_HOME\glassfish\domains\<your_domain>\osgi-cache directory after you replaced the bundles listed above, and before you restart the Glassfish.


Note: If you want to see JPA-RS logs, add a logger for "org.eclipse.persistence.jpars". Currently exceptions are logged at "FINER" log level, so configure the logger to FINER or FINEST. Use Glassfish Admin Console-> Configurations-> default-config-> Logger Settings-> Log Levels tab -> Add Logger to add a logger for the JPA-RS.


2. Clone "examples" from git. The "student" example is stored under student folder.

   git clone git://git.eclipse.org/gitroot/eclipselink/examples.git

3. Configure datasource. Create an XA Datasource connection pool called "JPARSStudentDS" and define a new JDBC Resource using this connection pool. You can use any of the databases supported by the eclipselink. Your database driver should be place under $GLASSFISH_HOME/glassfish/domains/<your_domain_folder>/lib/ext. Use "Additional Properties" (shown below) tab to define database URL, User and Password (and other mandatory properties that the database you use might require).

Configuring JDBC Connection Pool

JDBC Resource


4. Lauch eclipse. Select File->Import->Maven->Existing Maven Projects, hit next and point Root Directory to student folder. Hit finish.


2013-03-07 12 57 52-Java EE - Eclipse Platform.png


5. Build the student project.

6.Configure a server. Click "new server wizard" link on the Servers tab.


Server.png


7. Select GlassFish 3.1.2


Gf.png


8. Enter domain directory, admin name and password based on your installation and hit Finish.


Example domain.png


9. Deploy student.web. Right click on the Glassfish (on Servers tab), select "student.web" in available resources list. Hit Add and Finish.


St deploy.png


Now, you are ready to run the student example. 

Running the Example

Metadata 2.png


      {
          "id": 65,
          "name": "Jane Smith",
          "courses": [
               {
                   "id":101,
                   "name": "math"
               }
          ]
      }


Post.png


Query.png


Delete.png