openjpa-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From awh...@apache.org
Subject svn commit: r434517 [3/23] - in /incubator/openjpa/trunk: openjpa-kernel/src/main/java/org/apache/openjpa/meta/ openjpa-lib/src/main/java/org/apache/openjpa/lib/meta/ openjpa-project/src/doc/manual/
Date Thu, 24 Aug 2006 20:41:14 GMT
Modified: incubator/openjpa/trunk/openjpa-project/src/doc/manual/jpa_overview_intro.xml
URL: http://svn.apache.org/viewvc/incubator/openjpa/trunk/openjpa-project/src/doc/manual/jpa_overview_intro.xml?rev=434517&r1=434516&r2=434517&view=diff
==============================================================================
--- incubator/openjpa/trunk/openjpa-project/src/doc/manual/jpa_overview_intro.xml (original)
+++ incubator/openjpa/trunk/openjpa-project/src/doc/manual/jpa_overview_intro.xml Thu Aug
24 13:41:12 2006
@@ -1,57 +1,80 @@
-
-    <chapter id="jpa_overview_intro">
-      <title>Introduction</title>
-      <para><indexterm><primary>EJB3 Persistence</primary><see>EJB</see></indexterm><indexterm><primary>EJB</primary></indexterm>
-  Enterprise Java Beans 3.0 Persistence (EJB persistence) is a specification 
-  from Sun Microsystems for the persistence of Java objects to any relational
-  datastore.  EJB persistence requires J2SE 1.5 (also referred to as "Java 5")
-  or higher, as it makes heavy use of new Java language features such as
-  annotations and generics.  This document provides an overview of EJB 
-  persistence.  Unless otherwise noted, the information presented
-  applies to all EJB persistence implementations.
-  </para>
-      <note>
-        <para>
-    This document describes the Public Draft of the EJB 3.0
-    persistence specification.
+<chapter id="jpa_overview_intro">
+    <title>
+        Introduction
+    </title>
+    <para>
+    <indexterm>
+        <primary>
+            EJB3 Persistence
+        </primary>
+        <see>
+            JPA
+        </see>
+    </indexterm>
+    <indexterm>
+        <primary>
+            JPA
+        </primary>
+    </indexterm>
+The Java Persistence API (JPA) is a specification from
+Sun Microsystems for the persistence of Java objects to any relational
+datastore. JPA requires J2SE 1.5 (also referred to as "Java 5") or
+higher, as it makes heavy use of new Java language features such as annotations
+and generics. This document provides an overview of JPA. Unless
+otherwise noted, the information presented applies to all JPA implementations.
     </para>
+    <note>
         <para>
-    For coverage of OpenJPA's many extensions to the EJB persistence 
-    specification, see the <link linkend="ref_guide_intro">Reference
-    Guide</link>.
-    </para>
-      </note>
-      <section id="jpa_overview_intro_audience">
-        <title>Intended Audience</title>
+For coverage of OpenJPA's many extensions to the JPA specification,
+see the <link linkend="ref_guide_intro">Reference Guide</link>.
+        </para>
+    </note>
+    <section id="jpa_overview_intro_audience">
+        <title>
+            Intended Audience
+        </title>
         <para>
-    This document is intended for developers who want to learn about
-    EJB persistence in order to use it in their applications.
-    It assumes that you have a strong knowledge of object-oriented concepts
-    and Java, including Java 5 annotations and generics.  It also assumes
-    some experience with relational databases and the 
-    Structured Query Language (SQL).
-    </para>
-      </section>
-      <section id="jpa_overview_intro_transpers">
-        <title>Lightweight Persistence</title>
+This document is intended for developers who want to learn about JPA
+in order to use it in their applications. It assumes that you have a strong
+knowledge of object-oriented concepts and Java, including Java 5 annotations and
+generics. It also assumes some experience with relational databases and the
+Structured Query Language (SQL).
+        </para>
+    </section>
+    <section id="jpa_overview_intro_transpers">
+        <title>
+            Lightweight Persistence
+        </title>
         <indexterm zone="jpa_overview_intro_transpers">
-          <primary>lightweight persistence</primary>
+            <primary>
+                lightweight persistence
+            </primary>
         </indexterm>
-        <para><indexterm><primary>persistent data</primary></indexterm><emphasis>Persistent
data</emphasis> is information that can
-    outlive the program that creates it.  The majority of complex
-    programs use persistent data: GUI applications need to store user 
-    preferences across program invocations, web applications track 
-    user movements and orders over long periods of time, etc.
-    </para>
-        <para><emphasis>Lightweight persistence</emphasis> is the storage
and 
-    retrieval of persistent data with little or no work from you, the 
-    developer.  For example, Java serialization<indexterm><primary>serialization</primary></indexterm>
is a form of 
-    lightweight persistence because it can be used to persist Java 
-    objects directly to a file with very little effort.  Serialization's
-    capabilities as a lightweight persistence mechanism pale in 
-    comparison to those provided by EJB, however.  The next
-    chapter compares EJB to serialization and other available
-    persistence mechanisms.
-    </para>
-      </section>
-    </chapter>
+        <para>
+        <indexterm>
+            <primary>
+                persistent data
+            </primary>
+        </indexterm>
+<emphasis>Persistent data</emphasis> is information that can outlive the program
+that creates it. The majority of complex programs use persistent data: GUI
+applications need to store user preferences across program invocations, web
+applications track user movements and orders over long periods of time, etc.
+        </para>
+        <para>
+<emphasis>Lightweight persistence</emphasis> is the storage and retrieval of
+persistent data with little or no work from you, the developer. For example,
+Java serialization
+        <indexterm>
+            <primary>
+                serialization
+            </primary>
+        </indexterm>
+is a form of lightweight persistence because it can be used to persist Java
+objects directly to a file with very little effort. Serialization's capabilities
+as a lightweight persistence mechanism pale in comparison to those provided by
+JPA, however. The next chapter compares JPA to serialization and other available
+persistence mechanisms.
+        </para>
+    </section>
+</chapter>



Mime
View raw message