Added: db/jdo/site/docs/images/nw_min.gif URL: http://svn.apache.org/viewvc/db/jdo/site/docs/images/nw_min.gif?rev=581219&view=auto ============================================================================== Binary file - no diff available. Propchange: db/jdo/site/docs/images/nw_min.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: db/jdo/site/docs/images/nw_min_036.gif URL: http://svn.apache.org/viewvc/db/jdo/site/docs/images/nw_min_036.gif?rev=581219&view=auto ============================================================================== Binary file - no diff available. Propchange: db/jdo/site/docs/images/nw_min_036.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: db/jdo/site/docs/images/nw_min_hi.gif URL: http://svn.apache.org/viewvc/db/jdo/site/docs/images/nw_min_hi.gif?rev=581219&view=auto ============================================================================== Binary file - no diff available. Propchange: db/jdo/site/docs/images/nw_min_hi.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: db/jdo/site/docs/images/pdf.gif URL: http://svn.apache.org/viewvc/db/jdo/site/docs/images/pdf.gif?rev=581219&view=auto ============================================================================== Binary file - no diff available. Propchange: db/jdo/site/docs/images/pdf.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: db/jdo/site/docs/images/poweredby_036.gif URL: http://svn.apache.org/viewvc/db/jdo/site/docs/images/poweredby_036.gif?rev=581219&view=auto ============================================================================== Binary file - no diff available. Propchange: db/jdo/site/docs/images/poweredby_036.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: db/jdo/site/docs/images/product_logo.gif URL: http://svn.apache.org/viewvc/db/jdo/site/docs/images/product_logo.gif?rev=581219&view=auto ============================================================================== Binary file - no diff available. Propchange: db/jdo/site/docs/images/product_logo.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: db/jdo/site/docs/images/remove.gif URL: http://svn.apache.org/viewvc/db/jdo/site/docs/images/remove.gif?rev=581219&view=auto ============================================================================== Binary file - no diff available. Propchange: db/jdo/site/docs/images/remove.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: db/jdo/site/docs/images/se_maj_rond.gif URL: http://svn.apache.org/viewvc/db/jdo/site/docs/images/se_maj_rond.gif?rev=581219&view=auto ============================================================================== Binary file - no diff available. Propchange: db/jdo/site/docs/images/se_maj_rond.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: db/jdo/site/docs/images/strich.gif URL: http://svn.apache.org/viewvc/db/jdo/site/docs/images/strich.gif?rev=581219&view=auto ============================================================================== Binary file - no diff available. Propchange: db/jdo/site/docs/images/strich.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: db/jdo/site/docs/images/sw_maj_rond.gif URL: http://svn.apache.org/viewvc/db/jdo/site/docs/images/sw_maj_rond.gif?rev=581219&view=auto ============================================================================== Binary file - no diff available. Propchange: db/jdo/site/docs/images/sw_maj_rond.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: db/jdo/site/docs/images/sw_med_rond.gif URL: http://svn.apache.org/viewvc/db/jdo/site/docs/images/sw_med_rond.gif?rev=581219&view=auto ============================================================================== Binary file - no diff available. Propchange: db/jdo/site/docs/images/sw_med_rond.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: db/jdo/site/docs/images/sw_min.gif URL: http://svn.apache.org/viewvc/db/jdo/site/docs/images/sw_min.gif?rev=581219&view=auto ============================================================================== Binary file - no diff available. Propchange: db/jdo/site/docs/images/sw_min.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: db/jdo/site/docs/images/update.gif URL: http://svn.apache.org/viewvc/db/jdo/site/docs/images/update.gif?rev=581219&view=auto ============================================================================== Binary file - no diff available. Propchange: db/jdo/site/docs/images/update.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Added: db/jdo/site/docs/issue-tracking.html URL: http://svn.apache.org/viewvc/db/jdo/site/docs/issue-tracking.html?rev=581219&view=auto ============================================================================== --- db/jdo/site/docs/issue-tracking.html (added) +++ db/jdo/site/docs/issue-tracking.html Tue Oct 2 06:01:19 2007 @@ -0,0 +1,8 @@ +Java Data Objects (JDO) - Issue Tracking

