Java Data Objects (JDO) - Apache JDO 2.0 Release

JDO 2.0 RC1 Distributions

Use the links below to download Apache JDO from one of our mirrors. + @import url("../style/maven-theme.css");

General

JDO Implementation

JDO Usage

Community

Development

JDO 2.0 RC1 Distributions

Use the links below to download Apache JDO from one of our mirrors. For more information about the projects see Downloads. For information on running the TCK, see TCK.

Modified: db/jdo/site/docs/releases/release-2.0.html URL: http://svn.apache.org/viewvc/db/jdo/site/docs/releases/release-2.0.html?rev=581670&r1=581669&r2=581670&view=diff ============================================================================== --- db/jdo/site/docs/releases/release-2.0.html (original) +++ db/jdo/site/docs/releases/release-2.0.html Wed Oct 3 11:03:10 2007 @@ -1,7 +1,7 @@ Java Data Objects (JDO) - Apache JDO 2.0 Release

General

JDO Implementation

JDO Usage

Community

Development

JDO 2.0 Distributions

+ @import url("../style/maven-theme.css");

General

JDO Implementation

JDO Usage

Community

Development

JDO 2.0 Distributions

Use the links below to download Apache JDO from one of our mirrors. For more information about the projects see Downloads. For information on running the TCK, see TCK. Modified: db/jdo/site/docs/roadmap.html URL: http://svn.apache.org/viewvc/db/jdo/site/docs/roadmap.html?rev=581670&r1=581669&r2=581670&view=diff ============================================================================== --- db/jdo/site/docs/roadmap.html (original) +++ db/jdo/site/docs/roadmap.html Wed Oct 3 11:03:10 2007 @@ -1,7 +1,7 @@ Java Data Objects (JDO) - Project Roadmap

General

JDO Implementation

JDO Usage

Community

Development

Roadmap and TODO

+ @import url("./style/maven-theme.css");

General

JDO Implementation

JDO Usage

Community

Development

Roadmap and TODO

Currently in progress on the developer's list.

Submit an Idea Modified: db/jdo/site/docs/specifications.html URL: http://svn.apache.org/viewvc/db/jdo/site/docs/specifications.html?rev=581670&r1=581669&r2=581670&view=diff ============================================================================== --- db/jdo/site/docs/specifications.html (original) +++ db/jdo/site/docs/specifications.html Wed Oct 3 11:03:10 2007 @@ -1,7 +1,7 @@ Java Data Objects (JDO) - Specifications

General

JDO Implementation

Specifications
TCK

JDO Usage

Community

Development

JDO Specifications

+ @import url("./style/maven-theme.css");

General

JDO Implementation

Specifications
TCK

JDO Usage

Community

Development

JDO Specifications

The following specifications for JDO are available

The JDO 1.0 Specification (Final)

Java Data Objects (JDO) - JDO State Transitions

General

JDO Implementation

JDO Usage

Community

Development

JDO State Transition

+ @import url("./style/maven-theme.css");

General

JDO Implementation

JDO Usage

Community

Development

JDO State Transition

JDO manages the lifecycle of an object, from creation (Transient) through to persistence in the datastore (Hollow, Persistent Clean) and all of the various states between these. The transition between these states are achieved by using methods on the Persistence Manager such as makePersistent(), makeTransient(), deletePersistent(), and by commiting the changes made by these operations, or by rolling them back.

The various lifecycle states supported by JDO are shown below. Modified: db/jdo/site/docs/svn.html URL: http://svn.apache.org/viewvc/db/jdo/site/docs/svn.html?rev=581670&r1=581669&r2=581670&view=diff ============================================================================== --- db/jdo/site/docs/svn.html (original) +++ db/jdo/site/docs/svn.html Wed Oct 3 11:03:10 2007 @@ -1,7 +1,7 @@ Java Data Objects (JDO) - Source Code

General

JDO Implementation

JDO Usage

Community

Development

Source Code Version Control

Apache JDO uses Subversion to manage its source code. + @import url("./style/maven-theme.css");

General

JDO Implementation

JDO Usage

Community

Development

Source Code Version Control

Apache JDO uses Subversion to manage its source code. If you're new to Subversion, you can check out the online book about Subversion. Note that we are currently using Subversion 1.1.x (there are separate Modified: db/jdo/site/docs/tck.html URL: http://svn.apache.org/viewvc/db/jdo/site/docs/tck.html?rev=581670&r1=581669&r2=581670&view=diff ============================================================================== --- db/jdo/site/docs/tck.html (original) +++ db/jdo/site/docs/tck.html Wed Oct 3 11:03:10 2007 @@ -1,7 +1,7 @@ Java Data Objects (JDO) - TCK

General

JDO Implementation

Specifications
TCK

JDO Usage

Community

Development

About the Technology Compatibility Kit

+ @import url("./style/maven-theme.css");

General

JDO Implementation

Specifications
TCK

JDO Usage

Community

Development

About the Technology Compatibility Kit

