openjpa-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r945900 - /openjpa/trunk/openjpa-examples/openbooks/index.html
Date Tue, 18 May 2010 21:34:31 GMT
Author: ppoddar
Date: Tue May 18 21:34:31 2010
New Revision: 945900

Update instructions to build


Modified: openjpa/trunk/openjpa-examples/openbooks/index.html
--- openjpa/trunk/openjpa-examples/openbooks/index.html (original)
+++ openjpa/trunk/openjpa-examples/openbooks/index.html Tue May 18 21:34:31 2010
@@ -19,19 +19,49 @@ under the License.
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "">
+<meta name="keywords" content="JPA, OpenJPA, OpenBooks, Sample, Criteria, MetaModel">
+<style type="text/css">
+body {
+h1 {
+h2 {
+font-family:"Times New Roman";
 <h1>OpenBooks: A sample JPA 2.0 Application</h1>
   OpenBooks is a sample (and perhaps simple) application to demonstrate some of the new features
-  version 2.0 of <A HREF="">Java Persistence API</A>
(JPA) specification.
+  version 2.0 of <A HREF="">Java Persistence API</A>
(JPA) specification, such as
+  <LI>Creating dynamic Criteria Query from an input form
+  <LI>Using compound, derived identity and orphan delete for modeling composite relationship
+  <LI>Browsing Persistent Domain Model via MetaModel API
+  <br>
   OpenBooks runs with <A HREF="">OpenJPA</A> as its
JPA provider.
-<h1>Instructions to run OpenBooks Demo</h1>
+<h2>Instructions to download and run OpenBooks Demo</h2>
+   OpenBooks comes with complete source code, build scripts to demonstrate how to build a
typical OpenJPA application
+   and scripts to run OpenBooks in on your local database installation. Follow the simple
instructions below:
    <LI><A href="#Download">Download OpenBooks distribution</A>.
-   <LI><A href="#Install">Install OpenBooks distribution</A>
-   <LI><A href="#Configure">Edit for your local environment</A>
+   <LI><A href="#Build">Build OpenBooks from source</A>
+   <LI><A href="#Configure">Edit for your local environment to run</A>
    <LI><A href="#Load">Populate a Database</A>
    <LI><A href="#Run">Run OpenBooks</A>
@@ -39,8 +69,12 @@ under the License.
 <h2 A name="Download">Download Instructions</A></h2>
    OpenBooks is distributed under <A HREF="">Apache
License, Version 2.0</A>  
-   OpenBooks can be downloaded from <A HREF="">here</A>.
+   OpenBooks can be checked out from OpenJPA repository.
+   <br>
+   <code>$ svn co</code>.
+   will check out the source code and build scripts of OpenBooks in current directory.
    OpenBooks require following software environment to run:
   <LI> Java Runtime version 6.0 or higher
@@ -49,30 +83,26 @@ under the License.
   <LI> Any JDBC complaint database supported by OpenJPA. 
        See <A href="">OpenJPA
documentation</A> for a list of supported databases.
-<h2><A name="Install">Install OpenBooks distribution</A></h2>
-   Unzip <code></code> to a directory. Following instructions assume
this directory as
-   your current directory.<br>
-   The files included in this distribution are:
-   <LI>index.html : the file you are reading 
-   <LI>openbooks.jar : OpenBooks class library 
-   <LI>run.xml : Ant script to run OpenBooks 
-   <LI> : The configuration for your execution environment used by Ant
-   <LI> : The configuration for loading initial data into OpenBooks.
-   <LI> Properties to configure the demonstation GUI.
-   <LI>META-INF/persistence.xml: The configuration for OpenJPA runtime 
-   <LI>slides/: Directory containing the default presentation accompanying this demonstration.
-   <LI>source/: Directory containing the source code for OpenBooks
-   <LI>LICENSE.txt: Apache License
-   <LI>NOTICE.txt: Copyright Notice
-   <br>
-   <p>
-<h2><A name="Configure">Configure OpenBooks for your local environment</A></h2>
+<h2><A name="Build">Build OpenBooks from source</h2>
+   OpenBooks builds with Ant. Before you run a build, configure the build environment by
+    <A HREF=""><code></code></A>.
Essentially you need to point to OpenJPA class library.
+    The file is commented on what is to be edited. Once you have edited <code></code>,
simply issue
+    <br>
+    <code>$ ant package deploy</code>
+    <br>
+    This will compile the source code, generate metamodel classes, enhance the persistence
domain model, package
+    the application and copy it to a <code>target/openbooks</code> directory.
+  <hr>
+<h2><A name="Configure">Edit for your local environment to run</A></h2>
+   Now go to the <em>deploy</em> directory i.e. <code>target/openbooks</code>
-      <LI>Edit <code></code> to specify location of OpenJPA
class libraries and JDBC Driver
-      <LI>Edit <code>META-INF/persistence.xml</code> to specify database
-      <LI>Edit <code></code> to specify load parameters
such as number of Books etc.
+      <LI>Edit <A HREF=""><code></code></A>
to specify location of OpenJPA class libraries and JDBC Driver
+      <LI>Edit <A HREF="META-INF/persistence.xml"><code>META-INF/persistence.xml</code></A>
to specify database properties
+      <LI>Edit <A HREF=""><code></code></A>
to specify load parameters such as number of Books etc.
           This example file has some typical values. If you are satisfied with it, you can
leave them as it is.
@@ -80,6 +110,7 @@ under the License.
   Invoke the Ant script to populate the database.<br>
   <code>$ ant -f run.xml load</code>
 <h2><A name="Run">Run OpenBooks</A></h2> 
   Invoke the Ant script to run OpenBooks<br>
   <code>$ ant -f run.xml run</code>

View raw message