\ No newline at end of file Added: db/jdo/site/docs/jdo_dtd.html URL: http://svn.apache.org/viewvc/db/jdo/site/docs/jdo_dtd.html?rev=581219&view=auto ============================================================================== --- db/jdo/site/docs/jdo_dtd.html (added) +++ db/jdo/site/docs/jdo_dtd.html Tue Oct 2 06:01:19 2007 @@ -0,0 +1,36 @@ +Java Data Objects (JDO) - JDO DTD

Meta-Data - JDO

+ JDO2 defines XML MetaData in jdo files as well as orm files. + As always with XML, the metadata must match the defined DTD/XSD for that file type. + This section describes the content of the jdo files. + The content of orm files can be found here. + All jdo files must contain a valid DTD/DOCTYPE specification. You can use PUBLIC or SYSTEM versions of these. +

+ Here are a few examples valid for jdo files with DTD specifications +

+
+<!DOCTYPE jdo PUBLIC
+    "-//Sun Microsystems, Inc.//DTD Java Data Objects Metadata 2.0//EN"
+    "http://java.sun.com/dtd/jdo_2_0.dtd">
+
+
+<!DOCTYPE jdo SYSTEM "file:/javax/jdo/jdo.dtd">
+

+ Here is an example valid for jdo files with XSD specification +

+
+<?xml version="1.0" encoding="UTF-8" ?>
+<jdo xmlns="http://java.sun.com/xml/ns/jdo/jdo"
+     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+     xsi:schemaLocation="http://java.sun.com/xml/ns/jdo/jdo
+        http://java.sun.com/xml/ns/jdo/jdo_2_0.xsd">
+    ...
+</jdo>
+

+ Your MetaData should match either the DTD + or the XSD specification. +


\ No newline at end of file Added: db/jdo/site/docs/jdo_v_jpa.html URL: http://svn.apache.org/viewvc/db/jdo/site/docs/jdo_v_jpa.html?rev=581219&view=auto ============================================================================== --- db/jdo/site/docs/jdo_v_jpa.html (added) +++ db/jdo/site/docs/jdo_v_jpa.html Tue Oct 2 06:01:19 2007 @@ -0,0 +1,35 @@ +Java Data Objects (JDO) - JDO .v. JPA

Which Persistence Specification ?

+ There are several competing persistence technologies available for Java. Two of these are "standardised" + (via the JCP). When developing your application you need to choose the most appropriate technology for your + needs. Java Data Objects (JDO) has been a standard since 2001 with the release of JDO1. It was + improved with the release of JDO2. Just to confuse issues the Java Persistence API (JPA) was + recently approved in its JPA1 form, and JDO2.1 will offer an update to JDO2 building on some of + the new features of JPA1. Below we show some of the differences of these 3 standards to give you + assistance in selecting what you need. Highlighted in bold are the notable differences where one + specification provides something not available in the other. +

FeatureJDO2JPA1
JDK Requirement1.3+1.5+
UsageJ2EE, J2SEJ2EE, J2SE
Persistence specification mechanismMetaData, Annotations [1]MetaData, Annotations
Datastore supportedAnyRDBMS only
Restrictions on persisted classesno-arg constructor (could be added by compiler/enhancer)No final classes. No final methods. Non-private no-arg constructor. Identity Field
TransactionsPessimistic, OptimisticOptimistic
Object Identitydatastore-identity, application-identityapplication-identity
Object Identity g enerationSequence, Table, Identity, Auto, UUID String, UUID HexSequence, Table, Identity, Auto
Change objects identityThrow exception when not allowedUndefined, so expect anything !!
Supported typesJava primitive types, wrappers of primitive types, java.lang.String, java.lang.Number, java.math.BigInteger, java.math.BigDecimal, + java.util.Currency, java.util.Locale, java.util.Date, java.sql.Time, java.sql.Date, java.sql.Timestamp, java.io.Serializable, + boolean[], byte[], char[], double[], float[], int[], long[], short[], + java.lang.Object, interface, + Boolean[], Byte[], Character[], Double[], Float[], Integer[], Long[], Short[], BigDecimal[], BigInteger[], String[], + PersistenceCapable[], interface[], Object[], Enums [1], + java.util.Collection, java.util.Set, java.util.List, java.util.Map, + Collection/List/Map of simple types, Collection/List/Map of reference (interface/Object) types, + Collection/List/Map of persistable types + Java primitive types, wrappers of the primitive types, java.lang.String, java.math.BigInteger, java.math.BigDecimal, + java.util.Date, java.util.Calendar, java.sql.Date, java.sql.Time, java.sql.Timestamp, java.io.Serializable, + byte[], Byte[], char[], Character[], Enums, + java.util.Collection, java.util.Set, java.util.List, java.util.Map + Collection/List/Map of persistable types
Embedded FieldsEmbedded persistent objects, Embedded Collections, Embedded MapsEmbedded persistent objects
Access a non-detached fieldThrow exceptionUndefined, so expect anything !!
InheritanceEach class has its own strategyRoot class defines the strategy
Query LanguageJDOQL, SQLJPQL, SQL
Query candidatesCandidate without subclasses, Candidate and its subclassesCandidate and its subclasses
Object retrieval controlLazy loading, eager fetching, fetch groupsLazy loading, eager fetching
Bulk update/deleteJDOQL Bulk DeleteJPQL Bulk Delete, Bulk Update
RDBMS Schema ControlTables, columns, PK columns, PK constraints, FK columns, FK constraints, index columns, + index constraints, unique key columns, unique key constraintsTables, columns, PK columns, FK columns, unique key columns
ORM RelationshipsFull range of Collection, Map, List, Array, 1-1, 1-N, M-N using + PC, Non-PC and interface objectsBasic 1-1, 1-N, M-N only
Caching interfaceL2 Caching APINothing
    +
  • [1] - included in JDO 2.1
  • +

