db-jdo-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From an...@apache.org
Subject svn commit: r1090559 [8/8] - in /db/jdo/site: docs/ docs/guides/ docs/releases/ xdocs/
Date Sat, 09 Apr 2011 10:17:00 GMT
Modified: db/jdo/site/docs/team-list.html
URL: http://svn.apache.org/viewvc/db/jdo/site/docs/team-list.html?rev=1090559&r1=1090558&r2=1090559&view=diff
==============================================================================
--- db/jdo/site/docs/team-list.html (original)
+++ db/jdo/site/docs/team-list.html Sat Apr  9 10:16:58 2011
@@ -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"><table><tr><td nowrap="true"><a href="http://db.apache.org/jdo" id="projectLogo"><img alt="Java Data Objects (JDO)" src="./images/JDOx120.gif"></img></a><a href="http://db.apache.org/jdo" id="organizationLogo"><img alt="Java Data Objects (JDO)" src="./images/jdo_text.gif"></img></a></td></tr></table><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.htm
 l">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_api.html">JDO v JPA : API</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="field_types.html">Types of Fields</a></li><li class="collapsed"><a href="metadata.html">MetaDat
 a</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="pmf.html">PersistenceManagerFactory</a></li><li class="none"><a href="pm.html">PersistenceManager</a></li><li class="none"><a href="transactions.html">Transactions</a></li><li class="none"><a href="state_transition.html">Object States</a></li><li class="none"><a href="object_retrieval.html">Object Retrieval</a></li><li class="expanded"><a href="jdoql.html">JDOQL</a><ul><li class="none"><a href="jdoql_result.html">Result</a></li><li class="none"><a href="jdoql_methods.html">Methods</a></li><li class="none"><a href="jdoql_quickref.pdf">Quick Ref PDF</a></li></ul></li><li class="none"><a href="extents.html">Extents</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="exceptions.html">Exceptions</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"><table><tr><td nowrap="true"><a href="http://db.apache.org/jdo" id="projectLogo"><img alt="Java Data Objects (JDO)" src="./images/JDOx120.gif"></img></a><a href="http://db.apache.org/jdo" id="organizationLogo"><img alt="Java Data Objects (JDO)" src="./images/jdo_text.gif"></img></a></td></tr></table><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.htm
 l">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_api.html">JDO v JPA : API</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="field_types.html">Types of Fields</a></li><li class="collapsed"><a href="metadata.html">MetaDat
 a</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="pmf.html">PersistenceManagerFactory</a></li><li class="none"><a href="pm.html">PersistenceManager</a></li><li class="none"><a href="transactions.html">Transactions</a></li><li class="none"><a href="attach_detach.html">Attach-Detach</a></li><li class="none"><a href="fetchgroups.html">Fetch Groups</a></li><li class="none"><a href="state_transition.html">Object States</a></li><li class="none"><a href="object_retrieval.html">Object Retrieval</a></li><li class="expanded"><a href="jdoql.html">JDOQL</a><ul><li class="none"><a href="jdoql_result.html">Result</a></li><li class="none"><a href="jdoql_methods.html">Methods</a></li><li class="none"><a href="jdoql_quickref.pdf">Quick Ref PDF</a></li></ul></li><li class="none"><a href="extents.html">Extents</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="exceptions.html">Exceptions</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="issuetra
 cking.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>
     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.