In order to demonstrate compliance with the Java Data Objects specification, an implementation must pass all of the tests in the Technology Compatibility Kit (TCK). Modified: db/jdo/site/docs/team-list.html URL: http://svn.apache.org/viewvc/db/jdo/site/docs/team-list.html?rev=581670&r1=581669&r2=581670&view=diff ============================================================================== --- db/jdo/site/docs/team-list.html (original) +++ db/jdo/site/docs/team-list.html Wed Oct 3 11:03:10 2007 @@ -1,7 +1,7 @@ Java Data Objects (JDO) - Project Team

General

JDO Implementation

JDO Usage

Community

Development

The Apache JDO Team

+ @import url("./style/maven-theme.css");

General

JDO Implementation

JDO Usage

Community

Development

The Apache JDO Team

The people listed below have made significant contributions to JDO by working long and hard to make quality software for the rest of the world to use. Modified: db/jdo/site/docs/why_jdo.html URL: http://svn.apache.org/viewvc/db/jdo/site/docs/why_jdo.html?rev=581670&r1=581669&r2=581670&view=diff ============================================================================== --- db/jdo/site/docs/why_jdo.html (original) +++ db/jdo/site/docs/why_jdo.html Wed Oct 3 11:03:10 2007 @@ -1,7 +1,7 @@ Java Data Objects (JDO) - Why JDO ?

General

JDO Implementation

JDO Usage

Community

Development

Why JDO ?

+ @import url("./style/maven-theme.css");

General

JDO Implementation

JDO Usage

Community

Development

Why JDO ?

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.

Added: db/jdo/site/xdocs/images/javadoc.gif URL: http://svn.apache.org/viewvc/db/jdo/site/xdocs/images/javadoc.gif?rev=581670&view=auto ============================================================================== Binary file - no diff available. Propchange: db/jdo/site/xdocs/images/javadoc.gif ------------------------------------------------------------------------------ svn:mime-type = application/octet-stream Modified: db/jdo/site/xdocs/navigation.xml URL: http://svn.apache.org/viewvc/db/jdo/site/xdocs/navigation.xml?rev=581670&r1=581669&r2=581670&view=diff ============================================================================== --- db/jdo/site/xdocs/navigation.xml (original) +++ db/jdo/site/xdocs/navigation.xml Wed Oct 3 11:03:10 2007 @@ -23,6 +23,7 @@ + Added: db/jdo/site/xdocs/pmf.xml URL: http://svn.apache.org/viewvc/db/jdo/site/xdocs/pmf.xml?rev=581670&view=auto ============================================================================== --- db/jdo/site/xdocs/pmf.xml (added) +++ db/jdo/site/xdocs/pmf.xml Wed Oct 3 11:03:10 2007 @@ -0,0 +1,420 @@ + + + + Persistence Manager Factory + + + +

+ Any JDO-enabled application will require at least one PersistenceManagerFactory. + Typically applications create one per datastore being utilised. A + PersistenceManagerFactory provides access to PersistenceManagers which allow + objects to be persisted, and retrieved. The PersistenceManagerFactory can be configured + to provide particular behaviour. +

+ The simplest way of creating a PersistenceManagerFactory + + is as follows +

+ +Properties properties = new Properties(); +properties.setProperty("javax.jdo.PersistenceManagerFactoryClass", + "{my_implementation_pmf_class}"); +properties.setProperty("javax.jdo.option.ConnectionDriverName","com.mysql.jdbc.Driver"); +properties.setProperty("javax.jdo.option.ConnectionURL","jdbc:mysql://localhost/myDB"); +properties.setProperty("javax.jdo.option.ConnectionUserName","login"); +properties.setProperty("javax.jdo.option.ConnectionPassword","password"); +PersistenceManagerFactory pmf = JDOHelper.getPersistenceManagerFactory(properties); +

+ A slight variation on this, is to use a file ("jdo.properties" for example) to specify these + properties like this +

+ +javax.jdo.PersistenceManagerFactoryClass={my_implementation_pmf_class} +javax.jdo.option.ConnectionDriverName=com.mysql.jdbc.Driver +javax.jdo.option.ConnectionURL=jdbc:mysql://localhost/myDB +javax.jdo.option.ConnectionUserName=login +javax.jdo.option.ConnectionPassword=password +

+ and then to create the PersistenceManagerFactory using this file +

+ +PersistenceManagerFactory pmf = JDOHelper.getPersistenceManagerFactory("jdo.properties"); +

+ A final alternative would be to call + JDOHelper.getPersistenceManagerFactory(jndiLocation, context);, hence + accessing the properties via JNDI. +

+ Whichever way we wish to obtain the PersistenceManagerFactory we have defined a + series of properties to give the behaviour of the PersistenceManagerFactory. + The first property specifies to use PMF of the implementation required to be used, + and the following 4 properties define the datastore that it should connect to. +

+
+ + + + + + + + + + +

+ javax.jdo.PersistenceManagerFactoryClass +
Description	The name of the PersistenceManager implementation

+
+ + + + + + + + +