+ As an overall conclusion "JPA1" is a subset of what is already available in "JDO2". + "JDO2.1" adds on some of the few new features found in "JPA1". +


\ No newline at end of file Added: db/jdo/site/docs/jdo_v_jpa_orm.html URL: http://svn.apache.org/viewvc/db/jdo/site/docs/jdo_v_jpa_orm.html?rev=581219&view=auto ============================================================================== --- db/jdo/site/docs/jdo_v_jpa_orm.html (added) +++ db/jdo/site/docs/jdo_v_jpa_orm.html Tue Oct 2 06:01:19 2007 @@ -0,0 +1,11 @@ +Java Data Objects (JDO) - JDO .v. JPA : Object/Relational Mapping

Which ORM specification ?

+ There are 2 prevalent specification in the Java ORM world. JDO2 provides the most complete + definition, whilst JPA is the most recent. In this guide we show the different types of ORM relation + commonly used, and mark against it which specification supports it. This list is not yet complete but + will be added to to provide a comprehensive list of relationship type and where you can find it. +

Field TypeRelationJDO2JPA1
PC1-1 Unidirectional
PC1-1 Bidirectional
PC1-1 serialised
PC1-1 CompoundIdentity Unidirectional
Interface1-1 Unidirectional
Interface1-1 Bidirectional
Interface1-1 serialised?
Collection<PC>1-N ForeignKey Unidirectional Collection
Collection<PC>1-N ForeignKey Bidirectional Collection
Collection<PC>1-N JoinTable Unidirectional Collection
Collection<PC>1-N JoinTable Bidirectional Collection
Collection<Non-PC>1-N JoinTable Collection
Collection<PC>1-N JoinTable Collection using shared JoinTable
Collection<PC>1-N ForeignKey Collection using shared ForeignKey
Collection<PC> ;M-N JoinTable
Collection<PC>1-N CompoundIdentity Unidirectional
Collection<PC>1-N serialised Collection
Collection<PC>1-N JoinTable Collection of serialised elements
List<PC>1-N ForeignKey Unidirectional Indexed List
List<PC>1-N ForeignKey Bidirectional Indexed List
List<PC>1-N JoinTable Unidirectional Indexed List
List<PC>1-N JoinTable Bidirectional Indexed List
List<Non-PC>1-N JoinTable Indexed List
List<PC>1-N ForeignKey Unidirectional Ordered List
List<PC>1-N ForeignKey Bidirectional Ordered List
List<PC>1-N JoinTable Unidirectional Ordered List
List<PC>1-N JoinTable Bidirectional Ordered List
Map<PC, PC>1-N JoinTable Map
Map<N on-PC, PC>1-N JoinTable Map
Map<PC, Non-PC>1-N JoinTable Map
Map<Non-PC, Non-PC>1-N JoinTable Map
Map<Non-PC, PC>1-N ForeignKey Map Unidirectional (key stored in value)
Map<Non-PC, PC>1-N ForeignKey Map Bidirectional (key stored in value)
Map<PC, Non-PC>1-N ForeignKey Map Unidirectional (value stored in key)
Map<PC, PC>1-N serialised Map
Map<PC, PC>1-N JoinTable Map of serialised keys/values
PC[ ]1-N ForeignKey Unidirectional Array
PC[ ]1-N JoinTable Unidirectional Array
PC[ ]1-N serialised Array
Non-PC[ ]1-N JoinTable Unidirectional Array

