Clone URL (Committers only):
https://cms.apache.org/redirect?new=anonymous;action=diff;uri=http://openejb.apache.org/examples-trunk%2Fjpa-eclipselink%2FREADME.md

Eduardo GarcĂ­a ([email protected])

Index: trunk/content/examples-trunk/jpa-eclipselink/README.md
===================================================================
--- trunk/content/examples-trunk/jpa-eclipselink/README.md      (revision 
1372678)
+++ trunk/content/examples-trunk/jpa-eclipselink/README.md      (working copy)
@@ -1,9 +1,11 @@
 Title: JPA Eclipselink
 
-*Help us document this example! Click the blue pencil icon in the upper right 
to edit this page.*
+This example shows how to configure `persistence.xml` to work with 
Eclipselink. It uses an `@Entity` class and a `@Stateful` bean to add and 
delete entities from a database.
 
-## Movie
+## Creating the JPA Entity
 
+The entity itself is simply a pojo annotated with `@Entity`.  We create one 
pojo called `Movie` which we can use to hold movie records.
+
     package org.superbiz.eclipselink;
     
     import javax.persistence.Entity;
@@ -57,8 +59,12 @@
     
     }
 
-## Movies
+## Database Operations
 
+This is the bean responsible for database operations; it allows us to persist 
or delete entities.
+For more information we recommend you to see 
http://openejb.apache.org/examples-trunk/injection-of-entitymanager/README.html
+
+
     package org.superbiz.eclipselink;
     
     import javax.ejb.Stateful;
@@ -88,8 +94,12 @@
         }
     }
 
-## persistence.xml
+## Persistence.xml with EclipseLink configuration
 
+This operation is too easy, just set the `provider` to 
`org.eclipse.persistence.jpa.PersistenceProvider` and add additional properties 
to the persistence unit. 
+The example has followed a strategy that allows the creation of tables in a 
HSQL database.
+For a complete list of persistence unit properties see, 
http://www.eclipse.org/eclipselink/api/2.4/org/eclipse/persistence/config/PersistenceUnitProperties.html
+
     <persistence version="1.0"
                  xmlns="http://java.sun.com/xml/ns/persistence";
                  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
@@ -109,6 +119,8 @@
 
 ## MoviesTest
 
+Testing JPA is quite easy, we can simply use the `EJBContainer` API to create 
a container in our test case.
+
     package org.superbiz.eclipselink;
     
     import junit.framework.TestCase;
@@ -150,7 +162,8 @@
 
 # Running
 
-    
+When we run our test case we should see output similar to the following.    
+
     -------------------------------------------------------
      T E S T S
     -------------------------------------------------------

Reply via email to