You are viewing a plain text version of this content. The canonical link for it is here.
Posted to general@db.apache.org by an...@apache.org on 2013/01/15 07:29:02 UTC
svn commit: r846705 [12/20] - in /websites/production/db/content/jdo: ./
guides/ images/ images/logos/ releases/
Modified: websites/production/db/content/jdo/newshistory.html
==============================================================================
--- websites/production/db/content/jdo/newshistory.html (original)
+++ websites/production/db/content/jdo/newshistory.html Tue Jan 15 06:29:01 2013
@@ -1,16 +1,259 @@
-<!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) - News</title><style type="text/css" media="all">
- @import url("./style/maven-base.css");
-
- @import url("./style/maven-theme.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta><meta name="author" content="JDO Documentation Team"></meta><meta name="email" content="jdo-dev@db.apache.org"></meta></head><body class="composite"><div id="banner"><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">Wh
y 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">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"><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 c
lass="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="menuArticles"><h5>Articles</h5><ul><li class="none"><a href="jdo_3_0_overview.html">JDO 3.0 Overview</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-st
andards.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="Older_JDO_News"></a><h2>Older JDO News</h2><p>
-<strong>JDO code donated to Apache by Sun Microsystems, Inc.</strong>
-</p><p>On 9-Mar-2005 Sun Microsystems, Inc. officially donated
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia Site Renderer 1.3 at Jan 15, 2013 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <title>Maven -
+ News</title>
+ <style type="text/css" media="all">
+ @import url("./css/maven-base.css");
+ @import url("./css/maven-theme.css");
+ @import url("./css/site.css");
+ </style>
+ <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
+ <meta name="author" content="JDO Documentation Team" />
+ <meta name="Date-Revision-yyyymmdd" content="20130115" />
+ <meta http-equiv="Content-Language" content="en" />
+
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="./" id="bannerLeft">
+ <img src="images/JDOx150.gif" alt="Apache JDO" />
+ </a>
+ <a href="./" id="bannerRight">
+ <img src="images/jdo_text.gif" alt="Apache JDO" />
+ </a>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+ <div class="xright"> <a href="http://wiki.apache.org/jdo" class="externalLink" title="Wiki">Wiki</a>
+ |
+ <a href="http://issues.apache.org/jira/secure/BrowseProject.jspa?id=10630" class="externalLink" title="Issue Tracker">Issue Tracker</a>
+ |
+ <a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+ |
+ <a href="api30/apidocs/index.html" title="Latest Javadocs">Latest Javadocs</a>
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+ <h5>General</h5>
+ <ul>
+ <li class="none">
+ <a href="index.html" title="Home">Home</a>
+ </li>
+ <li class="none">
+ <a href="why_jdo.html" title="Why JDO?">Why JDO?</a>
+ </li>
+ <li class="none">
+ <a href="jdo_v_jpa.html" title="JDO v JPA">JDO v JPA</a>
+ </li>
+ <li class="none">
+ <a href="jdo_v_jpa_api.html" title="JDO v JPA : API">JDO v JPA : API</a>
+ </li>
+ <li class="none">
+ <a href="jdo_v_jpa_orm.html" title="JDO v JPA : ORM">JDO v JPA : ORM</a>
+ </li>
+ <li class="none">
+ <a href="downloads.html" title="Downloads">Downloads</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/LICENSE-2.0" class="externalLink" title="License">License</a>
+ </li>
+ </ul>
+ <h5>JDO Implementation</h5>
+ <ul>
+ <li class="none">
+ <a href="specifications.html" title="Specifications">Specifications</a>
+ </li>
+ <li class="none">
+ <a href="tck.html" title="TCK">TCK</a>
+ </li>
+ </ul>
+ <h5>JDO Usage</h5>
+ <ul>
+ <li class="none">
+ <a href="impls.html" title="Implementations">Implementations</a>
+ </li>
+ <li class="none">
+ <a href="javadoc.html" title="API Javadoc">API Javadoc</a>
+ </li>
+ <li class="none">
+ <a href="class_types.html" title="Types of Classes">Types of Classes</a>
+ </li>
+ <li class="none">
+ <a href="field_types.html" title="Types of Fields">Types of Fields</a>
+ </li>
+ <li class="collapsed">
+ <a href="metadata.html" title="MetaData">MetaData</a>
+ </li>
+ <li class="none">
+ <a href="enhancement.html" title="Bytecode Enhancement">Bytecode Enhancement</a>
+ </li>
+ <li class="none">
+ <a href="jdohelper.html" title="JDOHelper">JDOHelper</a>
+ </li>
+ <li class="none">
+ <a href="pmf.html" title="PersistenceManagerFactory">PersistenceManagerFactory</a>
+ </li>
+ <li class="none">
+ <a href="pm.html" title="PersistenceManager">PersistenceManager</a>
+ </li>
+ <li class="none">
+ <a href="transactions.html" title="Transactions">Transactions</a>
+ </li>
+ <li class="none">
+ <a href="attach_detach.html" title="Attach-Detach">Attach-Detach</a>
+ </li>
+ <li class="none">
+ <a href="fetchgroups.html" title="Fetch Groups">Fetch Groups</a>
+ </li>
+ <li class="none">
+ <a href="state_transition.html" title="Object States">Object States</a>
+ </li>
+ <li class="none">
+ <a href="object_retrieval.html" title="Object Retrieval">Object Retrieval</a>
+ </li>
+ <li class="expanded">
+ <a href="jdoql.html" title="JDOQL">JDOQL</a>
+ <ul>
+ <li class="none">
+ <a href="jdoql_result.html" title="Result">Result</a>
+ </li>
+ <li class="none">
+ <a href="jdoql_methods.html" title="Methods">Methods</a>
+ </li>
+ <li class="none">
+ <a href="jdoql_quickref.pdf" title="Quick Ref PDF">Quick Ref PDF</a>
+ </li>
+ </ul>
+ </li>
+ <li class="none">
+ <a href="extents.html" title="Extents">Extents</a>
+ </li>
+ <li class="collapsed">
+ <a href="guides.html" title="Guides">Guides</a>
+ </li>
+ <li class="none">
+ <a href="references.html" title="References">References</a>
+ </li>
+ <li class="none">
+ <a href="exceptions.html" title="Exceptions">Exceptions</a>
+ </li>
+ <li class="none">
+ <a href="glossary.html" title="Glossary">Glossary</a>
+ </li>
+ </ul>
+ <h5>Articles</h5>
+ <ul>
+ <li class="none">
+ <a href="jdo_3_0_overview.html" title="JDO 3.0 Overview">JDO 3.0 Overview</a>
+ </li>
+ </ul>
+ <h5>Community</h5>
+ <ul>
+ <li class="none">
+ <a href="get-involved.html" title="Get Involved">Get Involved</a>
+ </li>
+ <li class="none">
+ <a href="team-list.html" title="Project Team">Project Team</a>
+ </li>
+ <li class="none">
+ <a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+ </li>
+ <li class="none">
+ <a href="faq.html" title="FAQ">FAQ</a>
+ </li>
+ </ul>
+ <h5>Development</h5>
+ <ul>
+ <li class="none">
+ <a href="roadmap.html" title="RoadMap / TODO">RoadMap / TODO</a>
+ </li>
+ <li class="none">
+ <a href="svn.html" title="Source Code">Source Code</a>
+ </li>
+ <li class="none">
+ <a href="http://cwiki.apache.org/GMOxDEV/coding-standards.html" class="externalLink" title="Coding Standards">Coding Standards</a>
+ </li>
+ <li class="none">
+ <a href="issuetracking.html" title="Issue Tracking">Issue Tracking</a>
+ </li>
+ <li class="none">
+ <a href="dependencies.html" title="Dependencies">Dependencies</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img class="poweredBy" alt="Built by Maven" src="./images/logos/maven-feather.png" />
+ </a>
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+ <!-- Licensed to the Apache Software Foundation (ASF) under one or more
+contributor license agreements. See the NOTICE file distributed with
+this work for additional information regarding copyright ownership.
+The ASF licenses this file to You under the Apache License, Version 2.0
+(the "License"); you may not use this file except in compliance with
+the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License. -->
+
+
+
+<div class="section"><h2>Older JDO News<a name="Older_JDO_News"></a></h2>
+
+<p>
+<b>JDO code donated to Apache by Sun Microsystems, Inc.</b>
+</p>
+<p>On 9-Mar-2005 Sun Microsystems, Inc. officially donated
to Apache Software Foundation the
intellectual property known as Java Data Objects, v. 1.0.2 and
successors thereto to the extent provided by Sun.
-</p><p>
+</p>
+<p>
This was accomplished via Schedule B-2 to the Software Grant and
Corporate Contributor License Agreement (CCLA) between
The Apache Software Foundation and Sun Microsystems, Inc.
-</p></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-2011 <a href="http://www.apache.org/">Apache Software Foundation</a></div></div></body></html>
\ No newline at end of file
+</p>
+ </div>
+
+
+
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">
+ Copyright © 2005-2013.
+ All Rights Reserved.
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Modified: websites/production/db/content/jdo/object_retrieval.html
==============================================================================
--- websites/production/db/content/jdo/object_retrieval.html (original)
+++ websites/production/db/content/jdo/object_retrieval.html Tue Jan 15 06:29:01 2013
@@ -1,27 +1,239 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>Java Data Objects (JDO) - JDO Object Retrieval</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"><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"><strong><a href="object_retrieval.html">Object Retrieval</a></strong></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="menuArticles"><h5>Articles</h5><ul><li class="none"><a href="jdo_3_0_overview.html">JDO 3.0 Overview</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="Object_Retrieval"></a><h2>Object Retrieval</h2><p>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia Site Renderer 1.3 at Jan 15, 2013 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <title>Maven -
+ JDO Object Retrieval</title>
+ <style type="text/css" media="all">
+ @import url("./css/maven-base.css");
+ @import url("./css/maven-theme.css");
+ @import url("./css/site.css");
+ </style>
+ <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
+ <meta name="Date-Revision-yyyymmdd" content="20130115" />
+ <meta http-equiv="Content-Language" content="en" />
+
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="./" id="bannerLeft">
+ <img src="images/JDOx150.gif" alt="Apache JDO" />
+ </a>
+ <a href="./" id="bannerRight">
+ <img src="images/jdo_text.gif" alt="Apache JDO" />
+ </a>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+ <div class="xright"> <a href="http://wiki.apache.org/jdo" class="externalLink" title="Wiki">Wiki</a>
+ |
+ <a href="http://issues.apache.org/jira/secure/BrowseProject.jspa?id=10630" class="externalLink" title="Issue Tracker">Issue Tracker</a>
+ |
+ <a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+ |
+ <a href="api30/apidocs/index.html" title="Latest Javadocs">Latest Javadocs</a>
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+ <h5>General</h5>
+ <ul>
+ <li class="none">
+ <a href="index.html" title="Home">Home</a>
+ </li>
+ <li class="none">
+ <a href="why_jdo.html" title="Why JDO?">Why JDO?</a>
+ </li>
+ <li class="none">
+ <a href="jdo_v_jpa.html" title="JDO v JPA">JDO v JPA</a>
+ </li>
+ <li class="none">
+ <a href="jdo_v_jpa_api.html" title="JDO v JPA : API">JDO v JPA : API</a>
+ </li>
+ <li class="none">
+ <a href="jdo_v_jpa_orm.html" title="JDO v JPA : ORM">JDO v JPA : ORM</a>
+ </li>
+ <li class="none">
+ <a href="downloads.html" title="Downloads">Downloads</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/LICENSE-2.0" class="externalLink" title="License">License</a>
+ </li>
+ </ul>
+ <h5>JDO Implementation</h5>
+ <ul>
+ <li class="none">
+ <a href="specifications.html" title="Specifications">Specifications</a>
+ </li>
+ <li class="none">
+ <a href="tck.html" title="TCK">TCK</a>
+ </li>
+ </ul>
+ <h5>JDO Usage</h5>
+ <ul>
+ <li class="none">
+ <a href="impls.html" title="Implementations">Implementations</a>
+ </li>
+ <li class="none">
+ <a href="javadoc.html" title="API Javadoc">API Javadoc</a>
+ </li>
+ <li class="none">
+ <a href="class_types.html" title="Types of Classes">Types of Classes</a>
+ </li>
+ <li class="none">
+ <a href="field_types.html" title="Types of Fields">Types of Fields</a>
+ </li>
+ <li class="collapsed">
+ <a href="metadata.html" title="MetaData">MetaData</a>
+ </li>
+ <li class="none">
+ <a href="enhancement.html" title="Bytecode Enhancement">Bytecode Enhancement</a>
+ </li>
+ <li class="none">
+ <a href="jdohelper.html" title="JDOHelper">JDOHelper</a>
+ </li>
+ <li class="none">
+ <a href="pmf.html" title="PersistenceManagerFactory">PersistenceManagerFactory</a>
+ </li>
+ <li class="none">
+ <a href="pm.html" title="PersistenceManager">PersistenceManager</a>
+ </li>
+ <li class="none">
+ <a href="transactions.html" title="Transactions">Transactions</a>
+ </li>
+ <li class="none">
+ <a href="attach_detach.html" title="Attach-Detach">Attach-Detach</a>
+ </li>
+ <li class="none">
+ <a href="fetchgroups.html" title="Fetch Groups">Fetch Groups</a>
+ </li>
+ <li class="none">
+ <a href="state_transition.html" title="Object States">Object States</a>
+ </li>
+ <li class="none">
+ <strong>Object Retrieval</strong>
+ </li>
+ <li class="expanded">
+ <a href="jdoql.html" title="JDOQL">JDOQL</a>
+ <ul>
+ <li class="none">
+ <a href="jdoql_result.html" title="Result">Result</a>
+ </li>
+ <li class="none">
+ <a href="jdoql_methods.html" title="Methods">Methods</a>
+ </li>
+ <li class="none">
+ <a href="jdoql_quickref.pdf" title="Quick Ref PDF">Quick Ref PDF</a>
+ </li>
+ </ul>
+ </li>
+ <li class="none">
+ <a href="extents.html" title="Extents">Extents</a>
+ </li>
+ <li class="collapsed">
+ <a href="guides.html" title="Guides">Guides</a>
+ </li>
+ <li class="none">
+ <a href="references.html" title="References">References</a>
+ </li>
+ <li class="none">
+ <a href="exceptions.html" title="Exceptions">Exceptions</a>
+ </li>
+ <li class="none">
+ <a href="glossary.html" title="Glossary">Glossary</a>
+ </li>
+ </ul>
+ <h5>Articles</h5>
+ <ul>
+ <li class="none">
+ <a href="jdo_3_0_overview.html" title="JDO 3.0 Overview">JDO 3.0 Overview</a>
+ </li>
+ </ul>
+ <h5>Community</h5>
+ <ul>
+ <li class="none">
+ <a href="get-involved.html" title="Get Involved">Get Involved</a>
+ </li>
+ <li class="none">
+ <a href="team-list.html" title="Project Team">Project Team</a>
+ </li>
+ <li class="none">
+ <a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+ </li>
+ <li class="none">
+ <a href="faq.html" title="FAQ">FAQ</a>
+ </li>
+ </ul>
+ <h5>Development</h5>
+ <ul>
+ <li class="none">
+ <a href="roadmap.html" title="RoadMap / TODO">RoadMap / TODO</a>
+ </li>
+ <li class="none">
+ <a href="svn.html" title="Source Code">Source Code</a>
+ </li>
+ <li class="none">
+ <a href="http://cwiki.apache.org/GMOxDEV/coding-standards.html" class="externalLink" title="Coding Standards">Coding Standards</a>
+ </li>
+ <li class="none">
+ <a href="issuetracking.html" title="Issue Tracking">Issue Tracking</a>
+ </li>
+ <li class="none">
+ <a href="dependencies.html" title="Dependencies">Dependencies</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img class="poweredBy" alt="Built by Maven" src="./images/logos/maven-feather.png" />
+ </a>
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+
+
+ <div class="section"><h2>Object Retrieval<a name="Object_Retrieval"></a></h2>
+ <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
- </p><div class="subsection"><a name="Retrieve_an_object_from_its_identity"></a><h3>Retrieve an object from its identity</h3><p>
+ </p>
+
+ <div class="section"><h3>Retrieve an object from its identity<a name="Retrieve_an_object_from_its_identity"></a></h3>
+ <p>
The simplest form of object retrieval is where we have the identity.
This is simply
</p>
- <div class="source"><pre>
+ <div class="source"><pre>
Object obj = pm.getObjectById(identity);
</pre></div>
- <p>
+ <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.
- </p></div><div class="subsection"><a name="Retrieve_an_object_based_on_its_Extent"></a><h3>Retrieve an object based on its Extent</h3><p>
+ </p>
+ </div>
+
+ <div class="section"><h3>Retrieve an object based on its Extent<a name="Retrieve_an_object_based_on_its_Extent"></a></h3>
+ <p>
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>
- <div class="source"><pre>
+ <div class="source"><pre>
Extent ex = pm.getExtent(MyClass.class, true);
Iterator iter = ex.iterator();
while (iter.hasNext())
@@ -29,33 +241,59 @@ while (iter.hasNext())
MyClass obj = (MyClass)iter.next();
...
}</pre></div>
- <p>
+ <p>
The second argument in the <i>getExtent</i> call is whether to include
instances of subclasses.
- </p><br></br></div><div class="subsection"><a name="Retrieve_an_object_based_on_a_criteria"></a><h3>Retrieve an object based on a criteria</h3><p>
+ </p>
+ <br />
+ </div>
+
+ <div class="section"><h3>Retrieve an object based on a criteria<a name="Retrieve_an_object_based_on_a_criteria"></a></h3>
+ <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.
- </p><p>
+ </p>
+ <p>
To give an example of a JDOQL query
</p>
- <div class="source"><pre>
-Query q = pm.newQuery(MyClass.class, "field1 < value");
-q.declareParameters("int value");
+ <div class="source"><pre>
+Query q = pm.newQuery(MyClass.class, "field1 < value");
+q.declareParameters("int value");
List results = q.execute(205);
Iterator iter = results.iterator();
while (iter.hasNext())
{
MyClass obj = (MyClass)iter.next();
}</pre></div>
- <p>
+ <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.
- </p></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-2011 <a href="http://www.apache.org/">Apache Software Foundation</a></div></div></body></html>
\ No newline at end of file
+ </p>
+ </div>
+ </div>
+
+
+
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">
+ Copyright © 2005-2013.
+ All Rights Reserved.
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Modified: websites/production/db/content/jdo/orm_dtd.html
==============================================================================
--- websites/production/db/content/jdo/orm_dtd.html (original)
+++ websites/production/db/content/jdo/orm_dtd.html Tue Jan 15 06:29:01 2013
@@ -1,36 +1,276 @@
-<!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) - ORM DTD</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="expanded"><a href="metadata.html">MetaData</a><ul><li class="none"><a href="jdo_dtd.html">jdo DTD/XSD</a></li><li class="none"><strong><a href="orm_dtd.html">orm DTD
/XSD</a></strong></li><li class="none"><a href="jdoquery_dtd.html">jdoquery DTD/XSD</a></li><li class="none"><a href="jdoconfig_dtd.html">jdoconfig DTD/XSD</a></li></ul></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="jdo
ql_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="menuArticles"><h5>Articles</h5><ul><li class="none"><a href="jdo_3_0_overview.html">JDO 3.0 Overview</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="Meta-Data_-_ORM"></a><h2>Meta-Data - ORM</h2><p>
- JDO2 defines XML MetaData in <B>jdo</B> files as well as <B>orm</B> files.
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia Site Renderer 1.3 at Jan 15, 2013 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <title>Maven -
+ ORM DTD</title>
+ <style type="text/css" media="all">
+ @import url("./css/maven-base.css");
+ @import url("./css/maven-theme.css");
+ @import url("./css/site.css");
+ </style>
+ <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
+ <meta name="Date-Revision-yyyymmdd" content="20130115" />
+ <meta http-equiv="Content-Language" content="en" />
+
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="./" id="bannerLeft">
+ <img src="images/JDOx150.gif" alt="Apache JDO" />
+ </a>
+ <a href="./" id="bannerRight">
+ <img src="images/jdo_text.gif" alt="Apache JDO" />
+ </a>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+ <div class="xright"> <a href="http://wiki.apache.org/jdo" class="externalLink" title="Wiki">Wiki</a>
+ |
+ <a href="http://issues.apache.org/jira/secure/BrowseProject.jspa?id=10630" class="externalLink" title="Issue Tracker">Issue Tracker</a>
+ |
+ <a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+ |
+ <a href="api30/apidocs/index.html" title="Latest Javadocs">Latest Javadocs</a>
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+ <h5>General</h5>
+ <ul>
+ <li class="none">
+ <a href="index.html" title="Home">Home</a>
+ </li>
+ <li class="none">
+ <a href="why_jdo.html" title="Why JDO?">Why JDO?</a>
+ </li>
+ <li class="none">
+ <a href="jdo_v_jpa.html" title="JDO v JPA">JDO v JPA</a>
+ </li>
+ <li class="none">
+ <a href="jdo_v_jpa_api.html" title="JDO v JPA : API">JDO v JPA : API</a>
+ </li>
+ <li class="none">
+ <a href="jdo_v_jpa_orm.html" title="JDO v JPA : ORM">JDO v JPA : ORM</a>
+ </li>
+ <li class="none">
+ <a href="downloads.html" title="Downloads">Downloads</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/LICENSE-2.0" class="externalLink" title="License">License</a>
+ </li>
+ </ul>
+ <h5>JDO Implementation</h5>
+ <ul>
+ <li class="none">
+ <a href="specifications.html" title="Specifications">Specifications</a>
+ </li>
+ <li class="none">
+ <a href="tck.html" title="TCK">TCK</a>
+ </li>
+ </ul>
+ <h5>JDO Usage</h5>
+ <ul>
+ <li class="none">
+ <a href="impls.html" title="Implementations">Implementations</a>
+ </li>
+ <li class="none">
+ <a href="javadoc.html" title="API Javadoc">API Javadoc</a>
+ </li>
+ <li class="none">
+ <a href="class_types.html" title="Types of Classes">Types of Classes</a>
+ </li>
+ <li class="none">
+ <a href="field_types.html" title="Types of Fields">Types of Fields</a>
+ </li>
+ <li class="expanded">
+ <a href="metadata.html" title="MetaData">MetaData</a>
+ <ul>
+ <li class="none">
+ <a href="jdo_dtd.html" title="jdo DTD/XSD">jdo DTD/XSD</a>
+ </li>
+ <li class="none">
+ <strong>orm DTD/XSD</strong>
+ </li>
+ <li class="none">
+ <a href="jdoquery_dtd.html" title="jdoquery DTD/XSD">jdoquery DTD/XSD</a>
+ </li>
+ <li class="none">
+ <a href="jdoconfig_dtd.html" title="jdoconfig DTD/XSD">jdoconfig DTD/XSD</a>
+ </li>
+ </ul>
+ </li>
+ <li class="none">
+ <a href="enhancement.html" title="Bytecode Enhancement">Bytecode Enhancement</a>
+ </li>
+ <li class="none">
+ <a href="jdohelper.html" title="JDOHelper">JDOHelper</a>
+ </li>
+ <li class="none">
+ <a href="pmf.html" title="PersistenceManagerFactory">PersistenceManagerFactory</a>
+ </li>
+ <li class="none">
+ <a href="pm.html" title="PersistenceManager">PersistenceManager</a>
+ </li>
+ <li class="none">
+ <a href="transactions.html" title="Transactions">Transactions</a>
+ </li>
+ <li class="none">
+ <a href="attach_detach.html" title="Attach-Detach">Attach-Detach</a>
+ </li>
+ <li class="none">
+ <a href="fetchgroups.html" title="Fetch Groups">Fetch Groups</a>
+ </li>
+ <li class="none">
+ <a href="state_transition.html" title="Object States">Object States</a>
+ </li>
+ <li class="none">
+ <a href="object_retrieval.html" title="Object Retrieval">Object Retrieval</a>
+ </li>
+ <li class="expanded">
+ <a href="jdoql.html" title="JDOQL">JDOQL</a>
+ <ul>
+ <li class="none">
+ <a href="jdoql_result.html" title="Result">Result</a>
+ </li>
+ <li class="none">
+ <a href="jdoql_methods.html" title="Methods">Methods</a>
+ </li>
+ <li class="none">
+ <a href="jdoql_quickref.pdf" title="Quick Ref PDF">Quick Ref PDF</a>
+ </li>
+ </ul>
+ </li>
+ <li class="none">
+ <a href="extents.html" title="Extents">Extents</a>
+ </li>
+ <li class="collapsed">
+ <a href="guides.html" title="Guides">Guides</a>
+ </li>
+ <li class="none">
+ <a href="references.html" title="References">References</a>
+ </li>
+ <li class="none">
+ <a href="exceptions.html" title="Exceptions">Exceptions</a>
+ </li>
+ <li class="none">
+ <a href="glossary.html" title="Glossary">Glossary</a>
+ </li>
+ </ul>
+ <h5>Articles</h5>
+ <ul>
+ <li class="none">
+ <a href="jdo_3_0_overview.html" title="JDO 3.0 Overview">JDO 3.0 Overview</a>
+ </li>
+ </ul>
+ <h5>Community</h5>
+ <ul>
+ <li class="none">
+ <a href="get-involved.html" title="Get Involved">Get Involved</a>
+ </li>
+ <li class="none">
+ <a href="team-list.html" title="Project Team">Project Team</a>
+ </li>
+ <li class="none">
+ <a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+ </li>
+ <li class="none">
+ <a href="faq.html" title="FAQ">FAQ</a>
+ </li>
+ </ul>
+ <h5>Development</h5>
+ <ul>
+ <li class="none">
+ <a href="roadmap.html" title="RoadMap / TODO">RoadMap / TODO</a>
+ </li>
+ <li class="none">
+ <a href="svn.html" title="Source Code">Source Code</a>
+ </li>
+ <li class="none">
+ <a href="http://cwiki.apache.org/GMOxDEV/coding-standards.html" class="externalLink" title="Coding Standards">Coding Standards</a>
+ </li>
+ <li class="none">
+ <a href="issuetracking.html" title="Issue Tracking">Issue Tracking</a>
+ </li>
+ <li class="none">
+ <a href="dependencies.html" title="Dependencies">Dependencies</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img class="poweredBy" alt="Built by Maven" src="./images/logos/maven-feather.png" />
+ </a>
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+
+
+ <div class="section"><h2>Meta-Data - ORM<a name="Meta-Data_-_ORM"></a></h2>
+ <p>
+ JDO defines XML MetaData in <b>jdo</b> files as well as <b>orm</b> files.
As always with XML, the metadata must match the defined DTD/XSD for that file type.
- This section describes the content of the <B>orm</B> files.
- The content of <B>jdo</B> files can be found <a href="jdo_dtd.html">here</a>.
- All <B>orm</B> files must contain a valid DTD/DOCTYPE specification. You can use PUBLIC or SYSTEM versions of these.
- </p><p>
- Here are a couple of examples valid for <B>orm</B> files with DTD specification
+ This section describes the content of the <b>orm</b> files.
+ The content of <b>jdo</b> files can be found <a href="jdo_dtd.html">here</a>.
+ All <b>orm</b> files must contain a valid DTD/DOCTYPE specification. You can use PUBLIC or SYSTEM versions of these.
</p>
- <div class="source"><pre>
+ <p>
+ Here are a couple of examples valid for <b>orm</b> files with DTD specification
+ </p>
+ <div class="source"><pre>
<!DOCTYPE orm PUBLIC
- "-//Sun Microsystems, Inc.//DTD Java Data Objects Mapping Metadata 3.0//EN"
- "http://java.sun.com/dtd/orm_3_0.dtd">
+ "-//Sun Microsystems, Inc.//DTD Java Data Objects Mapping Metadata 3.0//EN"
+ "http://java.sun.com/dtd/orm_3_0.dtd">
-<!DOCTYPE orm SYSTEM "file:/javax/jdo/orm.dtd"></pre></div>
- <br></br><p>
- Here is an example valid for <B>orm</B> files with XSD specification
+<!DOCTYPE orm SYSTEM "file:/javax/jdo/orm.dtd"></pre></div>
+ <br />
+ <p>
+ Here is an example valid for <b>orm</b> files with XSD specification
</p>
- <div class="source"><pre>
-<?xml version="1.0" encoding="UTF-8" ?>
-<orm xmlns="http://java.sun.com/xml/ns/jdo/orm"
- xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="http://java.sun.com/xml/ns/jdo/orm
- http://java.sun.com/xml/ns/jdo/orm_3_0.xsd">
+ <div class="source"><pre>
+<?xml version="1.0" encoding="UTF-8" ?>
+<orm xmlns="http://java.sun.com/xml/ns/jdo/orm"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://java.sun.com/xml/ns/jdo/orm
+ http://java.sun.com/xml/ns/jdo/orm_3_0.xsd">
...
</orm></pre></div>
- <p>
- Your MetaData should match either the <a href="http://java.sun.com/dtd/orm_3_0.dtd" class="newWindow" title="New Window" target="_blank">DTD</a>
- or the <a href="http://java.sun.com/xml/ns/jdo/orm_3_0.xsd" class="newWindow" title="New Window" target="_blank">XSD</a> specification.
- </p></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-2011 <a href="http://www.apache.org/">Apache Software Foundation</a></div></div></body></html>
\ No newline at end of file
+ <p>
+ Your MetaData should match either the <a class="externalLink" href="http://java.sun.com/dtd/orm_3_0.dtd" target="_blank">DTD</a>
+ or the <a class="externalLink" href="http://java.sun.com/xml/ns/jdo/orm_3_0.xsd" target="_blank">XSD</a> specification.
+ </p>
+
+ </div>
+
+
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">
+ Copyright © 2005-2013.
+ All Rights Reserved.
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>
Modified: websites/production/db/content/jdo/pm.html
==============================================================================
--- websites/production/db/content/jdo/pm.html (original)
+++ websites/production/db/content/jdo/pm.html Tue Jan 15 06:29:01 2013
@@ -1,27 +1,237 @@
-<!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) - Persistence Manager</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"><strong><a href="pm.html">PersistenceManager</a></strong></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="menuArticles"><h5>Articles</h5><ul><li class="none"><a href="jdo_3_0_overview.html">JDO 3.0 Overview</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="Persistence_Manager"></a><h2>Persistence Manager</h2><p>
- Any JDO-enabled application will require at least one <I>PersistenceManager</I> (PM).
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!-- Generated by Apache Maven Doxia Site Renderer 1.3 at Jan 15, 2013 -->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+ <head>
+ <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+ <title>Maven -
+ Persistence Manager</title>
+ <style type="text/css" media="all">
+ @import url("./css/maven-base.css");
+ @import url("./css/maven-theme.css");
+ @import url("./css/site.css");
+ </style>
+ <link rel="stylesheet" href="./css/print.css" type="text/css" media="print" />
+ <meta name="Date-Revision-yyyymmdd" content="20130115" />
+ <meta http-equiv="Content-Language" content="en" />
+
+ </head>
+ <body class="composite">
+ <div id="banner">
+ <a href="./" id="bannerLeft">
+ <img src="images/JDOx150.gif" alt="Apache JDO" />
+ </a>
+ <a href="./" id="bannerRight">
+ <img src="images/jdo_text.gif" alt="Apache JDO" />
+ </a>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="breadcrumbs">
+
+
+ <div class="xright"> <a href="http://wiki.apache.org/jdo" class="externalLink" title="Wiki">Wiki</a>
+ |
+ <a href="http://issues.apache.org/jira/secure/BrowseProject.jspa?id=10630" class="externalLink" title="Issue Tracker">Issue Tracker</a>
+ |
+ <a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+ |
+ <a href="api30/apidocs/index.html" title="Latest Javadocs">Latest Javadocs</a>
+
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ <div id="leftColumn">
+ <div id="navcolumn">
+
+
+ <h5>General</h5>
+ <ul>
+ <li class="none">
+ <a href="index.html" title="Home">Home</a>
+ </li>
+ <li class="none">
+ <a href="why_jdo.html" title="Why JDO?">Why JDO?</a>
+ </li>
+ <li class="none">
+ <a href="jdo_v_jpa.html" title="JDO v JPA">JDO v JPA</a>
+ </li>
+ <li class="none">
+ <a href="jdo_v_jpa_api.html" title="JDO v JPA : API">JDO v JPA : API</a>
+ </li>
+ <li class="none">
+ <a href="jdo_v_jpa_orm.html" title="JDO v JPA : ORM">JDO v JPA : ORM</a>
+ </li>
+ <li class="none">
+ <a href="downloads.html" title="Downloads">Downloads</a>
+ </li>
+ <li class="none">
+ <a href="http://www.apache.org/licenses/LICENSE-2.0" class="externalLink" title="License">License</a>
+ </li>
+ </ul>
+ <h5>JDO Implementation</h5>
+ <ul>
+ <li class="none">
+ <a href="specifications.html" title="Specifications">Specifications</a>
+ </li>
+ <li class="none">
+ <a href="tck.html" title="TCK">TCK</a>
+ </li>
+ </ul>
+ <h5>JDO Usage</h5>
+ <ul>
+ <li class="none">
+ <a href="impls.html" title="Implementations">Implementations</a>
+ </li>
+ <li class="none">
+ <a href="javadoc.html" title="API Javadoc">API Javadoc</a>
+ </li>
+ <li class="none">
+ <a href="class_types.html" title="Types of Classes">Types of Classes</a>
+ </li>
+ <li class="none">
+ <a href="field_types.html" title="Types of Fields">Types of Fields</a>
+ </li>
+ <li class="collapsed">
+ <a href="metadata.html" title="MetaData">MetaData</a>
+ </li>
+ <li class="none">
+ <a href="enhancement.html" title="Bytecode Enhancement">Bytecode Enhancement</a>
+ </li>
+ <li class="none">
+ <a href="jdohelper.html" title="JDOHelper">JDOHelper</a>
+ </li>
+ <li class="none">
+ <a href="pmf.html" title="PersistenceManagerFactory">PersistenceManagerFactory</a>
+ </li>
+ <li class="none">
+ <strong>PersistenceManager</strong>
+ </li>
+ <li class="none">
+ <a href="transactions.html" title="Transactions">Transactions</a>
+ </li>
+ <li class="none">
+ <a href="attach_detach.html" title="Attach-Detach">Attach-Detach</a>
+ </li>
+ <li class="none">
+ <a href="fetchgroups.html" title="Fetch Groups">Fetch Groups</a>
+ </li>
+ <li class="none">
+ <a href="state_transition.html" title="Object States">Object States</a>
+ </li>
+ <li class="none">
+ <a href="object_retrieval.html" title="Object Retrieval">Object Retrieval</a>
+ </li>
+ <li class="expanded">
+ <a href="jdoql.html" title="JDOQL">JDOQL</a>
+ <ul>
+ <li class="none">
+ <a href="jdoql_result.html" title="Result">Result</a>
+ </li>
+ <li class="none">
+ <a href="jdoql_methods.html" title="Methods">Methods</a>
+ </li>
+ <li class="none">
+ <a href="jdoql_quickref.pdf" title="Quick Ref PDF">Quick Ref PDF</a>
+ </li>
+ </ul>
+ </li>
+ <li class="none">
+ <a href="extents.html" title="Extents">Extents</a>
+ </li>
+ <li class="collapsed">
+ <a href="guides.html" title="Guides">Guides</a>
+ </li>
+ <li class="none">
+ <a href="references.html" title="References">References</a>
+ </li>
+ <li class="none">
+ <a href="exceptions.html" title="Exceptions">Exceptions</a>
+ </li>
+ <li class="none">
+ <a href="glossary.html" title="Glossary">Glossary</a>
+ </li>
+ </ul>
+ <h5>Articles</h5>
+ <ul>
+ <li class="none">
+ <a href="jdo_3_0_overview.html" title="JDO 3.0 Overview">JDO 3.0 Overview</a>
+ </li>
+ </ul>
+ <h5>Community</h5>
+ <ul>
+ <li class="none">
+ <a href="get-involved.html" title="Get Involved">Get Involved</a>
+ </li>
+ <li class="none">
+ <a href="team-list.html" title="Project Team">Project Team</a>
+ </li>
+ <li class="none">
+ <a href="mail-lists.html" title="Mailing Lists">Mailing Lists</a>
+ </li>
+ <li class="none">
+ <a href="faq.html" title="FAQ">FAQ</a>
+ </li>
+ </ul>
+ <h5>Development</h5>
+ <ul>
+ <li class="none">
+ <a href="roadmap.html" title="RoadMap / TODO">RoadMap / TODO</a>
+ </li>
+ <li class="none">
+ <a href="svn.html" title="Source Code">Source Code</a>
+ </li>
+ <li class="none">
+ <a href="http://cwiki.apache.org/GMOxDEV/coding-standards.html" class="externalLink" title="Coding Standards">Coding Standards</a>
+ </li>
+ <li class="none">
+ <a href="issuetracking.html" title="Issue Tracking">Issue Tracking</a>
+ </li>
+ <li class="none">
+ <a href="dependencies.html" title="Dependencies">Dependencies</a>
+ </li>
+ </ul>
+ <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+ <img class="poweredBy" alt="Built by Maven" src="./images/logos/maven-feather.png" />
+ </a>
+
+
+ </div>
+ </div>
+ <div id="bodyColumn">
+ <div id="contentBox">
+
+
+ <div class="section"><h2>Persistence Manager<a name="Persistence_Manager"></a></h2>
+ <p>
+ Any JDO-enabled application will require at least one <i>PersistenceManager</i> (PM).
This is obtained from the <a href="pmf.html">PersistenceManagerFactory</a> for the datastore.
- </p><p>
- The simplest way of creating a <I>PersistenceManager</I>
- <a href="api20/apidocs/javax/jdo/PersistenceManager.html" class="newWindow" title="New Window" target="_blank"><IMG SRC="images/javadoc.gif"></IMG></a>
+ </p>
+ <p>
+ The simplest way of creating a <i>PersistenceManager</i>
+ <a href="api20/apidocs/javax/jdo/PersistenceManager.html" target="_blank"><img src="images/javadoc.gif" alt="" /></a>
is as follows
</p>
- <div class="source"><pre>
+ <div class="source"><pre>
PersistenceManagerFactory pmf = JDOHelper.getPersistenceManagerFactory(props);
PersistenceManager pm = pmf.getPersistenceManager();</pre></div>
- <p>
+ <p>
A <i>PersistenceManager</i> is the key to all persistence operations in JDO. With it you can
persist, update, delete, and retrieve objects from the datastore. A <i>PersistenceManager</i>
has a single transaction.
- </p><br></br><div class="subsection"><a name="Persist_Objects"></a><h3>Persist Objects</h3><p>
+ </p>
+ <br />
+
+ <div class="section"><h3>Persist Objects<a name="Persist_Objects"></a></h3>
+ <p>
To persist an object, the object must first be marked as persistable using
<a href="metadata.html">MetaData (XML/Annotations)</a>. Then you would start the
PM transaction, and use <i>makePersistent</i> as follows
</p>
- <div class="source"><pre>
+ <div class="source"><pre>
PersistenceManager pm = pmf.getPersistenceManager();
Transaction tx = pm.currentTransaction();
try
@@ -51,26 +261,32 @@ finally
}
pm.close();
}</pre></div>
- <p>
- The <I>makePersistent</I> method of <B>PersistenceManager</B> makes the object persistent in
- the datastore, and updates the 'state' of the object from <I>Transient</I> (at the start)
- to <I>Hollow</I> (after commit() of the transaction).
- </p><p>
+ <p>
+ The <i>makePersistent</i> method of <b>PersistenceManager</b> makes the object persistent in
+ the datastore, and updates the 'state' of the object from <i>Transient</i> (at the start)
+ to <i>Hollow</i> (after commit() of the transaction).
+ </p>
+ <p>
When an object is persisted, if it has any other objects referenced from that object they
- also will be made persistent. This is referred to as <B>persistence-by-reachability</B>.
+ also will be made persistent. This is referred to as <b>persistence-by-reachability</b>.
The main benefit of this is that if you have an object graph to persist, then you don't
- need to call <I>makePersistent()</I> on all objects, instead just using one that can be
- used to find all of the others. <B>persistence-by-reachability</B> is also run at the time of
- calling <I>commit()</I> on the transaction. This has the effect that if you had called
- <I>makePersistent()</I> on an object and that had persisted another object, and before
- commit you had removed the relation to this other object, then at <I>commit()</I> the
+ need to call <i>makePersistent()</i> on all objects, instead just using one that can be
+ used to find all of the others. <b>persistence-by-reachability</b> is also run at the time of
+ calling <i>commit()</i> on the transaction. This has the effect that if you had called
+ <i>makePersistent()</i> on an object and that had persisted another object, and before
+ commit you had removed the relation to this other object, then at <i>commit()</i> the
reachability algorithm will find that this other object is no longer reachable and will
remove it from persistence.
- </p><br></br></div><div class="subsection"><a name="Retrieve_Objects"></a><h3>Retrieve Objects</h3><p>
+ </p>
+ <br />
+ </div>
+
+ <div class="section"><h3>Retrieve Objects<a name="Retrieve_Objects"></a></h3>
+ <p>
So we've made some of our objects persistent, and now we want to retrieve them in
our application. Here's one way of retrieving objects of a particular type.
</p>
- <div class="source"><pre>
+ <div class="source"><pre>
tx = pm.currentTransaction();
try
{
@@ -93,15 +309,20 @@ catch (Exception e)
tx.rollback();
}
}</pre></div>
- <p>
- The <B>Extent</B> interface is one of the ways to retrieve your objects.
- The others use the <B>Query</B> interface, allowing more precise filtering over the
+ <p>
+ The <b>Extent</b> interface is one of the ways to retrieve your objects.
+ The others use the <b>Query</b> interface, allowing more precise filtering over the
objects returned.
- </p><br></br></div><div class="subsection"><a name="Update_Objects"></a><h3>Update Objects</h3><p>
+ </p>
+ <br />
+ </div>
+
+ <div class="section"><h3>Update Objects<a name="Update_Objects"></a></h3>
+ <p>
To update an object we firstly retrieve it, as above, and then we call any of its
mutator methods. For example
</p>
- <div class="source"><pre>
+ <div class="source"><pre>
tx = pm.currentTransaction();
try
{
@@ -125,13 +346,18 @@ catch (Exception e)
tx.rollback();
}
}</pre></div>
- <p>
+ <p>
When <i>setValue()</i> is called on the persistent object this change is intercepted
by JDO and the value change will be automatically sent to the datastore ... transparently!
- </p><br></br></div><div class="subsection"><a name="Delete_Objects"></a><h3>Delete Objects</h3><p>
+ </p>
+ <br />
+ </div>
+
+ <div class="section"><h3>Delete Objects<a name="Delete_Objects"></a></h3>
+ <p>
So we can persist objects, and retrieve them. Now we want to remove one from persistence.
</p>
- <div class="source"><pre>try
+ <div class="source"><pre>try
{
tx = pm.currentTransaction();
tx.begin();
@@ -149,14 +375,18 @@ catch (Exception e)
tx.rollback();
}
}</pre></div>
- <br></br></div><div class="subsection"><a name="Making_an_object_transient"></a><h3>Making an object transient</h3><p>
+ <br />
+ </div>
+
+ <div class="section"><h3>Making an object transient<a name="Making_an_object_transient"></a></h3>
+ <p>
As we have seen in the <a href="state_transition.html">JDO States guide</a>, an object can
have many possible states. When we want to take an object and work on it, but removing
- its identity we can make it <B>transient</B>. This means that it will retain the values
+ its identity we can make it <b>transient</b>. This means that it will retain the values
of its fields, yet will no longer be associated with the object in the datastore.
We do this as follows
</p>
- <div class="source"><pre>try
+ <div class="source"><pre>try
{
tx = pm.currentTransaction();
tx.begin();
@@ -175,7 +405,25 @@ catch (Exception e)
}
}
-... (code to work on "my_obj")</pre></div>
- </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-2011 <a href="http://www.apache.org/">Apache Software Foundation</a></div></div></body></html>
\ No newline at end of file
+... (code to work on "my_obj")</pre></div>
+ </div>
+ </div>
+
+
+ </div>
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ <div id="footer">
+ <div class="xright">
+ Copyright © 2005-2013.
+ All Rights Reserved.
+
+ </div>
+ <div class="clear">
+ <hr/>
+ </div>
+ </div>
+ </body>
+</html>