\ No newline at end of file Added: db/jdo/site/docs/jdohelper.html URL: http://svn.apache.org/viewvc/db/jdo/site/docs/jdohelper.html?rev=581219&view=auto ============================================================================== --- db/jdo/site/docs/jdohelper.html (added) +++ db/jdo/site/docs/jdohelper.html Tue Oct 2 06:01:19 2007 @@ -0,0 +1,65 @@ +Java Data Objects (JDO) - JDO Helper

JDO Helper

+ JDO provides a standard utility that gives access to useful parts of the JDO persistence process. + This is known as JDOHelper (javax.jdo.JDOHelper) + +

+ The methods in JDOHelper can be split into categories. Here we start with the methods for creating + the starting point for persistence, the PersistenceManagerFactory (PMF) +

    +
  • getPersistenceManagerFactory(Map props) - + creates a PMF given a Map of the properties
  • +
  • getPersistenceManagerFactory(Map props, ClassLoader cl) - + creates a PMF given a Map of the properties, and a ClassLoader to use
  • +
  • getPersistenceManagerFactory(String resource) - + creates a PMF given a resource defining the properties. + This can be used to create a named PMF in JDO2.1
  • +
  • getPersistenceManagerFactory(String props, ClassLoader cl) - + creates a PMF given a resource defining the properties, and a ClassLoader to use
  • +
  • getPersistenceManagerFactory(File props) - + creates a PMF given a file containing the properties
  • +
  • getPersistenceManagerFactory(File props, ClassLoader cl) - + creates a PMF given a file containing the properties and a ClassLoader to use
  • +
  • getPersistenceManagerFactory(String jndi, Context ctx) - + creates a PMF given a JNDI resource
  • +
  • getPersistenceManagerFactory(String jndi, Context ctx, ClassLoader cl) - + creates a PMF given a JNDI resource and a ClassLoader to use
  • +
  • getPersistenceManagerFactory(InputStream strm) - + creates a PMF given an InputStream
  • +
  • getPersistenceManagerFactory(InputStream strm, ClassLoader cl) - + creates a PMF given an InputStream and a ClassLoader to use
  • +

+ Now we move onto the operations for persistence. +

    +
  • getPersistenceManager(Object pc) - + returns the PersistenceManager associated with the passed object (if any)
  • +
  • makeDirty(Object pc, String fieldName) - + marks the field of the passed object as dirty (meaning that it needs updating in ther datastore)
  • +
  • getObjectId(Object pc) - + returns the object identity for the passed object (if persistent)
  • +
  • getObjectIds(Collection pc) - + returns the object identities for the passed objects (if persistent)
  • +
  • getObjectIds(Object[] pc) - + returns the object identities for the passed objects (if persistent)
  • +
  • getVersion(Object pc) - + returns the version for the passed object (if persistent)
  • +

+ Now we move onto lifecycle operations +

    +
  • isDirty(Object pc) - + returns whether the passed object is dirty
  • +
  • isTransactional(Object pc) - + returns whether the passed object is transactional
  • +
  • isPersistent(Object pc) - + returns whether the passed object is persistent
  • +
  • isNew(Object pc) - + returns whether the passed object is new
  • +
  • isDeleted(Object pc) - + returns whether the passed object is deleted
  • +
  • isDetached(Object pc) - + returns whether the passed object is detached
  • +

\ No newline at end of file Added: db/jdo/site/docs/jdoquery_dtd.html URL: http://svn.apache.org/viewvc/db/jdo/site/docs/jdoquery_dtd.html?rev=581219&view=auto ============================================================================== --- db/jdo/site/docs/jdoquery_dtd.html (added) +++ db/jdo/site/docs/jdoquery_dtd.html Tue Oct 2 06:01:19 2007 @@ -0,0 +1,36 @@ +Java Data Objects (JDO) - JDOQuery DTD

Meta-Data - JDOQuery

