db-jdo-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From an...@apache.org
Subject svn commit: r586701 - in /db/jdo/site: docs/why_jdo.html xdocs/why_jdo.xml
Date Sat, 20 Oct 2007 10:58:10 GMT
Author: andyj
Date: Sat Oct 20 03:58:10 2007
New Revision: 586701

URL: http://svn.apache.org/viewvc?rev=586701&view=rev
Log:
JDO-539 JPA wording, and "Custom ORM" wording

Modified:
    db/jdo/site/docs/why_jdo.html
    db/jdo/site/xdocs/why_jdo.xml

Modified: db/jdo/site/docs/why_jdo.html
URL: http://svn.apache.org/viewvc/db/jdo/site/docs/why_jdo.html?rev=586701&r1=586700&r2=586701&view=diff
==============================================================================
--- db/jdo/site/docs/why_jdo.html (original)
+++ db/jdo/site/docs/why_jdo.html Sat Oct 20 03:58:10 2007
@@ -7,29 +7,28 @@
             </p><ul>
                 <li>If your datastore is RDBMS you can handle the persistence (and
retrieval) of data yourself
                     using <B>JDBC</B>. Obviously with this route you have the
burden of having to write the 
-                    persistence layer yourself, but this gives much control, but also creates
significant work,
+                    persistence layer yourself. This gives much control, but also creates
significant work,
                     both in writing the code but also in testing and maintenance.</li>
-                <li>You can use <B>JDO</B>, a standardised persistence
interface. With <b>JDO</b> you can develop
+                <li>You can use <B>JDO</B>, a standardised persistence
API. With <b>JDO</b> you can develop
                     plain old java objects (POJOs) and persist them as they are transparently.
This requires
                     very little work from the developer. It allows persistence to any type
of datastore in
                     principle, being designed with flexibility and datastore agnositicity
in mind.
-                    This has been a standard since 2001 (JDO1), being upgraded in 2006 (JDO2)
and
-                    is being developed further currently (JDO2.1)</li>
-                <li>You can use <B>JPA1</B>, a part of the EJB3 specification.
This also allows you to develop
-                    plain old Java objects (POJOs) and persist them using a standardised
API. It's specification
+                    This has been a standard since 2002 (JDO1), being upgraded in 2006 (JDO2)
and
+                    is in the process of being developed further (JDO2.1) by Apache JDO</li>
+                <li>You can use <B>JPA1</B>, a standardised persistence
API, and part of the EJB3 specification. This also allows you to
+                    to develop plain old Java objects (POJOs) and persist them using a standardised
API. It's specification
                     is not as mature or as feature rich as the JDO API, nor does it provide
the flexibility
                     of using any type of datastore. This was released in 2006 (JPA1) to supercede
EJB2</li>
                 <li><i>If you are stuck with using an EJB2.* architecture you
could use Entity Beans. This 
                     means that you hand off your objects to the EJB part of the J2EE server.
This simplifies 
                     things for the developer in some respect but places major restrictions
in that your objects 
                     have to be Entity Beans.</i></li>
-                <li>You can also use a proprietary persistence API. The disadvantages
of going this route 
-                    are that you cannot easily swap to an alternative implementation of the
API if you hit
-                    problems with your software choice.</li>
+                <li>You can also use a proprietary persistence API (e.g Hibernates
own API, TopLinks own API, iBatis, Castor etc).
+                    The disadvantages of going this route are that you cannot easily swap
to an alternative
+                    implementation of the API if you hit problems with your software choice.</li>
             </ul><p>
                 To give a <I>guide</I>, here are a few important consideration
points when choosing a persistence layer for your application.
-            </p><table class="bodyTable"><tr class="b"><th>Feature</th><th
width="100">JDBC</th><th width="100">JDO</th><th width="100">JPA</th><th
width="100">EJB2</th><th width="100">Custom ORM (1)</th></tr><tr
class="a"><td>Standards-Driven</td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_error_sml.gif"
border="0" alt=""></img></td></tr><tr class="b"><td>Choice
of datastores</td><td><img src="images/icon_error_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_error_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_error_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0"
  alt=""></img></td></tr><tr class="a"><td>Support POJOs</td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_error_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td></tr><tr
class="b"><td>Usable in J2SE</td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_error_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td></tr><tr class="a"><td>Usable
in J2EE</td><td><img src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt
 =""></img></td><td><img src="images/icon_success_sml.gif" border="0"