@@ -16,4 +16,4 @@
     <a href="get-involved.html">Get Involved</a>.
 </p></div><div class="section"><a name="Apache_JDO_Committers"></a><h2>Apache JDO Committers</h2><table class="bodyTable"><tr class="a"><th>Name</th><th>Organization</th></tr><tr class="b"><td>Matthew Adams</td><td>SpringSource</td></tr><tr class="a"><td>Erik Bengtson</td><td>JPOX</td></tr><tr class="b"><td>Michael Bouschen</td><td>Tech@Spree</td></tr><tr class="a"><td>Michelle Caisse</td><td>Sun Microsystems, Inc.</td></tr><tr class="b"><td>Andy Jefferson</td><td>DataNucleus</td></tr><tr class="a"><td>Patrick Linskey</td><td>Oracle</td></tr><tr class="b"><td>Geir Magnusson Jr.</td><td>IBM</td></tr><tr class="a"><td>Brian McCallister</td><td></td></tr><tr class="b"><td>Craig Russell</td><td>Sun Microsystems, Inc.</td></tr><tr class="a"><td>Dain Sundstrom</td><td></td></tr><tr class="b"><td>Brian Topping</td><td></td></tr><tr class="a"><td>Michael Watzek</td><td>Tech@Spree</td></tr><tr class="b"><td>Martin Zaun</td><td>Sun Microsystems, Inc.</td></tr></table></div><div class=
 "section"><a name="Apache_JDO_Contributors"></a><h2>Apache JDO Contributors</h2><table class="bodyTable"><tr class="a"><th>Name</th><th>Organization</th></tr><tr class="b"><td>Chris Beams</td><td>SpringSource</td></tr><tr class="a"><td>Ilan Kirsch</td><td>ObjectDB</td></tr></table></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="xright"><a href="http://www.apache.org/foundation/sponsorship.html">Be an Apache Software Foundation sponsor</a><br><a href="http://www.apache.org/foundation/thanks.html">Thanks to ASF sponsors!</a></br></div><div class="xleft">
                 Documentation published: <br></br>
-                  © 2005-2010 <a href="http://www.apache.org/">Apache Software Foundation</a></div></div></body></html>
\ No newline at end of file
+                  © 2005-2011 <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/transactions.html
URL: http://svn.apache.org/viewvc/db/jdo/site/docs/transactions.html?rev=1090559&r1=1090558&r2=1090559&view=diff
==============================================================================
--- db/jdo/site/docs/transactions.html (original)
+++ db/jdo/site/docs/transactions.html Sat Apr  9 10:16:58 2011
@@ -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) - Transactions</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"><table><tr><td nowrap="true"><a href="http://db.apache.org/jdo" id="projectLogo"><img alt="Java Data Objects (JDO)" src="./images/JDOx120.gif"></img></a><a href="http://db.apache.org/jdo" id="organizationLogo"><img alt="Java Data Objects (JDO)" src="./images/jdo_text.gif"></img></a></td></tr></table><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_api.htm
 l">JDO v JPA : API</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="field_types.html">Types of Fields</a></li><li class="collapsed"><a href="metadata.html">MetaData</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="pmf.html">PersistenceManagerFactory</a></li><li class="none"><a href="pm.html">PersistenceManager</a></li><li class="none"><strong><a href="transactions.html">Transactions</a></strong></li><li class="none"><a href="state_transition.html">Object States</a></li><li class="none"><a href="object_retrieval.html">Object Retrieval</a></li><li class="expanded"><a href="jdoql.html">JDOQL</a><ul><li class="none"><a href="jdoql_result.html">Result</a></li><li class="none"><a href="jdoql_methods.html">Methods</a></li><li class="none"><a href="jdoql_quickref.pdf">Quick Ref PDF</a></li></ul></li><li class="none"><a href="extents.html">Extents</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="exceptions.html">Exceptions</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="Transactions"></a><h2>Transactions</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"><table><tr><td nowrap="true"><a href="http://db.apache.org/jdo" id="projectLogo"><img alt="Java Data Objects (JDO)" src="./images/JDOx120.gif"></img></a><a href="http://db.apache.org/jdo" id="organizationLogo"><img alt="Java Data Objects (JDO)" src="./images/jdo_text.gif"></img></a></td></tr></table><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_api.htm
 l">JDO v JPA : API</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="field_types.html">Types of Fields</a></li><li class="collapsed"><a href="metadata.html">MetaData</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="pmf.html">PersistenceManagerFactory</a></li><li class="none"><a href="pm.html">PersistenceManager</a></li><li class="none"><strong><a href="transactions.html">Transactions</a></strong></li><li class="none"><a href="attach_detach.html">Attach-Detach</a></li><li class="none"><a href="fetchgroups.html">Fetch Groups</a></li><li class="none"><a href="state_transition.html">Object States</a></li><li class="none"><a href="object_retrieval.html">Object Retrieval</a></li><li class="expanded"><a href="jdoql.html">JDOQL</a><ul><li class="none"><a href="jdoql_result.html">Result</a></li><li class="none"><a href="jdoql_methods.html">Methods</a></li><li class="none"><a href="jdoql_quickref.pdf">Quick Ref PDF</a></li></ul></li><li class="none"><a href="extents.html">Extents</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="exceptions.html">E
 xceptions</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="Transactions"></a><h2>Transactions</h2><p>
                 When managing the persistence of objects using a <a href="pm.html">PersistenceManager</a>
                 it is normal to handle all datastore operations in a transaction. For this reason each
                 <i>PersistenceManager</i> has its own transaction. Consequently a typical JDO persistence method