+ JDO2 defines XML MetaData in jdo files as well as orm files, but also specifies that named queries can be defined in jdoquery files. + As always with XML, the metadata must match the defined DTD/XSD for that file type. + This section describes the content of the jdoquery files. + All jdoquery files must contain a valid DTD/DOCTYPE specification. + You can use PUBLIC or SYSTEM versions of these. +

+ Here are a few examples valid for jdoquery files eith DTD specification +

+
+<!DOCTYPE jdoquery PUBLIC
+    "-//Sun Microsystems, Inc.//DTD Java Data Objects Query Metadata 2.0//EN"
+    "http://java.sun.com/dtd/jdoquery_2_0.dtd">
+
+
+<!DOCTYPE jdoquery SYSTEM "file:/javax/jdo/jdoquery.dtd">
+

+ Here is an example valid for jdoquery files with XSD specification +

+
+<?xml version="1.0" encoding="UTF-8" ?>
+<jdo xmlns="http://java.sun.com/xml/ns/jdo/jdo"
+     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+     xsi:schemaLocation="http://java.sun.com/xml/ns/jdo/jdoquery
+        http://java.sun.com/xml/ns/jdo/jdoquery_2_0.xsd">
+    ...
+</jdo>
+

+ Your MetaData should match either the DTD + or the XSD specification. +


\ No newline at end of file Added: db/jdo/site/docs/maven-reports.html URL: http://svn.apache.org/viewvc/db/jdo/site/docs/maven-reports.html?rev=581219&view=auto ============================================================================== --- db/jdo/site/docs/maven-reports.html (added) +++ db/jdo/site/docs/maven-reports.html Tue Oct 2 06:01:19 2007 @@ -0,0 +1,11 @@ +Java Data Objects (JDO) - Project Reports

Maven Generated Reports

+ This document provides an overview of the various reports that + are automatically generated by + Maven. + Each report is briefly described below. +

Overview

DocumentDescription

\ No newline at end of file Added: db/jdo/site/docs/orm_dtd.html URL: http://svn.apache.org/viewvc/db/jdo/site/docs/orm_dtd.html?rev=581219&view=auto ============================================================================== --- db/jdo/site/docs/orm_dtd.html (added) +++ db/jdo/site/docs/orm_dtd.html Tue Oct 2 06:01:19 2007 @@ -0,0 +1,36 @@ +Java Data Objects (JDO) - ORM DTD

Meta-Data - ORM

+ JDO2 defines XML MetaData in jdo files as well as orm files. + As always with XML, the metadata must match the defined DTD/XSD for that file type. + This section describes the content of the orm files. + The content of jdo files can be found here. + All orm files must contain a valid DTD/DOCTYPE specification. You can use PUBLIC or SYSTEM versions of these. +

+ Here are a couple of examples valid for orm files with DTD specification +

+
+<!DOCTYPE orm PUBLIC
+    "-//Sun Microsystems, Inc.//DTD Java Data Objects Mapping Metadata 2.0//EN"
+    "http://java.sun.com/dtd/orm_2_0.dtd">
+
+
+<!DOCTYPE orm SYSTEM "file:/javax/jdo/orm.dtd">
+

+ Here is an example valid for orm files with XSD specification +

+
+<?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_2_0.xsd">
+    ...
+</orm>
+

+ Your MetaData should match either the DTD + or the XSD specification. +


\ No newline at end of file Added: db/jdo/site/docs/project-info.html URL: http://svn.apache.org/viewvc/db/jdo/site/docs/project-info.html?rev=581219&view=auto ============================================================================== --- db/jdo/site/docs/project-info.html (added) +++ db/jdo/site/docs/project-info.html Tue Oct 2 06:01:19 2007 @@ -0,0 +1,26 @@ +Java Data Objects (JDO) - Project Information

General Project Information

+ This document provides an overview of the various documents and + links that are part of this project's general information. All + of this content is automatically generated by + Maven on + behalf of the project. +

Overview

DocumentDescription
Mailing Lists + This document provides subscription and archive + information for this project's mailing lists. +
Project Team + This document provides information on the members of + this project. These are the individuals who have + contributed to the project in one form or another. +
Dependencies + This document lists the projects dependencies and provides + information on each dependency. +
Issue Tracking + This is a link to the issue tracking system for this + project. Issues (bugs, features, change requests) can be + created and queried using this link. +

\ No newline at end of file