db-jdo-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From an...@apache.org
Subject svn commit: r581559 [4/4] - in /db/jdo/site: docs/ docs/guides/ docs/images/ docs/releases/ xdocs/ xdocs/images/
Date Wed, 03 Oct 2007 10:29:51 GMT
Added: db/jdo/site/docs/state_transition.html
URL: http://svn.apache.org/viewvc/db/jdo/site/docs/state_transition.html?rev=581559&view=auto
==============================================================================
--- db/jdo/site/docs/state_transition.html (added)
+++ db/jdo/site/docs/state_transition.html Wed Oct  3 03:29:44 2007
@@ -0,0 +1,85 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Java Data Objects (JDO) - JDO State Transitions</title><style type="text/css" media="all">
+          @import url("./style/maven-base.css");
+          
+			    @import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://db.apache.org/jdo" id="projectLogo"><img alt="Java Data Objects (JDO)" src="./images/JDOx120.gif"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuGeneral"><h5>General</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="none"><a href="why_jdo.html">Why JDO?</a></li><li class="none"><a href="jdo_v_jpa.html">JDO v JPA</a></li><li class="none"><a href="jdo_v_jpa_orm.html">JDO v JPA : ORM</a></li><li class="none"><a href="downloads.html">Downloads</a></li><li class="none"><a href="http://www.apache.org/licenses/LICENSE-2.0" class="externalLink"
  title="External Link">License</a></li></ul></div><br></br><div id="menuJDO_Implementation"><h5>JDO Implementation</h5><ul><li class="none"><a href="specifications.html">Specifications</a></li><li class="none"><a href="tck.html">TCK</a></li></ul></div><br></br><div id="menuJDO_Usage"><h5>JDO Usage</h5><ul><li class="none"><a href="impls.html">Implementations</a></li><li class="none"><a href="javadoc.html">API Javadoc</a></li><li class="none"><a href="class_types.html">Types of Classes</a></li><li class="none"><a href="enhancement.html">Bytecode Enhancement</a></li><li class="none"><a href="jdohelper.html">JDOHelper</a></li><li class="none"><a href="exceptions.html">Exceptions</a></li><li class="collapsed"><a href="metadata.html">MetaData</a></li><li class="none"><strong><a href="state_transition.html">Object States</a></strong></li><li class="collapsed"><a href="guides.html">Guides</a></li><li class="none"><a href="references.html">References</a></li><li class="none"><a href
 ="glossary.html">Glossary</a></li></ul></div><br></br><div id="menuCommunity"><h5>Community</h5><ul><li class="none"><a href="get-involved.html">Get Involved</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="faq.html">FAQ</a></li><li class="none"><a href="http://wiki.apache.org/jdo" class="externalLink" title="External Link">Wiki</a></li></ul></div><br></br><div id="menuDevelopment"><h5>Development</h5><ul><li class="none"><a href="roadmap.html">RoadMap / TODO</a></li><li class="none"><a href="svn.html">Source Code</a></li><li class="none"><a href="http://cwiki.apache.org/GMOxDEV/coding-standards.html" class="externalLink" title="External Link">Coding Standards</a></li><li class="none"><a href="issuetracking.html">Issue Tracking</a></li><li class="none"><a href="dependencies.html">Dependencies</a></li></ul></div><br></br></div></div><div id="bodyColumn"><div class=
 "contentBox"><div class="section"><a name="JDO_State_Transition"></a><h2>JDO State Transition</h2><p>
+                JDO manages the lifecycle of an object, from creation (<B>Transient</B>) through to persistence in the datastore (<B>Hollow</B>, <B>Persistent Clean</B>) and all of the various states between these. The transition between these states are achieved by using methods on the Persistence Manager such as <I>makePersistent()</I>, <I>makeTransient()</I>, <I>deletePersistent()</I>, and by commiting the changes made by these operations, or by rolling them back.
+            </p><p>
+                The various lifecycle states supported by JDO are shown below.
+            </p><table class="bodyTable"><tr class="a"><th>Name</th><th>Description</th></tr><tr class="b"><td>Transient</td><td>Any object created by the developer that do are not persisted. These don't have a JDO identity.</td></tr><tr class="a"><td>Persistent New</td><td>Any object that is newly persisted in the current transaction. A JDO identity has been assigned to these objects.</td></tr><tr class="b"><td>Persistent Dirty</td><td>Any persistent object that has been changed in the current transaction.</td></tr><tr class="a"><td>Hollow</td><td>Any persistent object that represents data in the datastore, but whose values are not in the instance.</td></tr><tr class="b"><td>Persistent Clean</td><td>Any persistent object that represents data in the datastore, and whose values have not been changed in the current transaction.</td></tr><tr class="a"><td>Persistent Deleted</td><td>Any persistent object that represents data in the datastore, and that has been deleted in the cur
 rent transaction.</td></tr><tr class="b"><td>Persistent New Deleted</td><td>Any object that have been newly made persistent and then deleted in the same current transaction.</td></tr><tr class="a"><td>Persistent Non transactional</td><td>Any persistent object that represents data in the datastore, whose values are loaded but not transactionally consistent.</td></tr><tr class="b"><td>Persistent Non transactional Dirty</td><td>Any persistent object that represents data in the datastore, whose values are loaded but not transactionally consistent, and that has been modified.</td></tr><tr class="a"><td>Transient Clean</td><td>Any transient object that represents a transactional instance whose values have not been changed in the current transaction.</td></tr><tr class="b"><td>Transient Dirty</td><td>Any transient object that represents a transactional instance whose values have been changed in the current transaction.</td></tr><tr class="a"><td>Detached Clean</td><td>Any detached 
 object that represents a persistent instance whose values have not been changed since detaching.</td></tr><tr class="b"><td>Detached Dirty</td><td>Any detached object that represents a persistent instance whose values have been changed since detaching.</td></tr></table><div class="subsection"><a name="Detecting_Object_State"></a><h3>Detecting Object State</h3><p>
