You are viewing a plain text version of this content. The canonical link for it is here.
Posted to jdo-commits@db.apache.org by an...@apache.org on 2009/05/07 12:25:04 UTC
svn commit: r772590 [6/6] - in /db/jdo/site: docs/ docs/guides/
docs/releases/ xdocs/
Modified: db/jdo/site/docs/team-list.html
URL: http://svn.apache.org/viewvc/db/jdo/site/docs/team-list.html?rev=772590&r1=772589&r2=772590&view=diff
==============================================================================
--- db/jdo/site/docs/team-list.html (original)
+++ db/jdo/site/docs/team-list.html Thu May 7 10:25:02 2009
@@ -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="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="state_transition.html">Object States</a></li><li class="none"><a href="object_retrieval.html">Object Retrieval</a></li><li class="none"><a href="jdoql.html">JDOQL</a></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"><stro
ng><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>
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/transactions.html
URL: http://svn.apache.org/viewvc/db/jdo/site/docs/transactions.html?rev=772590&r1=772589&r2=772590&view=diff
==============================================================================
--- db/jdo/site/docs/transactions.html (original)
+++ db/jdo/site/docs/transactions.html Thu May 7 10:25:02 2009
@@ -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="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="state_transition.html">Object States</a></li><li class="none"><a href="object_retrieval.html">Object Retrieval</a></li><li class="none"><a href="jdoql.html">JDOQL</a></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>
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
Modified: db/jdo/site/docs/why_jdo.html
URL: http://svn.apache.org/viewvc/db/jdo/site/docs/why_jdo.html?rev=772590&r1=772589&r2=772590&view=diff
==============================================================================
--- db/jdo/site/docs/why_jdo.html (original)
+++ db/jdo/site/docs/why_jdo.html Thu May 7 10:25:02 2009
@@ -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="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="state_transition.html">Object States</a></li><li class="none"><a href="object_retrieval.html">Object Retrieval</a></li><li class="none"><a href="jdoql.html">JDOQL</a></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>
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>
Modified: db/jdo/site/xdocs/impls.xml
URL: http://svn.apache.org/viewvc/db/jdo/site/xdocs/impls.xml?rev=772590&r1=772589&r2=772590&view=diff
==============================================================================
--- db/jdo/site/xdocs/impls.xml (original)
+++ db/jdo/site/xdocs/impls.xml Thu May 7 10:25:02 2009
@@ -38,6 +38,7 @@
<li><b>JDO 2.0</b> : <a href="http://www.jpox.org/docs/1_1/">JPOX 1.1</a></li>
<li><b>JDO 2.1</b> : <a href="http://www.jpox.org/docs/1_2/">JPOX 1.2</a></li>
<li><b>JDO 2.2</b> : <a href="http://www.datanucleus.org/products/accessplatform_1_0/index.html">DataNucleus AccessPlatform 1.0.1</a></li>
+ <li><b>JDO 2.3</b> : <a href="http://www.datanucleus.org/products/accessplatform_1_1/index.html">DataNucleus AccessPlatform 1.1</a></li>
</ul>
<br/>
</subsection>
@@ -60,7 +61,7 @@
<tr>
<td><a href="http://www.datanucleus.org">DataNucleus Access Platform</a></td>
<td>NonCommercial</td>
- <td>1.0, 2.0, 2.1, 2.2</td>
+ <td>1.0, 2.0, 2.1, 2.2, 2.3</td>
<td>RDBMS, db4o, LDAP, Excel, XML, NeoDatis, JSON, OpenDocumentFormat (ODF), Google BigTable</td>
</tr>
<tr>
Modified: db/jdo/site/xdocs/jdo_v_jpa_api.xml
URL: http://svn.apache.org/viewvc/db/jdo/site/xdocs/jdo_v_jpa_api.xml?rev=772590&r1=772589&r2=772590&view=diff
==============================================================================
--- db/jdo/site/xdocs/jdo_v_jpa_api.xml (original)
+++ db/jdo/site/xdocs/jdo_v_jpa_api.xml Thu May 7 10:25:02 2009
@@ -47,6 +47,11 @@
<td>em.refresh()</td>
</tr>
<tr>
+ <td>Detach single Object</td>
+ <td>pm.detachCopy()</td>
+ <td><i>em.detach()</i> (JPA2)</td>
+ </tr>
+ <tr>
<td>Flush changes</td>
<td>pm.flush()</td>
<td>em.flush()</td>
@@ -66,6 +71,11 @@
<td>pm.newNamedQuery()</td>
<td>em.createNamedQuery()</td>
</tr>
+ <tr>
+ <td>New SQL Query</td>
+ <td>pm.newQuery()</td>
+ <td>em.createNativeQuery()</td>
+ </tr>
</table>
</section>
Added: db/jdo/site/xdocs/jdoql.xml
URL: http://svn.apache.org/viewvc/db/jdo/site/xdocs/jdoql.xml?rev=772590&view=auto
==============================================================================
--- db/jdo/site/xdocs/jdoql.xml (added)
+++ db/jdo/site/xdocs/jdoql.xml Thu May 7 10:25:02 2009
@@ -0,0 +1,245 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<document>
+ <properties>
+ <title>JDO Object Retrieval</title>
+ </properties>
+
+ <body>
+ <section name="Object Retrieval">
+ <p>
+ JDO defines ways of querying objects persisted into the datastore. It provides
+ its own object-based query language (JDOQL). JDOQL is designed as the Java
+ developers way of having the power of SQL queries, yet retaining the Java
+ object relationship that exist in their application model.
+ A typical JDOQL query may be set up in one of 2 ways. Here's an example
+ </p>
+ <source>
+Declarative JDOQL :
+Query q = pm.newQuery(mydomain.Person.class, "lastName == \"Jones\" && age < age_limit");
+q.declareParameters("double age_limit");
+List results = (List)q.execute(20.0);
+
+Single-String JDOQL :
+Query q = pm.newQuery("SELECT FROM mydomain.Person WHERE lastName == \"Jones\"" +
+ " && age < :age_limit PARAMETERS double age_limit");
+List results = (List)q.execute(20.0);</source>
+ <p>
+ So here in our example we select all "Person" objects with surname of "Jones"
+ and where the persons age is below 20. The language is intuitive for Java
+ developers, and is intended as their interface to accessing the persisted
+ data model. As can be seen above, the query is made up of distinct parts.
+ The class being selected (the SELECT clause in SQL), the filter (which equates
+ to the WHERE clause in SQL), together with any sorting (the ORDER BY clause
+ in SQL), etc.
+ </p>
+ <br/>
+
+ <a name="singlestring"/>
+ <subsection name="Single-String JDOQL">
+ <p>
+ In traditional (declarative) JDOQL (JDO 1.0) it was necessary to specify
+ the component parts (filter, candidate class, ordering, etc) of the query
+ using the mutator methods on the Query. In JDO 2 you can now specify it
+ all in a single string. This string has to follow a particular pattern,
+ but provides the convenience that many people have been asking for.
+ The pattern to use is as follows
+ </p>
+ <source>
+SELECT [UNIQUE] [<result>] [INTO <result-class>]
+ [FROM <candidate-class> [EXCLUDE SUBCLASSES]]
+ [WHERE <filter>]
+ [VARIABLES <variable declarations>]
+ [PARAMETERS <parameter declarations>]
+ [<import declarations>]
+ [GROUP BY <grouping>]
+ [ORDER BY <ordering>]
+ [RANGE <start>, <end>]</source>
+ <p>
+ The "keywords" in the query are shown in UPPER CASE but can be in
+ <I>UPPER</I> or <I>lower</I> case.
+ </p>
+ <p>
+ Lets give an example of a query using this syntax
+ </p>
+<source>SELECT UNIQUE FROM org.datanucleus.samples.Employee ORDER BY departmentNumber</source>
+ <p>
+ so we form the parts of the query as before, yet here we just specify it
+ all in a single call.
+ </p>
+ </subsection>
+
+ <subsection name="Accessing Fields">
+ <p>
+ In JDOQL you access fields in the query by referring to the field name.
+ For example, if you are querying a class called <I>Product</I> and it has
+ a field "price", then you access it like this
+ </p>
+ <source>
+Query query = pm.newQuery(mydomain.Product.class, "price < 150.0");</source>
+ <p>
+ In addition to the persistent fields, you can also access
+ "public static final" fields of any class. You can do this as follows
+ </p>
+ <source>
+Query query = pm.newQuery(mydomain.Product.class,
+ "taxPercent < mydomain.Product.TAX_BAND_A");</source>
+ <p>
+ So this will find all products that include a tax percentage less than
+ some "BAND A" level. Where you are using "public static final" fields you
+ can either fully-qualify the class name or you can include it in the
+ "imports" section of the query (see later).
+ </p>
+ </subsection>
+
+ <subsection name="Data types : literals">
+ <p>
+ JDOQL supports the following literals: IntegerLiteral,
+ FloatingPointLiteral, BooleanLiteral, CharacterLiteral, StringLiteral,
+ and NullLiteral.
+ </p>
+ </subsection>
+
+ <subsection name="Operators precedence">
+ <p>
+ The following list describes the operator precedence in JDOQL.
+ </p>
+ <p>
+ <ol>
+ <li>Cast</li>
+ <li>Unary ("~") ("!")</li>
+ <li>Unary ("+") ("-")</li>
+ <li>Multiplicative ("*") ("/") ("%")</li>
+ <li>Additive ("+") ("-")</li>
+ <li>Relational (">=") (">") ("<=") ("<") ("instanceof")</li>
+ <li>Equality ("==") ("=!")</li>
+ <li>Boolean logical AND ("&")</li>
+ <li>Boolean logical OR ("|")</li>
+ <li>Conditional AND ("&&")</li>
+ <li>Conditional OR ("||")</li>
+ </ol>
+ </p>
+ </subsection>
+
+ <subsection name="Concatenation Expressions">
+ <p>
+ The concatenation operator(+) concatenates a String to either another
+ String or Number. Concatenations of String or Numbers to null results in
+ null.
+ </p>
+ </subsection>
+
+ <subsection name="Example 1 - Use of Explicit Parameters">
+ <p>
+ Here's a simple example for finding the elements of a class with a field
+ below a particular threshold level. Here we pass in the threshold value
+ (<I>limit</I>), and sort the output in order of ascending price.
+ </p>
+ <source>
+Declarative JDOQL :
+Query query = pm.newQuery(mydomain.Product.class,"price < limit");
+query.declareParameters("double limit");
+query.setOrdering("price ascending");
+List results = (List)query.execute(150.00);
+
+Single-String JDOQL :
+Query query = pm.newQuery("SELECT FROM mydomain.Product WHERE " +
+ "price < limit PARAMETERS double limit ORDER BY price ASCENDING");
+List results = (List)query.execute(150.00);</source>
+ <p>
+ For completeness, the class is shown here
+ </p>
+ <source><![CDATA[
+class Product
+{
+ String name;
+ double price;
+ java.util.Date endDate;
+ ...
+}
+
+<jdo>
+ <package name="mydomain">
+ <class name="Product">
+ <field name="name">
+ <column length="100" jdbc-type="VARCHAR"/>
+ </field>
+ <field name="abreviation">
+ <column length="20" jdbc-type="VARCHAR"/>
+ </field>
+ <field name="price"/>
+ <field name="endDate"/>
+ </class>
+ </package>
+</jdo>]]></source>
+ <br/>
+ </subsection>
+
+ <subsection name="Example 2 - Use of Implicit Parameters">
+ <p>
+ Let's repeat the previous query but this time using <i>implicit</i>
+ parameters.
+ </p>
+ <source>
+Declarative JDOQL :
+Query query = pm.newQuery(mydomain.Product.class,"price < :limit");
+query.setOrdering("price ascending");
+List results = (List)query.execute(150.00);
+
+Single-String JDOQL :
+Query query = pm.newQuery("SELECT FROM mydomain.Product WHERE " +
+ "price < :limit ORDER BY price ASCENDING");
+List results = (List)query.execute(150.00);</source>
+ <p>
+ So we omitted the declaration of the parameter and just prefixed it with
+ a colon (:)
+ </p>
+ <br/>
+ </subsection>
+
+ <subsection name="Example 3 - Comparison against Dates">
+ <p>
+ Here's another example using the same Product class as above, but this
+ time comparing to a Date field. Because we are using a type in our query,
+ we need to <I>import</I> it ...
+ just like you would in a Java class if you were using it there.
+ </p>
+ <source>
+Declarative JDOQL :
+Query query = pm.newQuery(domain.Product.class,
+ "endDate > best_before_limit");
+query.declareImports("import java.util.Date");
+query.declareParameters("Date best_before_limit");
+query.setOrdering("endDate descending");
+Collection results = (Collection)query.execute(my_date_limit);
+
+Single-String JDOQL :
+Query query = pm.newQuery("SELECT FROM mydomain.Product " +
+ "WHERE endDate > best_before_limit " +
+ "PARAMETERS Date best_before_limit " +
+ "import java.util.Date ORDER BY endDate DESC");
+List results = (List)query.execute(my_date_limit);</source>
+ <br/>
+ </subsection>
+
+ <subsection name="Example 4 - Instanceof">
+ <p>
+ This example demonstrates use of the "instanceof" operator. We have a
+ class A that has a field "b" of type B and B has subclasses B1, B2, B3.
+ Clearly the field "b" of A can be of type B, B1, B2, B3 etc, and we want
+ to find all objects of type A that have the field "b" that is of type B2.
+ We do it like this
+ </p>
+ <source>
+Declarative JDOQL :
+Query query = pm.newQuery(mydomain.A.class);
+query.setFilter("b instanceof mydomain.B2");
+List results = (List)query.execute();
+
+Single-String JDOQL :
+Query query = pm.newQuery("SELECT FROM mydomain.A WHERE b instanceof mydomain.B2");
+List results = (List)query.execute();</source>
+ </subsection>
+ </section>
+
+ </body>
+</document>
Modified: db/jdo/site/xdocs/navigation.xml
URL: http://svn.apache.org/viewvc/db/jdo/site/xdocs/navigation.xml?rev=772590&r1=772589&r2=772590&view=diff
==============================================================================
--- db/jdo/site/xdocs/navigation.xml (original)
+++ db/jdo/site/xdocs/navigation.xml Thu May 7 10:25:02 2009
@@ -35,6 +35,7 @@
<item name="Transactions" href="/transactions.html"/>
<item name="Object States" href="/state_transition.html"/>
<item name="Object Retrieval" href="/object_retrieval.html"/>
+ <item name="JDOQL" href="/jdoql.html"/>
<item name="Extents" href="/extents.html"/>
<item name="Guides" href="/guides.html" collapse="true">
<item name="Datastore Replication" href="/guides/replication.html"/>
Modified: db/jdo/site/xdocs/object_retrieval.xml
URL: http://svn.apache.org/viewvc/db/jdo/site/xdocs/object_retrieval.xml?rev=772590&r1=772589&r2=772590&view=diff
==============================================================================
--- db/jdo/site/xdocs/object_retrieval.xml (original)
+++ db/jdo/site/xdocs/object_retrieval.xml Thu May 7 10:25:02 2009
@@ -7,26 +7,30 @@
<body>
<section name="Object Retrieval">
<p>
- JDO provides persistence of objects. The logical next step after persisting objects is to retrieve them
- for use in your application. There are several ways to do this
+ JDO provides persistence of objects. The logical next step after persisting
+ objects is to retrieve them for use in your application.
+ There are several ways to do this
</p>
<subsection name="Retrieve an object from its identity">
<p>
- The simplest form of object retrieval is where we have the identity. This is simply
+ The simplest form of object retrieval is where we have the identity.
+ This is simply
</p>
<source>
Object obj = pm.getObjectById(identity);
</source>
<p>
- If the object is in the JDO cache then it is retrieved from there, otherwise the JDO implementation
- goes to the datastore. When the object is retrieved its fields are populated according to its Fetch Group.
+ If the object is in the JDO cache then it is retrieved from there,
+ otherwise the JDO implementation goes to the datastore. When the object
+ is retrieved its fields are populated according to its Fetch Group.
</p>
</subsection>
<subsection name="Retrieve an object based on its Extent">
<p>
- A persistable class can be persisted with an <b>Extent</b> of all instances of that type.
+ A persistable class can be persisted with an <b>Extent</b> of all
+ instances of that type.
You can use this to retrieve objects of the required type, like this
</p>
<source>
@@ -38,21 +42,23 @@
...
}</source>
<p>
- The second argument in the <i>getExtent</i> call is whether to include instances of subclasses.
+ The second argument in the <i>getExtent</i> call is whether to include
+ instances of subclasses.
</p>
<br/>
</subsection>
<subsection name="Retrieve an object based on a criteria">
<p>
- Where we want to retrieve all objects based on some criteria (e.g all objects of class A where
- field 'x' of A is a certain value) we need to use a query language. JDO2 provides 2 options here.
- JDOQL is object-based and allows you to express your query in terms of the classes and fields
- you are using. SQL is datastore-based and allows you to express your query in terms of the
- datastore tables and columns.
+ Where we want to retrieve all objects based on some criteria (e.g all
+ objects of class A where field 'x' of A is a certain value) we need to
+ use a query language. JDO2 provides 2 options here. JDOQL is object-based
+ and allows you to express your query in terms of the classes and fields
+ you are using. SQL is datastore-based and allows you to express your query
+ in terms of the datastore tables and columns.
</p>
<p>
- To give an exmaple of a JDOQL query
+ To give an example of a JDOQL query
</p>
<source><![CDATA[
Query q = pm.newQuery(MyClass.class, "field1 < value");
@@ -64,8 +70,10 @@
MyClass obj = (MyClass)iter.next();
}]]></source>
<p>
- If the objects found by the query are in the JDO cache then they are retrieved from there, otherwise the
- JDO implementation goes to the datastore. When the objects are retrieved their fields are populated according to the Fetch Group.
+ If the objects found by the query are in the JDO cache then they are
+ retrieved from there, otherwise the JDO implementation goes to the
+ datastore. When the objects are retrieved their fields are populated
+ according to the Fetch Group.
</p>
</subsection>
</section>