@@ -41,4 +41,4 @@ finally
     <div class="source"><pre>pm.currentTransaction().setOptimistic(true);</pre></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="xright"><a href="http://www.apache.org/foundation/sponsorship.html">Be an Apache Software Foundation sponsor</a><br><a href="http://www.apache.org/foundation/thanks.html">Thanks to ASF sponsors!</a></br></div><div class="xleft">
                 Documentation published: <br></br>
-                  © 2005-2010 <a href="http://www.apache.org/">Apache Software Foundation</a></div></div></body></html>
\ No newline at end of file
+                  © 2005-2011 <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/why_jdo.html
URL: http://svn.apache.org/viewvc/db/jdo/site/docs/why_jdo.html?rev=1090559&r1=1090558&r2=1090559&view=diff
==============================================================================
--- db/jdo/site/docs/why_jdo.html (original)
+++ db/jdo/site/docs/why_jdo.html Sat Apr  9 10:16:58 2011
@@ -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"><table><tr><td nowrap="true"><a href="http://db.apache.org/jdo" id="projectLogo"><img alt="Java Data Objects (JDO)" src="./images/JDOx120.gif"></img></a><a href="http://db.apache.org/jdo" id="organizationLogo"><img alt="Java Data Objects (JDO)" src="./images/jdo_text.gif"></img></a></td></tr></table><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_api.html">JDO v JPA : API</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="field_types.html">Types of Fields</a></li><li class="collapsed"><a href="metadata.html">MetaData</a></li><li class="none"><a href="enhancement.html">Bytecode Enhancement</a></li><li class="none"><a hre
 f="jdohelper.html">JDOHelper</a></li><li class="none"><a href="pmf.html">PersistenceManagerFactory</a></li><li class="none"><a href="pm.html">PersistenceManager</a></li><li class="none"><a href="transactions.html">Transactions</a></li><li class="none"><a href="state_transition.html">Object States</a></li><li class="none"><a href="object_retrieval.html">Object Retrieval</a></li><li class="expanded"><a href="jdoql.html">JDOQL</a><ul><li class="none"><a href="jdoql_result.html">Result</a></li><li class="none"><a href="jdoql_methods.html">Methods</a></li><li class="none"><a href="jdoql_quickref.pdf">Quick Ref PDF</a></li></ul></li><li class="none"><a href="extents.html">Extents</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="exceptions.html">Exceptions</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>
+			    @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"><table><tr><td nowrap="true"><a href="http://db.apache.org/jdo" id="projectLogo"><img alt="Java Data Objects (JDO)" src="./images/JDOx120.gif"></img></a><a href="http://db.apache.org/jdo" id="organizationLogo"><img alt="Java Data Objects (JDO)" src="./images/jdo_text.gif"></img></a></td></tr></table><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_api.html">JDO v JPA : API</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="field_types.html">Types of Fields</a></li><li class="collapsed"><a href="metadata.html">MetaData</a></li><li class="none"><a href="enhancement.html">Bytecode Enhancement</a></li><li class="none"><a hre
 f="jdohelper.html">JDOHelper</a></li><li class="none"><a href="pmf.html">PersistenceManagerFactory</a></li><li class="none"><a href="pm.html">PersistenceManager</a></li><li class="none"><a href="transactions.html">Transactions</a></li><li class="none"><a href="attach_detach.html">Attach-Detach</a></li><li class="none"><a href="fetchgroups.html">Fetch Groups</a></li><li class="none"><a href="state_transition.html">Object States</a></li><li class="none"><a href="object_retrieval.html">Object Retrieval</a></li><li class="expanded"><a href="jdoql.html">JDOQL</a><ul><li class="none"><a href="jdoql_result.html">Result</a></li><li class="none"><a href="jdoql_methods.html">Methods</a></li><li class="none"><a href="jdoql_quickref.pdf">Quick Ref PDF</a></li></ul></li><li class="none"><a href="extents.html">Extents</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="exceptions.html">E
 xceptions</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><ul>