+                    JDO provides a class <a href="jdohelper.html">JDOHelper</a> that allows you to interrogate the object state via its attributes (isPersistent(), isDeleted(), etc).
+                    In JDO 2.1 for JDKs 1.5+ <i>JDOHelper</i> is extended to also provide a method that gives the full object state.
+                </p>
+    <div class="source"><pre>ObjectState state = JDOHelper.getObjectState(obj);</pre></div>
+  <br></br></div><div class="subsection"><a name="Persisting_an_object"></a><h3>Persisting an object</h3><p>
+                    The most basic thing you can do with JDO is persist an object. The following code is an example of how you can do this
+                </p>
+    <div class="source"><pre>
+Transaction tx=pm.currentTransaction();
+try
+{
+    tx.begin();
+    Product product = new Product("Plate", 9.99);
+    pm.makePersistent(product);
+    tx.commit();
+}
+finally
+{
+    if (tx.isActive())
+    {
+        tx.rollback();
+    }
+}
+                </pre></div>
+  <p>
+                    The <I>Product</I> object progresses from <B>Transient</B> (initial, unpersisted state), through to <B>Persistent New</B>, and then finally to <B>Hollow</B> when it reaches the data store (after the "commit"). If the persist failed, it would "rollback" and hence end up in the same state as when it started. The following diagram shows this graphically
+                </p><br></br><img src="images/state_transition_persist.gif" alt=""></img><br></br></div><div class="subsection"><a name="Updating_an_object"></a><h3>Updating an object</h3><p>
+                    When you have persisted objects you need to update them. The following code is an example of how you can do this
+                </p>
+    <div class="source"><pre>
+Transaction tx=pm.currentTransaction();
+try
+{
+    tx.begin();
+    String product_name = product.getName();
+    ...
+    product.setPrice(7.50);
+    tx.commit();
+}
+finally
+{
+    if (tx.isActive())
+    {
+        tx.rollback();
+    }
+}
+                </pre></div>
+  <p>
+                    The <I>Product</I> object starts off in <B>Hollow</B> state and progresses to <B>Persistent Clean</B> when the user requires to read from it. It then migrates to <B>Persistent Dirty</B> when the price is updated. Finally it returns to <B>Hollow</B> when the user commits/rolls back the transaction. The following diagram shows this graphically
+                </p><br></br><img src="images/state_transition_update.gif" alt=""></img><br></br></div><div class="subsection"><a name="Deleting_an_object"></a><h3>Deleting an object</h3><p>
+                    When you no longer need an object persisted, you can delete it. The following code is an example of how you can do this
+                </p>
+    <div class="source"><pre>
+Transaction tx=pm.currentTransaction();
+try
+{
+    tx.begin();
+    String product_name = product.getName();
+    ...
+    pm.deletePersistent(product);
+    tx.commit();
+}
+finally
+{
+    if (tx.isActive())
+    {
+        tx.rollback();
+    }
+}
+                </pre></div>
+  <p>
+                    The <I>Product</I> object starts off in <B>Hollow</B> state and progresses to <B>Persistent Clean</B> when the user requires to read from it. It then migrates to <B>Persistent Deleted</B> when the deletePersistent() called. Finally it either progresses to <B>Transient</B> when commit is called, or returns to <B>Hollow</B> if it is rolled back. The following diagram shows this graphically
+                </p><br></br><img src="images/state_transition_delete.gif" alt=""></img><br></br></div><div class="subsection"><a name="Possible_state_transitions"></a><h3>Possible state transitions</h3><p>
+                    The following diagram shows the state transitions possible with JDO and JPOX.
+                </p><br></br><img src="images/state_transition.gif" border="0" alt="JDO State Transition"></img><br></br></div></div></div></div><div class="clear"><hr></hr></div><table border="0" width="100%" cellpadding="0" cellspacing="0"><tr><td width="100%"><img height="1" border="0" width="100%" src="./images/header_line.gif"></img></td></tr></table><div id="footer"><div class="xleft">
+                Documentation published: 03 October 2007<br></br>
+                  © 2005-2007 <a href="http://www.apache.org/">Apache Software Foundation</a></div></div></body></html>
\ No newline at end of file

Modified: db/jdo/site/docs/svn.html
URL: http://svn.apache.org/viewvc/db/jdo/site/docs/svn.html?rev=581559&r1=581558&r2=581559&view=diff
==============================================================================
--- db/jdo/site/docs/svn.html (original)
+++ db/jdo/site/docs/svn.html Wed Oct  3 03:29:44 2007
@@ -1,7 +1,7 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Java Data Objects (JDO) - Source Code</title><style type="text/css" media="all">
           @import url("./style/maven-base.css");
           