alt=""></img></td><td><img src="images/icon_success_sml.gif" border="0"
alt=""></img></td><td><img src="images/icon_success_sml.gif" border="0"
alt=""></img></td></tr><tr class="b"><td>Out of box implementation
(2)</td><td><img src="images/icon_error_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_error_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td></tr><tr
class="a"><td>Simple to unit test</td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_error_sml.gif"
border="0" alt=""></img></td><td><img src
 ="images/icon_success_sml.gif" border="0" alt=""></img></td></tr><tr
class="b"><td>Dynamic queries</td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img> (3)</td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_error_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td></tr><tr class="a"><td>Comprehensive
ORM</td><td><img src="images/icon_warning_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_warning_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_error_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td></tr><tr
class="b"><td>Primary Key generation</td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img> (3)
 </td><td><img src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td></tr><tr
class="a"><td>Supports inherited objects</td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img> (3)</td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td></tr><tr class="b"><td>Schema
Creation</td><td><img src="images/icon_error_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/
 icon_success_sml.gif" border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td></tr><tr class="a"><td>Existing
schema</td><td><img src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td></tr></table><ol>
-                <li>refers to proprietary APIs of products such as Hibernate, TopLink,
Castor, iBatis.</li>
+            </p><table class="bodyTable"><tr class="b"><th>Feature</th><th
width="100">JDBC</th><th width="100">JDO</th><th width="100">JPA</th><th
width="100">EJB2</th><th width="100">Custom ORM</th></tr><tr
class="a"><td>Standards-Driven</td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_error_sml.gif"
border="0" alt=""></img></td></tr><tr class="b"><td>Choice
of datastores</td><td><img src="images/icon_error_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_error_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_error_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt
 =""></img></td></tr><tr class="a"><td>Support POJOs</td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_error_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td></tr><tr
class="b"><td>Usable in J2SE</td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_error_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td></tr><tr class="a"><td>Usable
in J2EE</td><td><img src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt="">
 </img></td><td><img src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td></tr><tr
class="b"><td>Out of box implementation (1)</td><td><img src="images/icon_error_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_error_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td></tr><tr class="a"><td>Simple
to unit test</td><td><img src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_error_sml.gif" border="0" alt=""></img></td><td><img
src="im
 ages/icon_success_sml.gif" border="0" alt=""></img></td></tr><tr
class="b"><td>Dynamic queries</td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img> (2)</td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_error_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td></tr><tr class="a"><td>Comprehensive
ORM</td><td><img src="images/icon_warning_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_warning_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_error_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td></tr><tr
class="b"><td>Primary Key generation</td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img> (2)</td
 ><td><img src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td></tr><tr
class="a"><td>Supports inherited objects</td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img> (2)</td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td></tr><tr class="b"><td>Schema
Creation</td><td><img src="images/icon_error_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon
 _success_sml.gif" border="0" alt=""></img></td><td><img src="images/icon_success_sml.gif"
border="0" alt=""></img></td></tr><tr class="a"><td>Existing
schema</td><td><img src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td><td><img
src="images/icon_success_sml.gif" border="0" alt=""></img></td></tr></table><ol>
                 <li>refers to whether it is necessary to write the persistence yourself
(e.g as with JDBC) or 
                     whether you can just persist by simple calls.</li>
                 <li>requires the developer to write this layer.</li>

Modified: db/jdo/site/xdocs/why_jdo.xml
URL: http://svn.apache.org/viewvc/db/jdo/site/xdocs/why_jdo.xml?rev=586701&r1=586700&r2=586701&view=diff
==============================================================================
--- db/jdo/site/xdocs/why_jdo.xml (original)
+++ db/jdo/site/xdocs/why_jdo.xml Sat Oct 20 03:58:10 2007
@@ -13,25 +13,25 @@
             <ul>
                 <li>If your datastore is RDBMS you can handle the persistence (and
retrieval) of data yourself
                     using <B>JDBC</B>. Obviously with this route you have the
burden of having to write the 
-                    persistence layer yourself, but this gives much control, but also creates
significant work,
+                    persistence layer yourself. This gives much control, but also creates
significant work,
                     both in writing the code but also in testing and maintenance.</li>
-                <li>You can use <B>JDO</B>, a standardised persistence
interface. With <b>JDO</b> you can develop
+                <li>You can use <B>JDO</B>, a standardised persistence
API. With <b>JDO</b> you can develop
                     plain old java objects (POJOs) and persist them as they are transparently.
This requires
                     very little work from the developer. It allows persistence to any type
of datastore in
                     principle, being designed with flexibility and datastore agnositicity
