OpenJPA 2.0.0¶

The Apache OpenJPA community is proud to announce the release of Apache OpenJPA 2.0.0. This distribution is based on the final JSR 317 Java Persistence API, Version 2.0 specification and passes the JPA 2.0 TCK, while remaining backwards compatible with prior releases based on the Java Persistence API (JPA 1.0) part of Java Community Process JSR-220 (Enterprise JavaBeans 3.0). Included are many enhancements, fixes, and new functionality; giving developers access to all the new features of JPA 2.0, including:

• Access Types - expanded to allow specification on a per-persistent type basis or on individual attributes.
• Embeddables - expanded to include collections of embeddables, nested embeddables, and embeddables containing relationships to other entities.
• Enhanced Map Collections - expanded to support ElementCollection and new annotations for MapKeyColumn, MapKeyClass and MapKeyJoinColumn
• Derived Identities - enables the ID of an entity to be derived from another entity, which provides for parent-to-dependent relationships
• Query API - methods to get typed query parameters and results, supported and in-effect hints and lock mode getter/setter
• Locking - official support for Pessimistic locking (included in prior OpenJPA releases) along with LockModeType properties and hint
• JPQL Updates -
  • Embeddables support for path expressions to nested Embeddables and Embeddables with relationships
  • Enhanced Map Collection support for ElementCollection and new query expressions for KEY, ENTRY, VALUE
  • Support for CASE and TYPE expressions along with IN expressions for Collection parameters
  • Support for native date/time/timestamp literals
  • Support for INDEX expressions on an OrderColumn
• L2 Cache -
  • Provides cache operations such as entity eviction and cache mode behaviors to use, bypass or refresh items
  • Per-entity annotation to specify whether an entity should be cached
• Bean Validation - supports using a JSR 303 implementation for entity validation for persist and remove operations
• Metamodel API -
  • Provides API to dynamically retrieve metamodel information for a persistence unit
  • Used with Criteria API to generate and execute type safe queries
  • Supports dynamic or static generation of the metamodel
• Criteria API -
  • Provides programmatic construction of queries using an object based query graph
  • Operates on Metamodel objects to provide compile-time type safety enforcement
• EntityManagerFactory API - updated for new L2 Cache, Properties, Criteria and Metamodel APIs
• EntityManager API - updated for new Query and Query Result APIs, Hints, Properties, LockModeType, and Detach
• OSGi - support for the Persistence Unit Service Specification 1.0 in the OSGi Service Platform Release 4 Enterprise Version 4.2 specifications has been provided by integration with the Apache Aries JPA module
• And many more...

This distribution is based upon the contributions provided in all of the development iterations for 2.0, as defined in the OpenJPA 2.0 Roadmap .

Additional information on the OpenJPA project may be found at the project web site .

Downloads¶

Use the links below to download the artifacts or source for Apache OpenJPA 2.0.0. It is always good practice to verify the integrity of the distribution files.

For information on obtaining OpenJPA artifacts for use within Maven or ANT builds, see the Obtaining page. For information on building OpenJPA from source, see the Building page.

Other Resources¶

Documentation¶

• Release Notes
• User Guide (HTML)
• User Guide (PDF)
• Java API Docs

Quick Start¶

• OpenJPA Examples

Support¶

• Reporting bugs and general help

Maven Artifacts¶

• OpenJPA 2.0.0 JAR
• OpenJPA 2.0.0 JAR w/ depends
• Geronimo JPA 2.0 Spec API artifacts
• Geronimo Bean Validation 1.0 Spec API artifacts

SVN Source Branches¶

• OpenJPA 2.0.0
• Geronimo JPA 2.0 Spec API
• Geronimo Bean Validation 1.0 Spec API

Legal¶

Apache OpenJPA was developed by The Apache Software Foundation and is licensed under Apache License 2.0 . Copyright 2006,2010 The Apache Software Foundation.

Apache OpenJPA is bundled with the schemas from the JPA specifications, by Sun Microsystems and licensed under the CDDL 1.0. The source code is available at: https://glassfish.dev.java.net/source/browse/glassfish/

Please review the LICENSE and NOTICE files in svn, source or binary distributions for more details.