-			    @import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta><meta name="author" content="JDO Documentation Team"></meta><meta name="email" content="jdo-dev@db.apache.org"></meta></head><body class="composite"><div id="banner"><a href="http://db.apache.org/jdo" id="projectLogo"><img alt="Java Data Objects (JDO)" src="./images/JDOx120.gif"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuGeneral"><h5>General</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="none"><a href="why_jdo.html">Why JDO?</a></li><li class="none"><a href="jdo_v_jpa.html">JDO v JPA</a></li><li class="none"><a href="jdo_v_jpa_orm.html">JDO v JPA : ORM</a></li><li class="none"><a href="downlo
 ads.html">Downloads</a></li><li class="none"><a href="http://www.apache.org/licenses/LICENSE-2.0" class="externalLink" title="External Link">License</a></li></ul></div><br></br><div id="menuJDO_Implementation"><h5>JDO Implementation</h5><ul><li class="none"><a href="specifications.html">Specifications</a></li><li class="none"><a href="tck.html">TCK</a></li></ul></div><br></br><div id="menuJDO_Usage"><h5>JDO Usage</h5><ul><li class="none"><a href="impls.html">Implementations</a></li><li class="none"><a href="javadoc.html">API Javadoc</a></li><li class="none"><a href="class_types.html">Types of Classes</a></li><li class="none"><a href="enhancement.html">Bytecode Enhancement</a></li><li class="none"><a href="jdohelper.html">JDOHelper</a></li><li class="none"><a href="exceptions.html">Exceptions</a></li><li class="collapsed"><a href="metadata.html">MetaData</a></li><li class="collapsed"><a href="guides.html">Guides</a></li><li class="none"><a href="references.html">References</a
 ></li><li class="none"><a href="glossary.html">Glossary</a></li></ul></div><br></br><div id="menuCommunity"><h5>Community</h5><ul><li class="none"><a href="get-involved.html">Get Involved</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="faq.html">FAQ</a></li><li class="none"><a href="http://wiki.apache.org/jdo" class="externalLink" title="External Link">Wiki</a></li></ul></div><br></br><div id="menuDevelopment"><h5>Development</h5><ul><li class="none"><a href="roadmap.html">RoadMap / TODO</a></li><li class="none"><strong><a href="svn.html">Source Code</a></strong></li><li class="none"><a href="http://cwiki.apache.org/GMOxDEV/coding-standards.html" class="externalLink" title="External Link">Coding Standards</a></li><li class="none"><a href="issuetracking.html">Issue Tracking</a></li><li class="none"><a href="dependencies.html">Dependencies</a></li></ul></div><br></
 br></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Source_Code_Version_Control"></a><h2>Source Code Version Control</h2><p>Apache JDO uses <a rel="nofollow" href="http://subversion.tigris.org" class="externalLink" title="External Link">Subversion</a> to manage its source code.