+ javax.jdo.option.ConnectionFactory +
Description	Instance of a connection factory. For RBDMS, it must be an instance of + javax.sql.DataSource. This is for a transactional DataSource

+
+ + + + + + + + +

+ javax.jdo.option.ConnectionFactory2 +
Description	Instance of a connection factory. For RBDMS, it must be an instance of + javax.sql.DataSource. This is for a non-transactional DataSource

+
+ + + + + + + + +

+ javax.jdo.option.ConnectionFactoryName +
Description	The JNDI name for a connection factory. For RBDMS, it must be a JNDI name + that points to a javax.sql.DataSource object. + This is for a transactional DataSource

+
+ + + + + + + + +

+ javax.jdo.option.ConnectionFactory2Name +
Description	The JNDI name for a connection factory. For RBDMS, it must be a JNDI name + that points to a javax.sql.DataSource object. + This is for a non-transactional DataSource

+
+ + + + + + + + +

+ javax.jdo.option.ConnectionDriverName +
Description	The name of the driver to use for the DB

+
+ + + + + + + + +

+ javax.jdo.option.ConnectionDriverURL +
Description	URL specifying the datastore to use for persistence

+
+ + + + + + + + +

+ javax.jdo.option.ConnectionUserName +
Description	Username to use for connecting to the DB

+
+ + + + + + + + +

+ javax.jdo.option.ConnectionPassword +
Description	Password to use for connecting to the DB

+
+ + + + + + + + + + + + +

+ javax.jdo.option.IgnoreCache +
Description	Whether to ignore the cache for queries
Range of Values	true \| false

+
+ + + + + + + + + + + + +

+ javax.jdo.option.Multithreaded +
Description	Whether to run the PersistenceManager multithreaded
Range of Values	true \| false

+
+ + + + + + + + + + + + +

+ javax.jdo.option.NontransactionalRead +
Description	Whether to allow nontransactional reads
Range of Values	true \| false

+
+ + + + + + + + + + + + +

+ javax.jdo.option.NontransactionalWrite +
Description	Whether to allow nontransactional writes
Range of Values	true \| false

+
+ + + + + + + + + + + + +

+ javax.jdo.option.Optimistic +
Description	Whether to use Optimistic transactions
Range of Values	true \| false

+
+ + + + + + + + + + + + +

+ javax.jdo.option.RetainValues +
Description	Whether to suppress the clearing of values from persistent instances on transaction + completion
Range of Values	true \| false

+
+ + + + + + + + + + + + +

+ javax.jdo.option.RestoreValues +
Description	Whether persistent object have transactional field values restored when + transaction rollback occurs.
Range of Values	true \| false

+
+ + + + + + + + +

+ javax.jdo.option.Mapping +
Description	Name for the ORM MetaData mapping files to use with this PMF. For example if this is set to + "mysql" then the implementation looks for MetaData mapping files called + "{classname}-mysql.orm" or "package-mysql.orm". If this is not specified then the JDO + implementation assumes that all is specified in the JDO MetaData file. + ORM datastores only

+
+ + + + + + + + +

+ javax.jdo.mapping.Catalog +
Description	Name of the catalog to use by default for all classes persisted using this PMF. + This can be overridden in the MetaData where required, and is optional. + JPOX will prefix all table names with this catalog name if the RDBMS supports specification + of catalog names in DDL. + ORM datastores only

+
+ + + + + + + + + + + + +

+ javax.jdo.mapping.Schema +
Description	Name of the schema to use by default for all classes persisted using this PMF. + This can be overridden in the MetaData where required, and is optional. + JPOX will prefix all table names with this schema name if the RDBMS supports specification + of schema names in DDL. + ORM datastores only
Range of Values

+
+ + + + + + + + + + + + +

javax.jdo.option.DetachAllOnCommit
Description	Allows the user to select that when a transaction is committed all objects + enlisted in that transaction will be automatically detached.
Range of Values	true \| false

+
+ + + + + + + + + + + + +

javax.jdo.option.TransactionType
Description	Type of transaction to use. If running under J2SE the default is RESOURCE_LOCAL, and + if running under J2EE the default is JTA.
Range of Values	RESOURCE_LOCAL \| JTA

+
+ + + + + + + + +

javax.jdo.option.PersistenceUnitName
Description	Name of the "persistence-unit" to use with this PMF. This borrows the + "persistence-unit" concept from JPA for use with JDO 2.1.

+
+ + + + + + + + +

javax.jdo.option.ServerTimeZoneID
Description	Id of the TimeZone under which the datastore server is running. + If this is not specified or is set to null it is assumed that the datastore server + is running in the same timezone as the JVM under which the implementation is running.

+
+ + + + + + + + +

javax.jdo.option.Name
Description	Name of the PMF. This is for use with "named PMF" functionality in JDO 2.1

+
+ + + + + + + + + + + + +

javax.jdo.option.CopyOnAttach
Description	Whether, when attaching a detached object, we create an attached copy or simply + migrate the detached object to attached state
Range of Values	true \| false

+
+ +

+ + \ No newline at end of file