Added:
websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/manual.pdf
==============================================================================
Binary file - no diff available.
Propchange:
websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/manual.pdf
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added:
websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/migration_considerations.html
==============================================================================
---
websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/migration_considerations.html
(added)
+++
websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/migration_considerations.html
Fri Jan 6 19:19:20 2017
@@ -0,0 +1,425 @@
+<html><head>
+ <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+ <title>Appendix 3. Migration Considerations</title><base
href="display"><link rel="stylesheet" type="text/css"
href="css/docbook.css"><meta name="generator" content="DocBook XSL Stylesheets
V1.79.1"><link rel="home" href="manual.html" title="Apache OpenJPA 2.4 User's
Guide"><link rel="up" href="appendices.html"
title="Part 4. Appendices"><link rel="prev"
href="dbsupport_sybase.html" title="24. Sybase Adaptive Server"><link
rel="next" href="jpa_2.2.html" title="2. OpenJPA 2.2.0"></head><body
bgcolor="white" text="black" link="#0000FF" vlink="#840084"
alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation
header"><tr><th colspan="3" align="center">Appendix 3.
+ Migration Considerations
+ </th></tr><tr><td width="20%" align="left"><a accesskey="p"
href="dbsupport_sybase.html">Prev</a> </td><th width="60%"
align="center">Part 4. Appendices</th><td width="20%"
align="right"> <a accesskey="n"
href="jpa_2.2.html">Next</a></td></tr></table><hr></div><div class="appendix"
id="migration_considerations"><div class="titlepage"><div><div><h2
class="title">Appendix 3.
+ Migration Considerations
+ </h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl
class="toc"><dt><span class="section"><a
href="migration_considerations.html#jpa_2.0">1.
+ OpenJPA 2.0.0
+ </a></span></dt><dd><dl><dt><span class="section"><a
href="migration_considerations.html#jpa_2.0_incompatibilities">1.1.
+ Incompatibilities
+ </a></span></dt><dd><dl><dt><span class="section"><a
href="migration_considerations.html#getProperties">1.1.1.
+ getProperties()
+ </a></span></dt><dt><span class="section"><a
href="migration_considerations.html#migration_detach_behavior">1.1.2.
+ Detach Behavior
+ </a></span></dt><dt><span class="section"><a
href="migration_considerations.html#private_persistent_properties">1.1.3.
+ Use of private persistent properties
+ </a></span></dt><dt><span class="section"><a
href="migration_considerations.html#setParameter">1.1.4.
+ Query.setParameter()
+ </a></span></dt><dt><span class="section"><a
href="migration_considerations.html#serialization">1.1.5.
+ Serialization of Entities
+ </a></span></dt><dt><span class="section"><a
href="migration_considerations.html#QuerySQLCache">1.1.6.
+ openjpa.jdbc.QuerySQLCache
+ </a></span></dt></dl></dd><dt><span class="section"><a
href="migration_considerations.html#Disabling AutoOff Collection Tracking">1.2.
+ Disabling AutoOff Collection Tracking
+ </a></span></dt><dt><span class="section"><a
href="migration_considerations.html#internal_differences">1.3.
+ Internal Behavioral Differences
+ </a></span></dt><dd><dl><dt><span class="section"><a
href="migration_considerations.html#prePostUpdate">1.3.1.
+ PreUpdate/PostUpdate Life Cycle Callbacks
+ </a></span></dt><dt><span class="section"><a
href="migration_considerations.html#createemf">1.3.2.
+ createEntityManagerFactory Exceptions
+ </a></span></dt><dt><span class="section"><a
href="migration_considerations.html#querycache">1.3.3.
+ openjpa.QueryCache default
+ </a></span></dt></dl></dd></dl></dd><dt><span
class="section"><a href="jpa_2.2.html">2.
+ OpenJPA 2.2.0
+ </a></span></dt><dd><dl><dt><span class="section"><a
href="jpa_2.2.html#jpa_2.2_incompatibilities">2.1.
Incompatibilities</a></span></dt><dd><dl><dt><span class="section"><a
href="jpa_2.2.html#jpa_2.2_allocationSize">2.1.1.
+ allocationSize Property of Sequence Generator
+ </a></span></dt><dt><span class="section"><a
href="jpa_2.2.html#jpa_2.2_metamodelArrays">2.1.2.
+ MetaModel Attributes for Arrays
+ </a></span></dt><dt><span class="section"><a
href="jpa_2.2.html#jpa_2.2_SupportsSetClob">2.1.3.
+ supportsSetClob Property.
+ </a></span></dt><dt><span class="section"><a
href="jpa_2.2.html#jpa_2.2_UseNativeSequenceCache">2.1.4.
+ useNativeSequenceCache Property.
+ </a></span></dt><dt><span class="section"><a
href="jpa_2.2.html#jpa_2.2_cascadePersist">2.1.5.
+ Cascade persist behavior
+ </a></span></dt><dt><span class="section"><a
href="jpa_2.2.html#jpa_2.2_LifecycleEventManager">2.1.6.
+ Life Cycle Event Manager Callback Behavior
+ </a></span></dt><dt><span class="section"><a
href="jpa_2.2.html#jpa_2.2_sharedCacheMode">2.1.7.
+ shared-cache-mode Property
+ </a></span></dt></dl></dd></dl></dd><dt><span
class="section"><a href="jpa_2.3.html">3.
+ OpenJPA 2.3.0
+ </a></span></dt><dd><dl><dt><span class="section"><a
href="jpa_2.3.html#jpa_2.3_incompatibilities">3.1.
Incompatibilities</a></span></dt><dd><dl><dt><span class="section"><a
href="jpa_2.3.html#jpa_2.3_MappingTool">3.1.1.
+ MappingTool Behavior for DB2 and Derby
+ </a></span></dt><dt><span class="section"><a
href="jpa_2.3.html#jpa_2.3_RequiresSearchStringEscapeForLike">3.1.2.
+ RequiresSearchStringEscapeForLike DBDictionary Property
+ </a></span></dt><dt><span class="section"><a
href="jpa_2.3.html#ReturnNullOnEmptyAggregateResult">3.1.3.
+ Return value of aggregate functions in SELECT clause
+ </a></span></dt></dl></dd></dl></dd></dl></div>
+
+ <div class="section" id="jpa_2.0"><div class="titlepage"><div><div><h2
class="title" style="clear: both">1.
+ OpenJPA 2.0.0
+ </h2></div></div></div><div class="toc"><dl class="toc"><dt><span
class="section"><a
href="migration_considerations.html#jpa_2.0_incompatibilities">1.1.
+ Incompatibilities
+ </a></span></dt><dd><dl><dt><span class="section"><a
href="migration_considerations.html#getProperties">1.1.1.
+ getProperties()
+ </a></span></dt><dt><span class="section"><a
href="migration_considerations.html#migration_detach_behavior">1.1.2.
+ Detach Behavior
+ </a></span></dt><dt><span class="section"><a
href="migration_considerations.html#private_persistent_properties">1.1.3.
+ Use of private persistent properties
+ </a></span></dt><dt><span class="section"><a
href="migration_considerations.html#setParameter">1.1.4.
+ Query.setParameter()
+ </a></span></dt><dt><span class="section"><a
href="migration_considerations.html#serialization">1.1.5.
+ Serialization of Entities
+ </a></span></dt><dt><span class="section"><a
href="migration_considerations.html#QuerySQLCache">1.1.6.
+ openjpa.jdbc.QuerySQLCache
+ </a></span></dt></dl></dd><dt><span class="section"><a
href="migration_considerations.html#Disabling AutoOff Collection Tracking">1.2.
+ Disabling AutoOff Collection Tracking
+ </a></span></dt><dt><span class="section"><a
href="migration_considerations.html#internal_differences">1.3.
+ Internal Behavioral Differences
+ </a></span></dt><dd><dl><dt><span class="section"><a
href="migration_considerations.html#prePostUpdate">1.3.1.
+ PreUpdate/PostUpdate Life Cycle Callbacks
+ </a></span></dt><dt><span class="section"><a
href="migration_considerations.html#createemf">1.3.2.
+ createEntityManagerFactory Exceptions
+ </a></span></dt><dt><span class="section"><a
href="migration_considerations.html#querycache">1.3.3.
+ openjpa.QueryCache default
+ </a></span></dt></dl></dd></dl></div>
+
+ <div class="section" id="jpa_2.0_incompatibilities"><div
class="titlepage"><div><div><h3 class="title">1.1.
+ Incompatibilities
+ </h3></div></div></div><div class="toc"><dl class="toc"><dt><span
class="section"><a href="migration_considerations.html#getProperties">1.1.1.
+ getProperties()
+ </a></span></dt><dt><span class="section"><a
href="migration_considerations.html#migration_detach_behavior">1.1.2.
+ Detach Behavior
+ </a></span></dt><dt><span class="section"><a
href="migration_considerations.html#private_persistent_properties">1.1.3.
+ Use of private persistent properties
+ </a></span></dt><dt><span class="section"><a
href="migration_considerations.html#setParameter">1.1.4.
+ Query.setParameter()
+ </a></span></dt><dt><span class="section"><a
href="migration_considerations.html#serialization">1.1.5.
+ Serialization of Entities
+ </a></span></dt><dt><span class="section"><a
href="migration_considerations.html#QuerySQLCache">1.1.6.
+ openjpa.jdbc.QuerySQLCache
+ </a></span></dt></dl></div>
+
+
+ <p>
+ The following sections indicate changes that are incompatible
+ between OpenJPA 1.x.x releases and the 2.0 release. Some may
+ require application changes. Others can be remedied through the
+ use of compatibility options. If your application uses a
+ version 1.0 persistence.xml, compatibility options will be set
+ appropriately to maintain backward compatibility. OpenJPA 2.0
+ applications using a version 2.0 persistence.xml and requiring
+ OpenJPA 1.x.x compatibility may need to configure the
+ appropriate compatibility options to get the desired behavior.
+ </p>
+ <div class="section" id="getProperties"><div
class="titlepage"><div><div><h4 class="title">1.1.1.
+ getProperties()
+ </h4></div></div></div>
+
+
+ <p>
+ The OpenJPAEntityManagerFactory interface getProperties()
+ method was changed to return a Map instead of a
+ Properties object. This change was made in order to
+ support the getProperties() method defined in the
+ JPA 2.0 specification.
+ </p>
+ </div>
+ <div class="section" id="migration_detach_behavior"><div
class="titlepage"><div><div><h4 class="title">1.1.2.
+ Detach Behavior
+ </h4></div></div></div>
+
+
+ <p>
+ The detach behavior has changed in several ways:
+ </p><div class="itemizedlist"><ul class="itemizedlist"
style="list-style-type: disc; "><li class="listitem">
+ <p>
+ In the 1.x.x release, managed entities
+ were flushed to the database as part of the
+ detach operation. This is no longer done in
+ 2.0.
+ </p>
+ </li><li class="listitem">
+ <p>
+ In the 1.x.x release, entities were copied
+ and returned. In 2.0, for those methods
+ that have return values, the original
+ entities are returned.
+ </p>
+ </li><li class="listitem">
+ <p>
+ In the 1.x.x release, managed entities still
+ exist in the persistent context. In 2.0,
+ they are removed.
+ </p>
+ </li><li class="listitem">
+ <p>
+ In the 1.x.x release, the detach operation
+ is recursively cascaded to all referenced
+ entities. In 2.0, the detach operation is
+ only cascaded to those entities for which
+ Cascade=detach has been specified.
+ </p>
+ </li></ul></div><p>
+ </p>
+ <p>
+ Applications that use a 1.0 persistence.xml will
+ automatically maintain OpenJPA 1.x.x behavior. It is
+ possible for a version 2.0 application to revert back to
+ the 1.x.x behavior for some of these items by setting the
+ openjpa.Compatibility property as follows:
+ </p><table border="0" summary="Simple list"
class="simplelist"><tr><td>CopyOnDetach=true</td></tr><tr><td>FlushBeforeDetach=true</td></tr><tr><td>CascadeWithDetach=true</td></tr></table><p>
+ </p>
+ <p>
+ In addition, a new method has been provided on the
+ <a class="ulink"
href="../javadoc/org/apache/openjpa/persistence/OpenJPAEntityManager.html"
target="_top">
+ <code class="classname">OpenJPAEntityManager</code></a>
+ interface to return a copy of the entity:
+ </p><pre class="programlisting">
+ public <T> T detachCopy(T pc):
+ </pre><p>
+ </p>
+ </div>
+ <div class="section" id="private_persistent_properties"><div
class="titlepage"><div><div><h4 class="title">1.1.3.
+ Use of private persistent properties
+ </h4></div></div></div>
+
+
+ <p>
+ In 1.x.x releases of OpenJPA, if property access was used,
+ private properties were considered persistent. This is
+ contrary to the JPA specification, which states that
+ persistent properties must be public or protected. In
+ OpenJPA 2.0 and later, private properties will not be
+ persistent by default.
+ </p>
+ <p>
+ Applications that use a 1.0 persistence.xml will
+ automatically maintain OpenJPA 1.x.x behavior. It is
+ possible for a version 2.0 application to revert back to
+ the 1.x.x behavior by setting the value of the
+ <code class="literal">openjpa.Compatibility</code>
+ property <code
class="literal">PrivatePersistentProperties</code> to
+ <code class="literal">true</code>. If compile time
enhancement is
+ used, this property must be specified at the time of
+ enhancement and at runtime.
+ </p>
+ </div>
+ <div class="section" id="setParameter"><div
class="titlepage"><div><div><h4 class="title">1.1.4.
+ Query.setParameter()
+ </h4></div></div></div>
+
+
+ <p>
+ The Query interface setParameter() method behavior has
+ changed to throw an IllegalArgumentException (as required
+ by the JPA specification) if more parameter substitutions
+ are supplied than defined in the createQuery(),
+ createNamedQuery(), or createNativeQuery() invocation.
+ OpenJPA 1.2.x and prior versions silently ignored these
+ extraneous parameter substitutions and allowed the Query
+ to be processed.
+ </p>
+ </div>
+ <div class="section" id="serialization"><div
class="titlepage"><div><div><h4 class="title">1.1.5.
+ Serialization of Entities
+ </h4></div></div></div>
+
+
+ <p>
+ In 1.x.x releases of OpenJPA, when an entity was serialized
+ after calling EntityManager.find(), detach() or detachAll()
+ then all <a class="xref"
href="ref_guide_pc_scos.html#ref_guide_pc_scos_proxy" title="6.4.
Proxies">Section 6.4, “
+ Proxies
+ ”</a>
+ references were removed as expected, but when the same
+ entity instance was serialized after calling
+ EntityManager.clear() the proxy classes were not removed.
+ </p>
+ <p>
+ This has two side-effects:
+ when entities are remoted across JVM boundaries (RPC)
+ or deserialized the OpenJPA runtime must be available
+ on the classpath (both client and server containers);
+ when entities are deserialized the OpenJPA runtime must
+ be the exact same revision as used to serialize the
+ entities due to the proxy classes using dynamically
+ generated serialVersionUID values.
+ </p>
+ <p>
+ Starting with OpenJPA 2.0, this behavior has been
+ modified, so that by default all proxies will be removed
+ during serialization. See
+ <a class="xref"
href="ref_guide_pc_scos.html#ref_guide_pc_scos_proxy_serial"
title="6.4.4. Serialization">Section 6.4.4, “
+ Serialization
+ ”</a>
+ on how the behavior changes based on the
+ <code class="literal">DetachedStateField</code> setting
along with
+ <a class="xref"
href="ref_guide_remote.html#ref_guide_detach_state" title="1.3.1.
Detached State">Section 1.3.1, “
+ Detached State
+ ”</a>
+ for more details on how to override the default
+ <code class="literal">DetachedStateField</code> setting.
+ </p>
+ <p>
+ Applications that use a 1.0 persistence.xml will
+ automatically maintain the old behavior. It is
+ possible for a version 2.0 application to revert back to
+ the prior 1.x.x behavior by setting the following
+ openjpa.Compatibility property as follows:
+ </p><table border="0" summary="Simple list"
class="simplelist"><tr><td>IgnoreDetachedStateFieldForProxySerialization=true</td></tr></table><p>
+ </p>
+ </div>
+ <div class="section" id="QuerySQLCache"><div
class="titlepage"><div><div><h4 class="title">1.1.6.
+ openjpa.jdbc.QuerySQLCache
+ </h4></div></div></div>
+
+
+ <p>
+ In prior 1.x.x releases, the openjpa.jdbc.QuerySQLCache
+ configuration property for Prepared SQL Cache accepted
+ value <code class="literal">all</code> to never drop items
from the
+ cache, but this option is no longer supported and will
cause
+ a PersistenceException with a root cause of a
ParseException
+ to be thrown. See
+ <a class="xref" href="ref_guide_cache_querysql.html"
title="3. Prepared SQL Cache">Section 3, “Prepared SQL
Cache”</a>
+ for details on the available configuration values.
+ </p>
+ </div>
+ </div>
+ <div class="section" id="Disabling AutoOff Collection Tracking"><div
class="titlepage"><div><div><h3 class="title">1.2.
+ Disabling AutoOff Collection Tracking
+ </h3></div></div></div>
+
+
+ <p>
+ The default behavior of OpenJPA in tracking collections is that
+ if the number of modifications to the collection exceeds the
+ current number of elements in collection then OpenJPA will
+ disable tracking the collections. OpenJPA 2.0 added a
compatibility
+ property to disable turning off the collection tracking.
+ </p>
+ <p>
+ The behavior of Auto disabling of collection tracking can be
+ avoided by setting the value of the
+ <code class="literal">openjpa.Compatibility</code> property
+ <code class="literal">autoOff</code> to <code
class="literal">false</code>.
+ The default behavior of auto disabling the collection tracking
+ is not changed. But when the above property is set then the
+ collection tracking will not be disabled automatically.
+ </p>
+ </div>
+ <div class="section" id="internal_differences"><div
class="titlepage"><div><div><h3 class="title">1.3.
+ Internal Behavioral Differences
+ </h3></div></div></div><div class="toc"><dl class="toc"><dt><span
class="section"><a href="migration_considerations.html#prePostUpdate">1.3.1.
+ PreUpdate/PostUpdate Life Cycle Callbacks
+ </a></span></dt><dt><span class="section"><a
href="migration_considerations.html#createemf">1.3.2.
+ createEntityManagerFactory Exceptions
+ </a></span></dt><dt><span class="section"><a
href="migration_considerations.html#querycache">1.3.3.
+ openjpa.QueryCache default
+ </a></span></dt></dl></div>
+
+ <p>
+ The following sections indicate internal changes between
+ OpenJPA 1.x.x releases and the 2.0 release. As these are
+ internal implementation specific behaviors not covered by
+ the JPA specification, no changes should be required for
+ applications that did not use or depend upon OpenJPA specific
+ APIs or behavior.
+ </p>
+
+ <div class="section" id="prePostUpdate"><div
class="titlepage"><div><div><h4 class="title">1.3.1.
+ PreUpdate/PostUpdate Life Cycle Callbacks
+ </h4></div></div></div>
+
+
+ <p>
+ If an entity was updated between the persist()
+ and commit() operations in OpenJPA 1.x, then
+ any PreUpdate and PostUpdate life cycle callback
+ methods would be executed. Starting in OpenJPA
+ 1.3 and 2.0, these callbacks will not get executed.
+ </p>
+ <p>
+ The JPA 2.0 specification section on "Semantics
+ of the Life Cycle Callback Methods for Entities"
+ has been updated to include a Note that the
+ callback behavior for updating an entity after
+ the persist operation is implementation specific
+ and should not be relied upon.
+ </p>
+ </div>
+ <div class="section" id="createemf"><div
class="titlepage"><div><div><h4 class="title">1.3.2.
+ createEntityManagerFactory Exceptions
+ </h4></div></div></div>
+
+
+ <p>
+ The JPA 2.0 specification section on
+ "Bootstrapping in Java SE Environments" states
+ that persistence providers must return null
+ if they are not a qualified provider for the
+ given persistence unit.
+ </p>
+ <p>
+ However, OpenJPA may throw a RuntimeException
+ if an error occurs while trying to create a
+ qualified persistence unit, like for invalid
+ openjpa.* specific configuration settings or
+ for schema validation failures.
+ </p>
+ <p>
+ If the Apache Geronimo JPA 2.0 Spec APIs are
+ used, then any exceptions returned by a
+ persistence provider will be wrapped within
+ a PersistenceException. When the JPA 2.0 API
+ reference implementation is used, any
+ RuntimeExceptions will be returned to the
+ calling application without being wrapped.
+ Other JPA 2.0 API and implementation providers
+ or versions may behave differently.
+ </p>
+ </div>
+ <div class="section" id="querycache"><div
class="titlepage"><div><div><h4 class="title">1.3.3.
+ openjpa.QueryCache default
+ </h4></div></div></div>
+
+
+ <p>
+ In previous releases, the default value for the
+ openjpa.QueryCache property was <code
class="literal">true</code>
+ when the openjpa.DataCache was enabled. Depending on
+ application characteristics, this default QueryCache
+ enablement actually could negate much of the potential
+ gains achieved by using the DataCache. Thus, the default
+ value for the openjpa.QueryCache property is now
+ <span class="emphasis"><em><code
class="literal">false</code></em></span>.
+ </p>
+ <p>
+ To re-enable the default QueryCache behavior, you need to
+ include the following property in your persistence.xml
+ configuration.
+ </p><pre class="programlisting">
+ <property name="openjpa.QueryCache" value="true"/>
+ </pre><p>
+ </p>
+ <p>
+ If your configuration had previously enabled the QueryCache
+ explicitly, then you might have to include the
+ <code class="literal">true</code> value into your
configuration
+ (if you relied on the previous default). Otherwise, your
+ current QueryCache enablement will continue to work.
+ </p><pre class="programlisting">
+ <property name="openjpa.QueryCache" value="true(CacheSize=1000,
SoftReferenceSize=100)"/>
+ </pre><p>
+ </p>
+ </div>
+ </div>
+ </div>
+
+
+</div><div class="navfooter"><hr><table width="100%" summary="Navigation
footer"><tr><td width="40%" align="left"><a accesskey="p"
href="dbsupport_sybase.html">Prev</a> </td><td width="20%"
align="center"><a accesskey="u" href="appendices.html">Up</a></td><td
width="40%" align="right"> <a accesskey="n"
href="jpa_2.2.html">Next</a></td></tr><tr><td width="40%" align="left"
valign="top">24.
+ Sybase Adaptive Server
+ </td><td width="20%" align="center"><a accesskey="h"
href="manual.html">Home</a></td><td width="40%" align="right"
valign="top"> 2.
+ OpenJPA 2.2.0
+ </td></tr></table></div></body></html>
\ No newline at end of file
Added:
websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/openjpa_intro.html
==============================================================================
---
websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/openjpa_intro.html
(added)
+++
websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/openjpa_intro.html
Fri Jan 6 19:19:20 2017
@@ -0,0 +1,60 @@
+<html><head>
+ <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+ <title>Chapter 1. About</title><base href="display"><link
rel="stylesheet" type="text/css" href="css/docbook.css"><meta name="generator"
content="DocBook XSL Stylesheets V1.79.1"><link rel="home" href="manual.html"
title="Apache OpenJPA 2.4 User's Guide"><link rel="up" href="introduction.html"
title="Part 1. Introduction"><link rel="prev"
href="introduction.html" title="Part 1. Introduction"><link
rel="next" href="openjpa_legal.html" title="Chapter 2.
Legal"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084"
alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation
header"><tr><th colspan="3" align="center">Chapter 1.
+ About
+ </th></tr><tr><td width="20%" align="left"><a accesskey="p"
href="introduction.html">Prev</a> </td><th width="60%"
align="center">Part 1. Introduction</th><td width="20%"
align="right"> <a accesskey="n"
href="openjpa_legal.html">Next</a></td></tr></table><hr></div><div
class="chapter" id="openjpa_intro"><div class="titlepage"><div><div><h2
class="title">Chapter 1.
+ About
+ </h2></div></div></div>
+
+ <a class="indexterm" name="d5e13"></a>
+ <p>
+OpenJPA is Apache's implementation of Java Persistence 2.0 API
+(JSR-317 JPA 2.0) specification for the transparent persistence of Java
objects.
+This document provides an overview of the JPA standard and technical
+details on the use of OpenJPA.
+ </p>
+
+
+ <p>
+This document is intended for OpenJPA users. It is divided into several parts:
+ </p>
+ <div class="itemizedlist"><ul class="itemizedlist"
style="list-style-type: disc; "><li class="listitem">
+ <p>
+The <a class="link" href="jpa_overview_intro.html"
title="Chapter 1. Introduction">JPA Overview</a> describes the
+fundamentals of the JPA specification.
+ </p>
+ </li><li class="listitem">
+ <p>
+The <a class="link" href="ref_guide_intro.html" title="Chapter 1.
Introduction">OpenJPA Reference Guide</a> contains
+detailed documentation on all aspects of OpenJPA. Browse through this guide
+to familiarize yourself with the many advanced features and customization
+opportunities OpenJPA provides. Later, you can use the guide when you need
+details on a specific aspect of OpenJPA.
+ </p>
+ </li><li class="listitem">
+ <p>
+ Appendices
+ </p><div class="itemizedlist"><ul class="itemizedlist"
style="list-style-type: circle; "><li class="listitem">
+ <p>
+ The appendix <a class="link"
href="jpa_resources.html" title="Appendix 1. JPA Resources">JPA
Resources
+ </a> provides links to other resources.
+ </p>
+ </li><li class="listitem">
+ <p>
+ The appendix <a class="link"
href="supported_databases.html" title="Appendix 2. Supported
Databases">
+ Supported Databases</a> provides information on
+ databases supported by OpenJPA.
+ </p>
+ </li><li class="listitem">
+ <p>
+ The appendix <a class="link"
href="migration_considerations.html" title="Appendix 3. Migration
Considerations">
+ Migration Considerations</a> provides
information
+ related to migration to a different release.
+ </p>
+ </li></ul></div><p>
+ </p>
+ </li></ul></div>
+
+</div><div class="navfooter"><hr><table width="100%" summary="Navigation
footer"><tr><td width="40%" align="left"><a accesskey="p"
href="introduction.html">Prev</a> </td><td width="20%" align="center"><a
accesskey="u" href="introduction.html">Up</a></td><td width="40%"
align="right"> <a accesskey="n"
href="openjpa_legal.html">Next</a></td></tr><tr><td width="40%" align="left"
valign="top">Part 1. Introduction </td><td width="20%"
align="center"><a accesskey="h" href="manual.html">Home</a></td><td width="40%"
align="right" valign="top"> Chapter 2.
+ Legal
+ </td></tr></table></div></body></html>
\ No newline at end of file
Added:
websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/openjpa_legal.html
==============================================================================
---
websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/openjpa_legal.html
(added)
+++
websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/openjpa_legal.html
Fri Jan 6 19:19:20 2017
@@ -0,0 +1,47 @@
+<html><head>
+ <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+ <title>Chapter 2. Legal</title><base href="display"><link
rel="stylesheet" type="text/css" href="css/docbook.css"><meta name="generator"
content="DocBook XSL Stylesheets V1.79.1"><link rel="home" href="manual.html"
title="Apache OpenJPA 2.4 User's Guide"><link rel="up" href="introduction.html"
title="Part 1. Introduction"><link rel="prev"
href="openjpa_intro.html" title="Chapter 1. About"><link rel="next"
href="openjpa_legal_notice.html" title="2. Notice"></head><body
bgcolor="white" text="black" link="#0000FF" vlink="#840084"
alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation
header"><tr><th colspan="3" align="center">Chapter 2.
+ Legal
+ </th></tr><tr><td width="20%" align="left"><a accesskey="p"
href="openjpa_intro.html">Prev</a> </td><th width="60%"
align="center">Part 1. Introduction</th><td width="20%"
align="right"> <a accesskey="n"
href="openjpa_legal_notice.html">Next</a></td></tr></table><hr></div><div
class="chapter" id="openjpa_legal"><div class="titlepage"><div><div><h2
class="title">Chapter 2.
+ Legal
+ </h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl
class="toc"><dt><span class="section"><a
href="openjpa_legal.html#openjpa_legal_license">1.
+ License
+ </a></span></dt><dt><span class="section"><a
href="openjpa_legal_notice.html">2.
+ Notice
+ </a></span></dt><dt><span class="section"><a
href="openjpa_legal_copyright.html">3.
+ Copyrights
+ </a></span></dt><dd><dl><dt><span class="section"><a
href="openjpa_legal_copyright.html#openjpa_legal_copyright_apache">3.1.
Apache</a></span></dt><dt><span class="section"><a
href="openjpa_legal_copyright.html#openjpa_legal_copyright_serp">3.2.
Serp</a></span></dt><dt><span class="section"><a
href="openjpa_legal_copyright.html#openjpa_legal_copyright_sun">3.3.
Sun</a></span></dt><dt><span class="section"><a
href="openjpa_legal_copyright.html#openjpa_legal_copyright_other">3.4.
Other</a></span></dt></dl></dd></dl></div>
+
+ <a class="indexterm" name="d5e38"></a>
+ <p>
+ </p>
+ <p>
+The Apache OpenJPA website can be found at:
+<a class="ulink" href="http://openjpa.apache.org/"; target="_top">
http://openjpa.apache.org </a>
+ </p>
+ <p>
+ </p>
+
+ <div class="section" id="openjpa_legal_license"><div
class="titlepage"><div><div><h2 class="title" style="clear: both">1.
+ License
+ </h2></div></div></div>
+
+ <p>
+Apache OpenJPA is released under the <a class="ulink"
href="http://www.apache.org/licenses/LICENSE-2.0.txt"; target="_top">Apache
Software License Version 2.0</a>
+ </p>
+ <p>
+Apache OpenJPA includes the persistence and orm schemas from the JPA
specifications and elects to include this software in this distribution under
the <a class="ulink" href="https://glassfish.dev.java.net/public/CDDL+GPL.html";
target="_top">CDDL license.</a>
+ </p>
+ <p>
+Apache OpenJPA includes software developed by the SERP project, which uses the
<a class="ulink" href="http://www.opensource.org/licenses/bsd-license.php";
target="_top">BSD license</a>
+ </p>
+ </div>
+
+
+
+
+</div><div class="navfooter"><hr><table width="100%" summary="Navigation
footer"><tr><td width="40%" align="left"><a accesskey="p"
href="openjpa_intro.html">Prev</a> </td><td width="20%" align="center"><a
accesskey="u" href="introduction.html">Up</a></td><td width="40%"
align="right"> <a accesskey="n"
href="openjpa_legal_notice.html">Next</a></td></tr><tr><td width="40%"
align="left" valign="top">Chapter 1.
+ About
+ </td><td width="20%" align="center"><a accesskey="h"
href="manual.html">Home</a></td><td width="40%" align="right"
valign="top"> 2.
+ Notice
+ </td></tr></table></div></body></html>
\ No newline at end of file
Added:
websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/openjpa_legal_copyright.html
==============================================================================
---
websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/openjpa_legal_copyright.html
(added)
+++
websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/openjpa_legal_copyright.html
Fri Jan 6 19:19:20 2017
@@ -0,0 +1,65 @@
+<html><head>
+ <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+ <title>3. Copyrights</title><base href="display"><link
rel="stylesheet" type="text/css" href="css/docbook.css"><meta name="generator"
content="DocBook XSL Stylesheets V1.79.1"><link rel="home" href="manual.html"
title="Apache OpenJPA 2.4 User's Guide"><link rel="up"
href="openjpa_legal.html" title="Chapter 2. Legal"><link rel="prev"
href="openjpa_legal_notice.html" title="2. Notice"><link rel="next"
href="jpa_overview.html" title="Part 2. Java Persistence
API"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084"
alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation
header"><tr><th colspan="3" align="center">3.
+ Copyrights
+ </th></tr><tr><td width="20%" align="left"><a accesskey="p"
href="openjpa_legal_notice.html">Prev</a> </td><th width="60%"
align="center">Chapter 2.
+ Legal
+ </th><td width="20%" align="right"> <a accesskey="n"
href="jpa_overview.html">Next</a></td></tr></table><hr></div><div
class="section" id="openjpa_legal_copyright"><div
class="titlepage"><div><div><h2 class="title" style="clear: both">3.
+ Copyrights
+ </h2></div></div></div><div class="toc"><dl class="toc"><dt><span
class="section"><a
href="openjpa_legal_copyright.html#openjpa_legal_copyright_apache">3.1.
Apache</a></span></dt><dt><span class="section"><a
href="openjpa_legal_copyright.html#openjpa_legal_copyright_serp">3.2.
Serp</a></span></dt><dt><span class="section"><a
href="openjpa_legal_copyright.html#openjpa_legal_copyright_sun">3.3.
Sun</a></span></dt><dt><span class="section"><a
href="openjpa_legal_copyright.html#openjpa_legal_copyright_other">3.4.
Other</a></span></dt></dl></div>
+
+ <div class="section" id="openjpa_legal_copyright_apache"><div
class="titlepage"><div><div><h3
class="title">3.1. Apache</h3></div></div></div>
+
+ <p>
+Copyright (C) 2006,2011 The Apache Software Foundation.
+ </p>
+ <p>
+Apache, OpenJPA and the Apache feather logo are trademarks of Apache Software
Foundation.
+ </p>
+ </div>
+ <div class="section" id="openjpa_legal_copyright_serp"><div
class="titlepage"><div><div><h3
class="title">3.2. Serp</h3></div></div></div>
+
+ <p>
+OpenJPA includes software developed by the SERP project.
+ </p>
+ <p>
+Copyright (c) 2002-2006, A. Abram White. All rights reserved.
+ </p>
+ </div>
+ <div class="section" id="openjpa_legal_copyright_sun"><div
class="titlepage"><div><div><h3
class="title">3.3. Sun</h3></div></div></div>
+
+ <p>
+OpenJPA includes the persistence and orm schemas from the JPA specifications.
+ </p>
+ <p>
+Copyright 2005-2009 Sun Microsystems, Inc. All rights reserved.
+ </p>
+ <p>
+OpenJPA elects to include this software in this distribution under the CDDL
license.
+ </p>
+ <p>
+You can obtain a copy of the License at:
+<a class="ulink" href="https://glassfish.dev.java.net/public/CDDL+GPL.html";
target="_top">https://glassfish.dev.java.net/public/CDDL+GPL.html</a>
+ </p>
+ <p>
+The source code is available at:
+<a class="ulink" href="http://java.net/projects/glassfish/sources/svn/show";
target="_top">http://java.net/projects/glassfish/sources/svn/show</a>
+or <a class="ulink" href="http://jcp.org/en/jsr/detail?id=317"; target="_top">
http://jcp.org/en/jsr/detail?id=317 </a>
+ </p>
+ </div>
+ <div class="section" id="openjpa_legal_copyright_other"><div
class="titlepage"><div><div><h3
class="title">3.4. Other</h3></div></div></div>
+
+ <p>
+OpenJPA includes software written by Miroslav Nachev.
+ </p>
+ <p>
+OpenJPA uses test code written by Charles Tillman.
+ </p>
+ <p>
+Oracle and Java are registered trademarks of Oracle and/or its affiliates.
+Other names may be trademarks of their respective owners.
+ </p>
+ </div>
+ </div><div class="navfooter"><hr><table width="100%" summary="Navigation
footer"><tr><td width="40%" align="left"><a accesskey="p"
href="openjpa_legal_notice.html">Prev</a> </td><td width="20%"
align="center"><a accesskey="u" href="openjpa_legal.html">Up</a></td><td
width="40%" align="right"> <a accesskey="n"
href="jpa_overview.html">Next</a></td></tr><tr><td width="40%" align="left"
valign="top">2.
+ Notice
+ </td><td width="20%" align="center"><a accesskey="h"
href="manual.html">Home</a></td><td width="40%" align="right"
valign="top"> Part 2. Java Persistence
API</td></tr></table></div></body></html>
\ No newline at end of file
Added:
websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/openjpa_legal_notice.html
==============================================================================
---
websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/openjpa_legal_notice.html
(added)
+++
websites/production/openjpa/content/builds/2.4.2/apache-openjpa/docs/openjpa_legal_notice.html
Fri Jan 6 19:19:20 2017
@@ -0,0 +1,37 @@
+<html><head>
+ <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
+ <title>2. Notice</title><base href="display"><link rel="stylesheet"
type="text/css" href="css/docbook.css"><meta name="generator" content="DocBook
XSL Stylesheets V1.79.1"><link rel="home" href="manual.html" title="Apache
OpenJPA 2.4 User's Guide"><link rel="up" href="openjpa_legal.html"
title="Chapter 2. Legal"><link rel="prev" href="openjpa_legal.html"
title="Chapter 2. Legal"><link rel="next"
href="openjpa_legal_copyright.html" title="3. Copyrights"></head><body
bgcolor="white" text="black" link="#0000FF" vlink="#840084"
alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation
header"><tr><th colspan="3" align="center">2.
+ Notice
+ </th></tr><tr><td width="20%" align="left"><a accesskey="p"
href="openjpa_legal.html">Prev</a> </td><th width="60%"
align="center">Chapter 2.
+ Legal
+ </th><td width="20%" align="right"> <a accesskey="n"
href="openjpa_legal_copyright.html">Next</a></td></tr></table><hr></div><div
class="section" id="openjpa_legal_notice"><div class="titlepage"><div><div><h2
class="title" style="clear: both">2.
+ Notice
+ </h2></div></div></div>
+
+ <p>
+This product includes software developed by
+<a class="ulink" href="http://www.apache.org/"; target="_top"> The Apache
Software Foundation (http://www.apache.org/).</a>
+ </p>
+ <p>
+The openjpa-all aggregate JAR includes software developed by the:
+ </p><div class="itemizedlist"><ul class="itemizedlist compact"
style="list-style-type: disc; "><li class="listitem"><p>
+ Apache Commons Collections project
+ </p></li><li class="listitem"><p>
+ Apache Commons Lang project
+ </p></li><li class="listitem"><p>
+ Apache Commons Logging project
+ </p></li><li class="listitem"><p>
+ Apache Commons Pool project
+ </p></li><li class="listitem"><p>
+ Apache Geronimo project (JMS 1.1, JTA 1.1 and JPA 2.0 spec APIs)
+ </p></li><li class="listitem"><p>
+ JCP JSR-317 JPA 2.0 schemas
+ </p></li><li class="listitem"><p>
+ SERP project
+ </p></li></ul></div><p>
+ </p>
+ </div><div class="navfooter"><hr><table width="100%" summary="Navigation
footer"><tr><td width="40%" align="left"><a accesskey="p"
href="openjpa_legal.html">Prev</a> </td><td width="20%" align="center"><a
accesskey="u" href="openjpa_legal.html">Up</a></td><td width="40%"
align="right"> <a accesskey="n"
href="openjpa_legal_copyright.html">Next</a></td></tr><tr><td width="40%"
align="left" valign="top">Chapter 2.
+ Legal
+ </td><td width="20%" align="center"><a accesskey="h"
href="manual.html">Home</a></td><td width="40%" align="right"
valign="top"> 3.
+ Copyrights
+ </td></tr></table></div></body></html>
\ No newline at end of file