+			    @import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta><meta name="author" content="JDO Documentation Team"></meta><meta name="email" content="jdo-dev@db.apache.org"></meta></head><body class="composite"><div id="banner"><a href="http://db.apache.org/jdo" id="projectLogo"><img alt="Java Data Objects (JDO)" src="./images/JDOx120.gif"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuGeneral"><h5>General</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="none"><a href="why_jdo.html">Why JDO?</a></li><li class="none"><a href="jdo_v_jpa.html">JDO v JPA</a></li><li class="none"><a href="jdo_v_jpa_orm.html">JDO v JPA : ORM</a></li><li class="none"><a href="downlo
 ads.html">Downloads</a></li><li class="none"><a href="http://www.apache.org/licenses/LICENSE-2.0" class="externalLink" title="External Link">License</a></li></ul></div><br></br><div id="menuJDO_Implementation"><h5>JDO Implementation</h5><ul><li class="none"><a href="specifications.html">Specifications</a></li><li class="none"><a href="tck.html">TCK</a></li></ul></div><br></br><div id="menuJDO_Usage"><h5>JDO Usage</h5><ul><li class="none"><a href="impls.html">Implementations</a></li><li class="none"><a href="javadoc.html">API Javadoc</a></li><li class="none"><a href="class_types.html">Types of Classes</a></li><li class="none"><a href="enhancement.html">Bytecode Enhancement</a></li><li class="none"><a href="jdohelper.html">JDOHelper</a></li><li class="none"><a href="exceptions.html">Exceptions</a></li><li class="collapsed"><a href="metadata.html">MetaData</a></li><li class="none"><a href="state_transition.html">Object States</a></li><li class="collapsed"><a href="guides.html">
 Guides</a></li><li class="none"><a href="references.html">References</a></li><li class="none"><a href="glossary.html">Glossary</a></li></ul></div><br></br><div id="menuCommunity"><h5>Community</h5><ul><li class="none"><a href="get-involved.html">Get Involved</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="faq.html">FAQ</a></li><li class="none"><a href="http://wiki.apache.org/jdo" class="externalLink" title="External Link">Wiki</a></li></ul></div><br></br><div id="menuDevelopment"><h5>Development</h5><ul><li class="none"><a href="roadmap.html">RoadMap / TODO</a></li><li class="none"><strong><a href="svn.html">Source Code</a></strong></li><li class="none"><a href="http://cwiki.apache.org/GMOxDEV/coding-standards.html" class="externalLink" title="External Link">Coding Standards</a></li><li class="none"><a href="issuetracking.html">Issue Tracking</a></li><li class="n
 one"><a href="dependencies.html">Dependencies</a></li></ul></div><br></br></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Source_Code_Version_Control"></a><h2>Source Code Version Control</h2><p>Apache JDO uses <a rel="nofollow" href="http://subversion.tigris.org" class="externalLink" title="External Link">Subversion</a> to manage its source code.
 If you're new to Subversion, you can check out the
 <a href="http://svnbook.red-bean.com/" class="externalLink" title="External Link">online book</a> about Subversion.
 Note that we are currently using Subversion 1.1.x (there are separate

Modified: db/jdo/site/docs/tck.html
URL: http://svn.apache.org/viewvc/db/jdo/site/docs/tck.html?rev=581559&r1=581558&r2=581559&view=diff
==============================================================================
--- db/jdo/site/docs/tck.html (original)
+++ db/jdo/site/docs/tck.html Wed Oct  3 03:29:44 2007
@@ -1,7 +1,7 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Java Data Objects (JDO) - TCK</title><style type="text/css" media="all">
           @import url("./style/maven-base.css");
           
-			    @import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta><meta name="author" content="JDO Documentation Team"></meta><meta name="email" content="jdo-dev@db.apache.org"></meta></head><body class="composite"><div id="banner"><a href="http://db.apache.org/jdo" id="projectLogo"><img alt="Java Data Objects (JDO)" src="./images/JDOx120.gif"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuGeneral"><h5>General</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="none"><a href="why_jdo.html">Why JDO?</a></li><li class="none"><a href="jdo_v_jpa.html">JDO v JPA</a></li><li class="none"><a href="jdo_v_jpa_orm.html">JDO v JPA : ORM</a></li><li class="none"><a href="downlo
 ads.html">Downloads</a></li><li class="none"><a href="http://www.apache.org/licenses/LICENSE-2.0" class="externalLink" title="External Link">License</a></li></ul></div><br></br><div id="menuJDO_Implementation"><h5>JDO Implementation</h5><ul><li class="none"><a href="specifications.html">Specifications</a></li><li class="none"><strong><a href="tck.html">TCK</a></strong></li></ul></div><br></br><div id="menuJDO_Usage"><h5>JDO Usage</h5><ul><li class="none"><a href="impls.html">Implementations</a></li><li class="none"><a href="javadoc.html">API Javadoc</a></li><li class="none"><a href="class_types.html">Types of Classes</a></li><li class="none"><a href="enhancement.html">Bytecode Enhancement</a></li><li class="none"><a href="jdohelper.html">JDOHelper</a></li><li class="none"><a href="exceptions.html">Exceptions</a></li><li class="collapsed"><a href="metadata.html">MetaData</a></li><li class="collapsed"><a href="guides.html">Guides</a></li><li class="none"><a href="references.ht
 ml">References</a></li><li class="none"><a href="glossary.html">Glossary</a></li></ul></div><br></br><div id="menuCommunity"><h5>Community</h5><ul><li class="none"><a href="get-involved.html">Get Involved</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="faq.html">FAQ</a></li><li class="none"><a href="http://wiki.apache.org/jdo" class="externalLink" title="External Link">Wiki</a></li></ul></div><br></br><div id="menuDevelopment"><h5>Development</h5><ul><li class="none"><a href="roadmap.html">RoadMap / TODO</a></li><li class="none"><a href="svn.html">Source Code</a></li><li class="none"><a href="http://cwiki.apache.org/GMOxDEV/coding-standards.html" class="externalLink" title="External Link">Coding Standards</a></li><li class="none"><a href="issuetracking.html">Issue Tracking</a></li><li class="none"><a href="dependencies.html">Dependencies</a></li></ul></div><br></
 br></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="About_the_Technology_Compatibility_Kit"></a><h2>About the Technology Compatibility Kit</h2><p>
+			    @import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta><meta name="author" content="JDO Documentation Team"></meta><meta name="email" content="jdo-dev@db.apache.org"></meta></head><body class="composite"><div id="banner"><a href="http://db.apache.org/jdo" id="projectLogo"><img alt="Java Data Objects (JDO)" src="./images/JDOx120.gif"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuGeneral"><h5>General</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="none"><a href="why_jdo.html">Why JDO?</a></li><li class="none"><a href="jdo_v_jpa.html">JDO v JPA</a></li><li class="none"><a href="jdo_v_jpa_orm.html">JDO v JPA : ORM</a></li><li class="none"><a href="downlo
 ads.html">Downloads</a></li><li class="none"><a href="http://www.apache.org/licenses/LICENSE-2.0" class="externalLink" title="External Link">License</a></li></ul></div><br></br><div id="menuJDO_Implementation"><h5>JDO Implementation</h5><ul><li class="none"><a href="specifications.html">Specifications</a></li><li class="none"><strong><a href="tck.html">TCK</a></strong></li></ul></div><br></br><div id="menuJDO_Usage"><h5>JDO Usage</h5><ul><li class="none"><a href="impls.html">Implementations</a></li><li class="none"><a href="javadoc.html">API Javadoc</a></li><li class="none"><a href="class_types.html">Types of Classes</a></li><li class="none"><a href="enhancement.html">Bytecode Enhancement</a></li><li class="none"><a href="jdohelper.html">JDOHelper</a></li><li class="none"><a href="exceptions.html">Exceptions</a></li><li class="collapsed"><a href="metadata.html">MetaData</a></li><li class="none"><a href="state_transition.html">Object States</a></li><li class="collapsed"><a hr
 ef="guides.html">Guides</a></li><li class="none"><a href="references.html">References</a></li><li class="none"><a href="glossary.html">Glossary</a></li></ul></div><br></br><div id="menuCommunity"><h5>Community</h5><ul><li class="none"><a href="get-involved.html">Get Involved</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="faq.html">FAQ</a></li><li class="none"><a href="http://wiki.apache.org/jdo" class="externalLink" title="External Link">Wiki</a></li></ul></div><br></br><div id="menuDevelopment"><h5>Development</h5><ul><li class="none"><a href="roadmap.html">RoadMap / TODO</a></li><li class="none"><a href="svn.html">Source Code</a></li><li class="none"><a href="http://cwiki.apache.org/GMOxDEV/coding-standards.html" class="externalLink" title="External Link">Coding Standards</a></li><li class="none"><a href="issuetracking.html">Issue Tracking</a></li><li class="n
 one"><a href="dependencies.html">Dependencies</a></li></ul></div><br></br></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="About_the_Technology_Compatibility_Kit"></a><h2>About the Technology Compatibility Kit</h2><p>
     In order to demonstrate compliance with the Java Data Objects specification,
     an implementation must pass all of the tests in the 
     Technology Compatibility Kit (TCK).

Modified: db/jdo/site/docs/team-list.html
URL: http://svn.apache.org/viewvc/db/jdo/site/docs/team-list.html?rev=581559&r1=581558&r2=581559&view=diff
==============================================================================
--- db/jdo/site/docs/team-list.html (original)
+++ db/jdo/site/docs/team-list.html Wed Oct  3 03:29:44 2007
@@ -1,7 +1,7 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Java Data Objects (JDO) - Project Team</title><style type="text/css" media="all">
           @import url("./style/maven-base.css");
           
-			    @import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta><meta name="author" content="Apache JDO Development Team"></meta><meta name="email" content="jdo-dev@db.apache.org"></meta></head><body class="composite"><div id="banner"><a href="http://db.apache.org/jdo" id="projectLogo"><img alt="Java Data Objects (JDO)" src="./images/JDOx120.gif"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuGeneral"><h5>General</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="none"><a href="why_jdo.html">Why JDO?</a></li><li class="none"><a href="jdo_v_jpa.html">JDO v JPA</a></li><li class="none"><a href="jdo_v_jpa_orm.html">JDO v JPA : ORM</a></li><li class="none"><a href="d
 ownloads.html">Downloads</a></li><li class="none"><a href="http://www.apache.org/licenses/LICENSE-2.0" class="externalLink" title="External Link">License</a></li></ul></div><br></br><div id="menuJDO_Implementation"><h5>JDO Implementation</h5><ul><li class="none"><a href="specifications.html">Specifications</a></li><li class="none"><a href="tck.html">TCK</a></li></ul></div><br></br><div id="menuJDO_Usage"><h5>JDO Usage</h5><ul><li class="none"><a href="impls.html">Implementations</a></li><li class="none"><a href="javadoc.html">API Javadoc</a></li><li class="none"><a href="class_types.html">Types of Classes</a></li><li class="none"><a href="enhancement.html">Bytecode Enhancement</a></li><li class="none"><a href="jdohelper.html">JDOHelper</a></li><li class="none"><a href="exceptions.html">Exceptions</a></li><li class="collapsed"><a href="metadata.html">MetaData</a></li><li class="collapsed"><a href="guides.html">Guides</a></li><li class="none"><a href="references.html">Referenc
 es</a></li><li class="none"><a href="glossary.html">Glossary</a></li></ul></div><br></br><div id="menuCommunity"><h5>Community</h5><ul><li class="none"><a href="get-involved.html">Get Involved</a></li><li class="none"><strong><a href="team-list.html">Project Team</a></strong></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="faq.html">FAQ</a></li><li class="none"><a href="http://wiki.apache.org/jdo" class="externalLink" title="External Link">Wiki</a></li></ul></div><br></br><div id="menuDevelopment"><h5>Development</h5><ul><li class="none"><a href="roadmap.html">RoadMap / TODO</a></li><li class="none"><a href="svn.html">Source Code</a></li><li class="none"><a href="http://cwiki.apache.org/GMOxDEV/coding-standards.html" class="externalLink" title="External Link">Coding Standards</a></li><li class="none"><a href="issuetracking.html">Issue Tracking</a></li><li class="none"><a href="dependencies.html">Dependencies</a></li></ul></div><
 br></br></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="The_Apache_JDO_Team"></a><h2>The Apache JDO Team</h2><p>
+			    @import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta><meta name="author" content="Apache JDO Development Team"></meta><meta name="email" content="jdo-dev@db.apache.org"></meta></head><body class="composite"><div id="banner"><a href="http://db.apache.org/jdo" id="projectLogo"><img alt="Java Data Objects (JDO)" src="./images/JDOx120.gif"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuGeneral"><h5>General</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="none"><a href="why_jdo.html">Why JDO?</a></li><li class="none"><a href="jdo_v_jpa.html">JDO v JPA</a></li><li class="none"><a href="jdo_v_jpa_orm.html">JDO v JPA : ORM</a></li><li class="none"><a href="d
 ownloads.html">Downloads</a></li><li class="none"><a href="http://www.apache.org/licenses/LICENSE-2.0" class="externalLink" title="External Link">License</a></li></ul></div><br></br><div id="menuJDO_Implementation"><h5>JDO Implementation</h5><ul><li class="none"><a href="specifications.html">Specifications</a></li><li class="none"><a href="tck.html">TCK</a></li></ul></div><br></br><div id="menuJDO_Usage"><h5>JDO Usage</h5><ul><li class="none"><a href="impls.html">Implementations</a></li><li class="none"><a href="javadoc.html">API Javadoc</a></li><li class="none"><a href="class_types.html">Types of Classes</a></li><li class="none"><a href="enhancement.html">Bytecode Enhancement</a></li><li class="none"><a href="jdohelper.html">JDOHelper</a></li><li class="none"><a href="exceptions.html">Exceptions</a></li><li class="collapsed"><a href="metadata.html">MetaData</a></li><li class="none"><a href="state_transition.html">Object States</a></li><li class="collapsed"><a href="guides.h
 tml">Guides</a></li><li class="none"><a href="references.html">References</a></li><li class="none"><a href="glossary.html">Glossary</a></li></ul></div><br></br><div id="menuCommunity"><h5>Community</h5><ul><li class="none"><a href="get-involved.html">Get Involved</a></li><li class="none"><strong><a href="team-list.html">Project Team</a></strong></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="faq.html">FAQ</a></li><li class="none"><a href="http://wiki.apache.org/jdo" class="externalLink" title="External Link">Wiki</a></li></ul></div><br></br><div id="menuDevelopment"><h5>Development</h5><ul><li class="none"><a href="roadmap.html">RoadMap / TODO</a></li><li class="none"><a href="svn.html">Source Code</a></li><li class="none"><a href="http://cwiki.apache.org/GMOxDEV/coding-standards.html" class="externalLink" title="External Link">Coding Standards</a></li><li class="none"><a href="issuetracking.html">Issue Tracking</a></li><li cla
 ss="none"><a href="dependencies.html">Dependencies</a></li></ul></div><br></br></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="The_Apache_JDO_Team"></a><h2>The Apache JDO Team</h2><p>
     The people listed below have made significant contributions to JDO by
     working long and hard to make quality software for the rest of the world to
     use.

Modified: db/jdo/site/docs/why_jdo.html
URL: http://svn.apache.org/viewvc/db/jdo/site/docs/why_jdo.html?rev=581559&r1=581558&r2=581559&view=diff
==============================================================================
--- db/jdo/site/docs/why_jdo.html (original)
+++ db/jdo/site/docs/why_jdo.html Wed Oct  3 03:29:44 2007
@@ -1,7 +1,7 @@
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Java Data Objects (JDO) - Why JDO ?</title><style type="text/css" media="all">
           @import url("./style/maven-base.css");
           
-			    @import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://db.apache.org/jdo" id="projectLogo"><img alt="Java Data Objects (JDO)" src="./images/JDOx120.gif"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuGeneral"><h5>General</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="none"><strong><a href="why_jdo.html">Why JDO?</a></strong></li><li class="none"><a href="jdo_v_jpa.html">JDO v JPA</a></li><li class="none"><a href="jdo_v_jpa_orm.html">JDO v JPA : ORM</a></li><li class="none"><a href="downloads.html">Downloads</a></li><li class="none"><a href="http://www.apache.org/licenses/LICENSE-2.0" cla
 ss="externalLink" title="External Link">License</a></li></ul></div><br></br><div id="menuJDO_Implementation"><h5>JDO Implementation</h5><ul><li class="none"><a href="specifications.html">Specifications</a></li><li class="none"><a href="tck.html">TCK</a></li></ul></div><br></br><div id="menuJDO_Usage"><h5>JDO Usage</h5><ul><li class="none"><a href="impls.html">Implementations</a></li><li class="none"><a href="javadoc.html">API Javadoc</a></li><li class="none"><a href="class_types.html">Types of Classes</a></li><li class="none"><a href="enhancement.html">Bytecode Enhancement</a></li><li class="none"><a href="jdohelper.html">JDOHelper</a></li><li class="none"><a href="exceptions.html">Exceptions</a></li><li class="collapsed"><a href="metadata.html">MetaData</a></li><li class="collapsed"><a href="guides.html">Guides</a></li><li class="none"><a href="references.html">References</a></li><li class="none"><a href="glossary.html">Glossary</a></li></ul></div><br></br><div id="menuComm
 unity"><h5>Community</h5><ul><li class="none"><a href="get-involved.html">Get Involved</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="faq.html">FAQ</a></li><li class="none"><a href="http://wiki.apache.org/jdo" class="externalLink" title="External Link">Wiki</a></li></ul></div><br></br><div id="menuDevelopment"><h5>Development</h5><ul><li class="none"><a href="roadmap.html">RoadMap / TODO</a></li><li class="none"><a href="svn.html">Source Code</a></li><li class="none"><a href="http://cwiki.apache.org/GMOxDEV/coding-standards.html" class="externalLink" title="External Link">Coding Standards</a></li><li class="none"><a href="issuetracking.html">Issue Tracking</a></li><li class="none"><a href="dependencies.html">Dependencies</a></li></ul></div><br></br></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Why_JDO__"></a><h2>Why JDO ?
 </h2><p>
+			    @import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta></head><body class="composite"><div id="banner"><a href="http://db.apache.org/jdo" id="projectLogo"><img alt="Java Data Objects (JDO)" src="./images/JDOx120.gif"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuGeneral"><h5>General</h5><ul><li class="none"><a href="index.html">Home</a></li><li class="none"><strong><a href="why_jdo.html">Why JDO?</a></strong></li><li class="none"><a href="jdo_v_jpa.html">JDO v JPA</a></li><li class="none"><a href="jdo_v_jpa_orm.html">JDO v JPA : ORM</a></li><li class="none"><a href="downloads.html">Downloads</a></li><li class="none"><a href="http://www.apache.org/licenses/LICENSE-2.0" cla
 ss="externalLink" title="External Link">License</a></li></ul></div><br></br><div id="menuJDO_Implementation"><h5>JDO Implementation</h5><ul><li class="none"><a href="specifications.html">Specifications</a></li><li class="none"><a href="tck.html">TCK</a></li></ul></div><br></br><div id="menuJDO_Usage"><h5>JDO Usage</h5><ul><li class="none"><a href="impls.html">Implementations</a></li><li class="none"><a href="javadoc.html">API Javadoc</a></li><li class="none"><a href="class_types.html">Types of Classes</a></li><li class="none"><a href="enhancement.html">Bytecode Enhancement</a></li><li class="none"><a href="jdohelper.html">JDOHelper</a></li><li class="none"><a href="exceptions.html">Exceptions</a></li><li class="collapsed"><a href="metadata.html">MetaData</a></li><li class="none"><a href="state_transition.html">Object States</a></li><li class="collapsed"><a href="guides.html">Guides</a></li><li class="none"><a href="references.html">References</a></li><li class="none"><a href
 ="glossary.html">Glossary</a></li></ul></div><br></br><div id="menuCommunity"><h5>Community</h5><ul><li class="none"><a href="get-involved.html">Get Involved</a></li><li class="none"><a href="team-list.html">Project Team</a></li><li class="none"><a href="mail-lists.html">Mailing Lists</a></li><li class="none"><a href="faq.html">FAQ</a></li><li class="none"><a href="http://wiki.apache.org/jdo" class="externalLink" title="External Link">Wiki</a></li></ul></div><br></br><div id="menuDevelopment"><h5>Development</h5><ul><li class="none"><a href="roadmap.html">RoadMap / TODO</a></li><li class="none"><a href="svn.html">Source Code</a></li><li class="none"><a href="http://cwiki.apache.org/GMOxDEV/coding-standards.html" class="externalLink" title="External Link">Coding Standards</a></li><li class="none"><a href="issuetracking.html">Issue Tracking</a></li><li class="none"><a href="dependencies.html">Dependencies</a></li></ul></div><br></br></div></div><div id="bodyColumn"><div class=
 "contentBox"><div class="section"><a name="Why_JDO__"></a><h2>Why JDO ?</h2><p>
                 The majority of applications need to persist (or store) data during their lifecycle. There are many ways of doing 
                 this with an application written in Java. 
             </p><p>

Added: db/jdo/site/xdocs/images/state_transition.gif
URL: http://svn.apache.org/viewvc/db/jdo/site/xdocs/images/state_transition.gif?rev=581559&view=auto
==============================================================================
Binary file - no diff available.

Propchange: db/jdo/site/xdocs/images/state_transition.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: db/jdo/site/xdocs/images/state_transition_delete.gif
URL: http://svn.apache.org/viewvc/db/jdo/site/xdocs/images/state_transition_delete.gif?rev=581559&view=auto
==============================================================================
Binary file - no diff available.

Propchange: db/jdo/site/xdocs/images/state_transition_delete.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: db/jdo/site/xdocs/images/state_transition_persist.gif
URL: http://svn.apache.org/viewvc/db/jdo/site/xdocs/images/state_transition_persist.gif?rev=581559&view=auto
==============================================================================
Binary file - no diff available.

Propchange: db/jdo/site/xdocs/images/state_transition_persist.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: db/jdo/site/xdocs/images/state_transition_update.gif
URL: http://svn.apache.org/viewvc/db/jdo/site/xdocs/images/state_transition_update.gif?rev=581559&view=auto
==============================================================================
Binary file - no diff available.

Propchange: db/jdo/site/xdocs/images/state_transition_update.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Modified: db/jdo/site/xdocs/navigation.xml
URL: http://svn.apache.org/viewvc/db/jdo/site/xdocs/navigation.xml?rev=581559&r1=581558&r2=581559&view=diff
==============================================================================
--- db/jdo/site/xdocs/navigation.xml (original)
+++ db/jdo/site/xdocs/navigation.xml Wed Oct  3 03:29:44 2007
@@ -29,6 +29,7 @@
                 <item name="orm DTD/XSD" href="/orm_dtd.html"/>
                 <item name="jdoquery DTD/XSD" href="/jdoquery_dtd.html"/>
 	        </item>
+            <item name="Object States" href="/state_transition.html"/>
 			<item name="Guides" href="/guides.html" collapse="true">
                 <item name="Datastore Replication" href="/guides/replication.html"/>
                 <item name="JDO and Maven1" href="/guides/maven-jdo.html"/>

Added: db/jdo/site/xdocs/state_transition.xml
URL: http://svn.apache.org/viewvc/db/jdo/site/xdocs/state_transition.xml?rev=581559&view=auto
==============================================================================
--- db/jdo/site/xdocs/state_transition.xml (added)
+++ db/jdo/site/xdocs/state_transition.xml Wed Oct  3 03:29:44 2007
@@ -0,0 +1,183 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<document>
+    <properties>
+        <title>JDO State Transitions</title>
+    </properties>
+
+    <body>
+        <section name="JDO State Transition">
+            <p>
+                JDO manages the lifecycle of an object, from creation (<B>Transient</B>) through to persistence in the datastore (<B>Hollow</B>, <B>Persistent Clean</B>) and all of the various states between these. The transition between these states are achieved by using methods on the Persistence Manager such as <I>makePersistent()</I>, <I>makeTransient()</I>, <I>deletePersistent()</I>, and by commiting the changes made by these operations, or by rolling them back.
+            </p>
+            <p>
+                The various lifecycle states supported by JDO are shown below.
+            </p>
+            <table>
+                <tr>
+                    <th>Name</th>
+                    <th>Description</th>
+                </tr>
+                <tr>
+                    <td>Transient</td>
+                    <td>Any object created by the developer that do are not persisted. These don't have a JDO identity.</td>
+                </tr>
+                <tr>
+                    <td>Persistent New</td>
+                    <td>Any object that is newly persisted in the current transaction. A JDO identity has been assigned to these objects.</td>
+                </tr>
+                <tr>
+                    <td>Persistent Dirty</td>
+                    <td>Any persistent object that has been changed in the current transaction.</td>
+                </tr>
+                <tr>
+                    <td>Hollow</td>
+                    <td>Any persistent object that represents data in the datastore, but whose values are not in the instance.</td>
+                </tr>
+                <tr>
+                    <td>Persistent Clean</td>
+                    <td>Any persistent object that represents data in the datastore, and whose values have not been changed in the current transaction.</td>
+                </tr>
+                <tr>
+                    <td>Persistent Deleted</td>
+                    <td>Any persistent object that represents data in the datastore, and that has been deleted in the current transaction.</td>
+                </tr>
+                <tr>
+                    <td>Persistent New Deleted</td>
+                    <td>Any object that have been newly made persistent and then deleted in the same current transaction.</td>
+                </tr>
+                <tr>
+                    <td>Persistent Non transactional</td>
+                    <td>Any persistent object that represents data in the datastore, whose values are loaded but not transactionally consistent.</td>
+                </tr>
+                <tr>
+                    <td>Persistent Non transactional Dirty</td>
+                    <td>Any persistent object that represents data in the datastore, whose values are loaded but not transactionally consistent, and that has been modified.</td>
+                </tr>
+                <tr>
+                    <td>Transient Clean</td>
+                    <td>Any transient object that represents a transactional instance whose values have not been changed in the current transaction.</td>
+                </tr>
+                <tr>
+                    <td>Transient Dirty</td>
+                    <td>Any transient object that represents a transactional instance whose values have been changed in the current transaction.</td>
+                </tr>
+                <tr>
+                    <td>Detached Clean</td>
+                    <td>Any detached object that represents a persistent instance whose values have not been changed since detaching.</td>
+                </tr>
+                <tr>
+                    <td>Detached Dirty</td>
+                    <td>Any detached object that represents a persistent instance whose values have been changed since detaching.</td>
+                </tr>
+            </table>
+
+            <subsection name="Detecting Object State">
+                <p>
+                    JDO provides a class <a href="jdohelper.html">JDOHelper</a> that allows you to interrogate the object state via its attributes (isPersistent(), isDeleted(), etc).
+                    In JDO 2.1 for JDKs 1.5+ <i>JDOHelper</i> is extended to also provide a method that gives the full object state.
+                </p>
+                <source>ObjectState state = JDOHelper.getObjectState(obj);</source>
+                <br/>
+            </subsection>
+
+            <subsection name="Persisting an object">
+                <p>
+                    The most basic thing you can do with JDO is persist an object. The following code is an example of how you can do this
+                </p>
+                <source>
+Transaction tx=pm.currentTransaction();
+try
+{
+    tx.begin();
+    Product product = new Product("Plate", 9.99);
+    pm.makePersistent(product);
+    tx.commit();
+}
+finally
+{
+    if (tx.isActive())
+    {
+        tx.rollback();
+    }
+}
+                </source>
+                <p>
+                    The <I>Product</I> object progresses from <B>Transient</B> (initial, unpersisted state), through to <B>Persistent New</B>, and then finally to <B>Hollow</B> when it reaches the data store (after the "commit"). If the persist failed, it would "rollback" and hence end up in the same state as when it started. The following diagram shows this graphically
+                </p>
+                <br/>
+                <img src="images/state_transition_persist.gif"/>
+                <br/>
+            </subsection>
+
+            <subsection name="Updating an object">
+                <p>
+                    When you have persisted objects you need to update them. The following code is an example of how you can do this
+                </p>
+                <source>
+Transaction tx=pm.currentTransaction();
+try
+{
+    tx.begin();
+    String product_name = product.getName();
+    ...
+    product.setPrice(7.50);
+    tx.commit();
+}
+finally
+{
+    if (tx.isActive())
+    {
+        tx.rollback();
+    }
+}
+                </source>
+                <p>
+                    The <I>Product</I> object starts off in <B>Hollow</B> state and progresses to <B>Persistent Clean</B> when the user requires to read from it. It then migrates to <B>Persistent Dirty</B> when the price is updated. Finally it returns to <B>Hollow</B> when the user commits/rolls back the transaction. The following diagram shows this graphically
+                </p>
+                <br/>
+                <img src="images/state_transition_update.gif"/>
+                <br/>
+            </subsection>
+
+            <subsection name="Deleting an object">
+                <p>
+                    When you no longer need an object persisted, you can delete it. The following code is an example of how you can do this
+                </p>
+                <source>
+Transaction tx=pm.currentTransaction();
+try
+{
+    tx.begin();
+    String product_name = product.getName();
+    ...
+    pm.deletePersistent(product);
+    tx.commit();
+}
+finally
+{
+    if (tx.isActive())
+    {
+        tx.rollback();
+    }
+}
+                </source>
+                <p>
+                    The <I>Product</I> object starts off in <B>Hollow</B> state and progresses to <B>Persistent Clean</B> when the user requires to read from it. It then migrates to <B>Persistent Deleted</B> when the deletePersistent() called. Finally it either progresses to <B>Transient</B> when commit is called, or returns to <B>Hollow</B> if it is rolled back. The following diagram shows this graphically
+                </p>
+                <br/>
+                <img src="images/state_transition_delete.gif"/>
+                <br/>
+            </subsection>
+
+            <subsection name="Possible state transitions">
+                <p>
+                    The following diagram shows the state transitions possible with JDO and JPOX.
+                </p>
+                <br/>
+                <img src="images/state_transition.gif" border="0" alt="JDO State Transition"/>
+                <br/>
+            </subsection>
+        </section>
+
+    </body>
+</document>



Mime
View raw message