in mind.
-                    This has been a standard since 2001 (JDO1), being upgraded in 2006 (JDO2)
and
-                    is being developed further currently (JDO2.1)</li>
-                <li>You can use <B>JPA1</B>, a part of the EJB3 specification.
This also allows you to develop
-                    plain old Java objects (POJOs) and persist them using a standardised
API. It's specification
+                    This has been a standard since 2002 (JDO1), being upgraded in 2006 (JDO2)
and
+                    is in the process of being developed further (JDO2.1) by Apache JDO</li>
+                <li>You can use <B>JPA1</B>, a standardised persistence
API, and part of the EJB3 specification. This also allows you to
+                    to develop plain old Java objects (POJOs) and persist them using a standardised
API. It's specification
                     is not as mature or as feature rich as the JDO API, nor does it provide
the flexibility
                     of using any type of datastore. This was released in 2006 (JPA1) to supercede
EJB2</li>
                 <li><i>If you are stuck with using an EJB2.* architecture you
could use Entity Beans. This 
                     means that you hand off your objects to the EJB part of the J2EE server.
This simplifies 
                     things for the developer in some respect but places major restrictions
in that your objects 
                     have to be Entity Beans.</i></li>
-                <li>You can also use a proprietary persistence API. The disadvantages
of going this route 
-                    are that you cannot easily swap to an alternative implementation of the
API if you hit
-                    problems with your software choice.</li>
+                <li>You can also use a proprietary persistence API (e.g Hibernates
own API, TopLinks own API, iBatis, Castor etc).
+                    The disadvantages of going this route are that you cannot easily swap
to an alternative
+                    implementation of the API if you hit problems with your software choice.</li>
             </ul>
             <p>
                 To give a <I>guide</I>, here are a few important consideration
points when choosing a persistence layer for your application.
@@ -44,7 +44,7 @@
                     <th width="100">JDO</th>
                     <th width="100">JPA</th>
                     <th width="100">EJB2</th>
-                    <th width="100">Custom ORM (1)</th>
+                    <th width="100">Custom ORM</th>
                 </tr>
                 <tr>
                     <td>Standards-Driven</td>
@@ -87,7 +87,7 @@
                     <td><img src="images/icon_success_sml.gif" border="0"/></td>
                 </tr>
                 <tr>
-                    <td>Out of box implementation (2)</td>
+                    <td>Out of box implementation (1)</td>
                     <td><img src="images/icon_error_sml.gif" border="0"/></td>
                     <td><img src="images/icon_success_sml.gif" border="0"/></td>
                     <td><img src="images/icon_success_sml.gif" border="0"/></td>
@@ -104,7 +104,7 @@
                 </tr>
                 <tr>
                     <td>Dynamic queries</td>
-                    <td><img src="images/icon_success_sml.gif" border="0"/> (3)</td>
+                    <td><img src="images/icon_success_sml.gif" border="0"/> (2)</td>
                     <td><img src="images/icon_success_sml.gif" border="0"/></td>
                     <td><img src="images/icon_success_sml.gif" border="0"/></td>
                     <td><img src="images/icon_error_sml.gif" border="0"/></td>
@@ -120,7 +120,7 @@
                 </tr>
                 <tr>
                     <td>Primary Key generation</td>
-                    <td><img src="images/icon_success_sml.gif" border="0"/> (3)</td>
+                    <td><img src="images/icon_success_sml.gif" border="0"/> (2)</td>
                     <td><img src="images/icon_success_sml.gif" border="0"/></td>
                     <td><img src="images/icon_success_sml.gif" border="0"/></td>
                     <td><img src="images/icon_success_sml.gif" border="0"/></td>
@@ -128,7 +128,7 @@
                 </tr>
                 <tr>
                     <td>Supports inherited objects</td>
-                    <td><img src="images/icon_success_sml.gif" border="0"/> (3)</td>
+                    <td><img src="images/icon_success_sml.gif" border="0"/> (2)</td>
                     <td><img src="images/icon_success_sml.gif" border="0"/></td>
                     <td><img src="images/icon_success_sml.gif" border="0"/></td>
                     <td><img src="images/icon_success_sml.gif" border="0"/></td>
@@ -152,7 +152,6 @@
                 </tr>
             </table>
             <ol>
-                <li>refers to proprietary APIs of products such as Hibernate, TopLink,
Castor, iBatis.</li>
                 <li>refers to whether it is necessary to write the persistence yourself
(e.g as with JDBC) or 
                     whether you can just persist by simple calls.</li>
                 <li>requires the developer to write this layer.</li>



Mime
View raw message