@@ -36,4 +36,4 @@
                 <li>requires the developer to write this layer.</li>
             </ol></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="xright"><a href="http://www.apache.org/foundation/sponsorship.html">Be an Apache Software Foundation sponsor</a><br><a href="http://www.apache.org/foundation/thanks.html">Thanks to ASF sponsors!</a></br></div><div class="xleft">
                 Documentation published: <br></br>
-                  © 2005-2010 <a href="http://www.apache.org/">Apache Software Foundation</a></div></div></body></html>
\ No newline at end of file
+                  © 2005-2011 <a href="http://www.apache.org/">Apache Software Foundation</a></div></div></body></html>
\ No newline at end of file

Added: db/jdo/site/xdocs/attach_detach.xml
URL: http://svn.apache.org/viewvc/db/jdo/site/xdocs/attach_detach.xml?rev=1090559&view=auto
==============================================================================
--- db/jdo/site/xdocs/attach_detach.xml (added)
+++ db/jdo/site/xdocs/attach_detach.xml Sat Apr  9 10:16:58 2011
@@ -0,0 +1,235 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<document>
+    <properties>
+        <title>Attach/Detach</title>
+    </properties>
+
+    <body>
+        <section name="JDO Attach/Detach">
+            <p>
+                JDO provides an interface to the persistence of objects. JDO 1.0 doesn't provide a way of taking 
+                an object that was just persisted and just work on it and update the persisted object later. 
+                The user has to copy the fields manually and copy them back to the persisted object later. 
+                JDO 2.0 introduces a new way of handling this situation, by <B>detaching</B> an object from the 
+                persistence graph, allowing it to be worked on in the users application. It can then be 
+                <B>attached</B> to the persistence graph later. 
+                Please refer to <a href="state_transition.html">Object Lifecycle</a> for where this fits in.
+                The first thing to do to use a class with this facility is to tag it as "detachable". 
+                This is done by adding the attribute
+            </p>
+            <source>&lt;class name="MyClass" detachable="true"&gt;</source>
+            <p>
+                This acts as an instruction to the <a href="enhancement.html">enhancement process</a> to add 
+                methods necessary to utilise the attach/detach process.
+            </p>
+
+            <p>
+                The following code fragment highlights how to use the attach/detach mechanism
+            </p>
+            <source>
+Product working_product=null;
+Transaction tx=pm.currentTransaction();
+try
+{
+    tx.begin();
+
+    Product prod=new Product(name,description,price);
+    pm.makePersistent(prod);
+
+    // Detach the product for use
+    working_product = (Product)pm.detachCopy(prod);
+
+    tx.commit();
+}
+catch (Exception e)
+{
+    // Handle the exception
+}
+finally
+{
+    if (tx.isActive())
+    {
+        tx.rollback();
+    }
+}
+
+// Work on the detached object in our application
+working_product.setPrice(new_price);
+
+...
+
+// Reattach the updated object
+tx = pm.currentTransaction();
+try
+{
+    tx.begin();
+
+    Product attached_product = pm.makePersistent(working_product);
+
+    tx.commit();
+}
+catch (Exception e)
+{
+    // Handle the exception
+}
+finally
+{
+    if (tx.isActive())
+    {
+        tx.rollback();
+    }
+}</source>
+            <p>
+                So we now don't need to do any manual copying of object fields just using a simple call to 
+                detach the object, and then attach it again later. Here are a few things to note with 
+                <I>attach/detach</I> :-
+            </p>
+            <ul>
+                <li>Calling <i>detachCopy</i> on an object that is not detachable will return a <b>transient</b> 
+                    instance that is a COPY of the original, so use the COPY thereafter.</li>
+                <li>Calling <i>detachCopy</i> on an object that is detachable will return a <b>detached</b> 
+                    instance that is a COPY of the original, so use this COPY thereafter</li>
+                <li>A <I>detached</I> object retain the id of its datastore entity. Detached objects should be used
+                    where you want to update the objects and attach them later (updating the associated object in the
+                    datastore. If you want to create copies of the objects in the datastore with their own identities
+                    you should use <I>makeTransient</I> instead of <I>detachCopy</I>.</li>
+                <li>Calling <I>detachCopy</I> will detach all fields of that object that are in the current 
+                    <a href="fetchgroups.html">Fetch Group</a> for that class for that <I>PersistenceManager</I>.</li>
+                <li>By default the fields of the object that will be detached are those in the <I>Default Fetch Group</I>.</li>
+                <li>You should choose your <a href="fetchgroups.html">Fetch Group</a> carefully, bearing in mind which
+                    object(s) you want to access whilst detached. Detaching a relation field will detach the related object
+                    as well.</li>
+                <li>If you don't detach a field of an object, you <u>cannot</u> access the value for that field while
+                    the object is detached.</li>
+                <li>If you don't detach a field of an object, you <u>can</u> update the value for that field while detached,
+                    and thereafter you can access the value for that field.</li>
+                <li>Calling <I>makePersistent</I> will return an (attached) copy of the detached object. It will attach all fields that
+                    were originally detached, and will also attach any other fields that were modified whilst detached.</li>
+            </ul>
+
+            <a name="detach_all_on_commit"/>
+            <subsection name="Detach All On Commit">
+                <p>
+                    JDO2 also provides a mechanism whereby all objects that were enlisted in a transaction are 
+                    automatically detached when the transaction is committed. You can enable this in one of 3 ways. 
+                    If you want to use this mode globally for all <I>PersistenceManager</I>s (PMs) from a 
+                    <I>PersistenceManagerFactory</I> (PMF) you could either set the PMF property 
+                    "datanucleus.DetachAllOnCommit", or you could create your PMF and call the PMF method 
+                    <B>setDetachAllOnCommit(true)</B>. If instead you wanted to use this mode only for a particular
+                    PM, or only for a particular transaction for a particular PM, then you can call the PM method
+                    <B>setDetachAllOnCommit(true)</B> before the commit of the transaction, and it will apply for all
+                    transaction commits thereafter, until turned off (<B>setDetachAllOnCommit(false)</B>. 
+                    Here's an example
+                </p>
+                <source>
+// Create a PMF
+...
+
+// Create an object
+MyObject my = new MyObject();
+
+PersistenceManager pm = pmf.getPersistenceManager();
+Transaction tx = pm.currentTransaction();
+try
+{
+    tx.begin();
+
+    // We want our object to be detached when it's been persisted
+    pm.setDetachAllOnCommit(true);
+
+    // Persist the object that we created earlier
+    pm.makePersistent(my);
+
+    tx.commit();
+    // The object "my" is now in detached state and can be used further
+}
+finally
+{
+    if (tx.isActive)
+    {
+        tx.rollback();
+    }
+}</source>
+                <br/>
+            </subsection>
+
+            <a name="copy_on_attach"/>
+            <subsection name="Copy On Attach">
+                <p>
+                    By default when you are attaching a detached object it will return an attached copy
+                    of the detached object. JDO2.1 provides a new feature that allows this attachment to
+                    just migrate the existing detached object into attached state.
+                </p>
+                <p>
+                    You enable this by setting the <I>PersistenceManagerFactory</I> (PMF) property
+                    <B>datanucleus.CopyOnAttach</B> to false. Alternatively you can use the methods
+                    <i>PersistenceManagerFactory.setCopyOnAttach(boolean flag)</i> or
+                    <i>PersistenceManager.setCopyOnAttach(boolean flag)</i>.
+                    If we return to the example at the start of this page, this now becomes
+                </p>
+                <source><![CDATA[
+// Reattach the updated object
+pm.setCopyOnAttach(false);
+tx = pm.currentTransaction();
+try
+{
+    tx.begin();
+
+    // working product is currently in detached state
+
+    pm.makePersistent(working_product);
+    // working_product is now in persistent (attached) state
+
+    tx.commit();
+}
+catch (Exception e)
+{
+    // Handle the exception
+}
+finally
+{
+    if (tx.isActive())
+    {
+        tx.rollback();
+    }
+}]]></source>
+                <p>
+                    Please note that if you try to attach two detached objects representing the same underlying 
+                    persistent object within the same transaction (i.e a persistent object with the same identity
+                    already exists in the level 1 cache), then a JDOUserException will be thrown.
+                </p>
+                <br/>
+            </subsection>
+
+            <subsection name="Serialization of Detachable classes">
+                <p>
+                    During enhancement of Detachable classes, a field called <i>jdoDetachedState</i> is added to 
+                    the class definition. This field allows reading and changing tracking of detached objects 
+                    while they are not managed by a PersistenceManager.
+                </p>
+                <p>
+                    When serialization occurs on a Detachable object, the <i>jdoDetachedState</i> field is written 
+                    to the serialized object stream. On deserialize, this field is written back to the new 
+                    deserialized instance. This process occurs transparently to the application. However, if 
+                    deserialization occurs with an un-enhanced version of the class, the detached state is lost.
+                </p>
+                <p>
+                    Serialization and deserialization of Detachable classes and un-enhanced versions of the same 
+                    class is only possible if the field <i>serialVersionUID</i> is added. It's recommended during 
+                    development of the class, to define the <i>serialVersionUID</i> and make the class to implement
+                    the <i>java.io.Serializable</i> interface, as the following example:
+                </p>
+<source>
+class MyClass implements java.io.Serializable
+{
+    private static final long serialVersionUID = 2765740961462495537L; // any random value here
+    
+    //.... other fields
+}
+</source>                        
+                <br/>
+            </subsection>
+        </section>
+
+    </body>
+</document>

Added: db/jdo/site/xdocs/fetchgroups.xml
URL: http://svn.apache.org/viewvc/db/jdo/site/xdocs/fetchgroups.xml?rev=1090559&view=auto
==============================================================================
--- db/jdo/site/xdocs/fetchgroups.xml (added)
+++ db/jdo/site/xdocs/fetchgroups.xml Sat Apr  9 10:16:58 2011
@@ -0,0 +1,265 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<document>
+    <properties>
+        <title>Fetch-Groups</title>
+    </properties>
+
+    <body>
+        <section name="Fetch Groups">
+            <p>
+                When an object is retrieved from the datastore by JDO typically not all fields are retrieved immediately.
+                This is because for efficiency purposes only particular field types are retrieved in the initial access 
+                of the object, and then any other objects are retrieved when accessed (lazy loading). 
+                The group of fields that are loaded is called a <B>fetch group</B>.
+                There are 3 types of "fetch groups" to consider
+            </p>
+            <ul>
+                <li><a href="#dfg">Default Fetch Group</a> : defined in all JDO specs, containing the fields 
+                    of a class that will be retrieved by default (with no user specification).</li>
+                <li><a href="#static">Named Fetch Groups</a> : defined by the JDO2 specification, and defined
+                    in MetaData (XML/annotations) with the fields of a class that are part of that fetch group.
+                    The definition here is <i>static</i></li>
+                <li><a href="#dynamic">Dynamic Fetch Groups</a> : Programmatic definition of fetch groups at 
+                    runtime via an API</li>
+            </ul>
+            <p>
+                The <B>fetch group</B> in use for a class is controled via the <I>FetchPlan</I>
+                <a href="http://db.apache.org/jdo/api20/apidocs/javax/jdo/FetchPlan.html" target="_blank"><IMG SRC="images/javadoc.gif"/></a>
+                interface. To get a handle on the current <I>FetchPlan</I> we do
+            </p>
+            <source>FetchPlan fp = pm.getFetchPlan();</source>
+            <br/>
+
+            <a name="dfg"/>
+            <subsection name="Default Fetch Group">
+                <p>
+                    JDO provides an initial fetch group, comprising the fields that will be retrieved when an object 
+                    is retrieved if the user does nothing to define the required behaviour. By default the <I>default 
+                    fetch group</I> comprises all fields of the following types :-
+                </p>
+                <ul>
+                    <li>primitives : boolean, byte, char, double, float, int, long, short</li>
+                    <li>Object wrappers of primitives : Boolean, Byte, Character, Double, Float, Integer, Long, Short</li>
+                    <li>java.lang.String, java.lang.Number, java.lang.Enum</li>
+                    <li>java.math.BigDecimal, java.math.BigInteger</li>
+                    <li>java.util.Date</li>
+                </ul>
+                <p>
+                    If you wish to change the <B>Default Fetch Group</B> for a class you can update the Meta-Data 
+                    for the class as follows (for XML)
+                </p>
+                <source><![CDATA[
+<class name="MyClass">
+    ...
+    <field name="fieldX" default-fetch-group="true"/>
+</class>]]></source>
+                <p>or using annotations</p>
+                <source><![CDATA[
+@Persistent(defaultFetchGroup="true")
+SomeType fieldX;]]></source>
+                <p>
+                    When a <I>PersistenceManager</I> is created it starts with a FetchPlan of the "default" fetch group. 
+                    That is, if we call
+                </p>
+                <source>Collection fetchGroups = fp.getGroups();</source>
+                <p>
+                    this will have one group, called "default". At runtime, if you have been using other 
+                    fetch groups and want to revert back to the default fetch group at any time you simply do
+                </p>
+                <source>fp.setGroup(FetchPlan.DEFAULT);</source>
+                <br/>
+            </subsection>
+
+            <a name="static"/>
+            <subsection name="Named Fetch Groups">
+                <p>
+                    As mentioned above, JDO allows specification of users own fetch groups. These are specified in the 
+                    MetaData of the class. For example, if we have the following class
+                </p>
+                <source>
+class MyClass
+{
+    String name;
+    HashSet coll;
+    MyOtherClass other;
+}</source>
+                <p>
+                    and we want to have the <U>other</U> field loaded whenever we load objects of this class, we define 
+                    our MetaData as
+                </p>
+                <source><![CDATA[
+<package name="mydomain">
+    <class name="MyClass">
+        <field name="name">
+            <column length="100" jdbc-type="VARCHAR"/>
+        </field>
+        <field name="coll" persistence-modifier="persistent">
+            <collection element-type="mydomain.Address"/>
+            <join/>
+        </field>
+        <field name="other" persistence-modifier="persistent"/>
+        <fetch-group name="otherfield">
+            <field name="other"/>
+        </fetch-group>
+    </class>
+</package>]]></source>
+                <p>or using annotations</p>
+                <source><![CDATA[
+@PersistenceCapable
+@FetchGroup(name="otherfield", members={@Persistent(name="other")})
+public class MyClass
+{
+    ...
+}]]></source>
+                <p>
+                    So we have defined a fetch group called "otherfield" that just includes the field with name 
+                    <I>other</I>. We can then use this at runtime in our persistence code.
+                </p>
+                <source>
+PersistenceManager pm = pmf.getPersistenceManager();
+pm.getFetchPlan().addGroup("otherfield");
+
+... (load MyClass object)</source>
+                <p>
+                    By default the <I>FetchPlan</I> will include the default fetch group. We have changed this above by
+                    <U>adding</U> the fetch group "otherfield", so when we retrieve an object using this 
+                    <I>PersistenceManager</I> we will be retrieving the fields <I>name</I> AND <I>other</I> since they
+                    are both in the current <I>FetchPlan</I>. We can take the above much further than what is shown by 
+                    defining nested fetch groups in the MetaData. In addition we can change the <I>FetchPlan</I> just
+                    before any <I>PersistenceManager</I> operation to control what is fetched during that operation.
+                    The user has full flexibility to add many groups to the current <B>Fetch Plan</B>.
+                    This gives much power and control over what will be loaded and when.
+                </p>
+                <p>
+                    The <I>FetchPlan</I> applies not just to calls to <I>PersistenceManager.getObjectById()</I>, but also
+                    to <I>PersistenceManager.newQuery()</I>, <I>PersistenceManager.getExtent()</I>, 
+                    <I>PersistenceManager.detachCopy</I> and much more besides.
+                </p>
+                <p>
+                    You can read more about <B>named fetch-groups</B> and how to use it with 
+                    <a href="attach_detach.html"><B>attach/detach</B></a>
+                </p>
+            </subsection>
+
+            <a name="dynamic"/>
+            <subsection name="Dynamic Fetch Groups">
+                <p>
+                    The mechanism above provides static fetch groups defined in XML or annotations. 
+                    That is great when you know in advance what fields you want to fetch. In some situations 
+                    you may want to define your fields to fetch at run time. This became standard in JDO2.2
+                    It operates as follows
+                </p>
+                <source>
+import org.datanucleus.FetchGroup;
+
+// Create a FetchGroup on the PMF called "TestGroup" for MyClass
+FetchGroup grp = myPMF.getFetchGroup("TestGroup", MyClass.class);
+grp.addMember("field1").addMember("field2");
+
+// Add this group to the fetch plan (using its name)
+fp.addGroup("TestGroup");</source>
+                <p>
+                    So we use the DataNucleus PMF as a way of creating a FetchGroup, and then register that 
+                    FetchGroup with the PMF for use by all PMs. We then enable our FetchGroup for use in the
+                    FetchPlan by using its group name (as we do for a static group). The FetchGroup allows you 
+                    to add/remove the fields necessary so you have full API control over the fields to be 
+                    fetched.
+                </p>
+                <br/>
+            </subsection>
+
+            <subsection name="Fetch Depth">
+                <p>
+                    The basic fetch group defines which fields are to be fetched. It doesn't explicitly define how far 
+                    down an object graph is to be fetched. JDO provides two ways of controlling this.
+                </p>
+                <p>
+                    The first is to set the <B>maxFetchDepth</B> for the <I>FetchPlan</I>. This value specifies how 
+                    far out from the root object the related objects will be fetched. A positive value means that 
+                    this number of relationships will be  traversed from the root object. A value of -1 means that 
+                    no limit will be placed on the fetching traversal. The default is 1. Let's take an example
+                </p>
+                <source><![CDATA[
+public class MyClass1
+{
+    MyClass2 field1;
+    ...
+}
+
+public class MyClass2
+{
+    MyClass3 field2;
+    ...
+}
+
+public class MyClass3
+{
+    MyClass4 field3;
+    ...
+}]]></source>
+                <p>
+                    and we want to detach <I>field1</I> of instances of <I>MyClass1</I>, down 2 levels - so detaching 
+                    the initial "field1" <I>MyClass2</I> object, and its "field2" <I>MyClass3</I> instance. So we 
+                    define our fetch-groups like this
+                </p>
+                <source><![CDATA[
+<class name="MyClass1">
+    ...
+    <fetch-group name="includingField1">
+        <field name="field1"/>
+    </fetch-group>
+</class>
+<class name="MyClass2">
+    ...
+    <fetch-group name="includingField2">
+        <field name="field2"/>
+    </fetch-group>
+</class>]]></source>
+                <p>
+                    and we then define the <B>maxFetchDepth</B> as 2, like this
+                </p>
+                <source>pm.getFetchPlan().setMaxFetchDepth(2);</source>
+                <p>
+                    A further refinement to this global fetch depth setting is to control the fetching of recursive 
+                    fields. This is performed via a MetaData setting "recursion-depth". A value of 1 means that only 
+                    1 level of objects will be fetched. A value of -1 means there is no limit on the amount of recursion. 
+                    The default is 1. Let's take an example
+                </p>
+                <source>
+public class Directory
+{
+    Collection children;
+    ...
+}</source>
+                <source><![CDATA[
+<class name="Directory">
+    <field name="children">
+        <collection element-type="Directory"/>
+    </field>
+
+    <fetch-group name="grandchildren">
+        <field name="children" recursion-depth="2"/>
+    </fetch-group>
+    ...
+</class>]]></source>
+                <p>
+                    So when we fetch a Directory, it will fetch 2 levels of the <I>children</I> field, hence fetching 
+                    the children and the grandchildren.
+                </p>
+            </subsection>
+
+            <subsection name="Fetch Size">
+                <p>
+                    A FetchPlan can also be used for defining the fetching policy when using queries. This can be 
+                    set using
+                </p>
+                <source>pm.getFetchPlan().setFetchSize(value);</source>
+                <p>
+                    The default is <I>FetchPlan.FETCH_SIZE_OPTIMAL</I> which leaves it to DataNucleus to optimise the fetching
+                    of instances. A positive value defines the number of instances to be fetched. Using 
+                    <I>FetchPlan.FETCH_SIZE_GREEDY</I> means that all instances will be fetched immediately.
+                </p>
+            </subsection>
+        </section>
+    </body>
+</document>

Modified: db/jdo/site/xdocs/navigation.xml
URL: http://svn.apache.org/viewvc/db/jdo/site/xdocs/navigation.xml?rev=1090559&r1=1090558&r2=1090559&view=diff
==============================================================================
--- db/jdo/site/xdocs/navigation.xml (original)
+++ db/jdo/site/xdocs/navigation.xml Sat Apr  9 10:16:58 2011
@@ -33,6 +33,8 @@
             <item name="PersistenceManagerFactory" href="/pmf.html"/>
             <item name="PersistenceManager" href="/pm.html"/>
             <item name="Transactions" href="/transactions.html"/>
+            <item name="Attach-Detach" href="/attach_detach.html"/>
+            <item name="Fetch Groups" href="/fetchgroups.html"/>
             <item name="Object States" href="/state_transition.html"/>
             <item name="Object Retrieval" href="/object_retrieval.html"/>
             <item name="JDOQL" href="/jdoql.html" collapse="false">



Mime
View raw message