Author: buildbot
Date: Fri Apr 25 19:39:22 2014
New Revision: 906905
Log:
Staging update by buildbot for openjpa
Modified:
websites/staging/openjpa/trunk/content/ (props changed)
websites/staging/openjpa/trunk/content/entity-enhancement.html
Propchange: websites/staging/openjpa/trunk/content/
------------------------------------------------------------------------------
--- cms:source-revision (original)
+++ cms:source-revision Fri Apr 25 19:39:22 2014
@@ -1 +1 @@
-1560726
+1590119
Modified: websites/staging/openjpa/trunk/content/entity-enhancement.html
==============================================================================
--- websites/staging/openjpa/trunk/content/entity-enhancement.html (original)
+++ websites/staging/openjpa/trunk/content/entity-enhancement.html Fri Apr 25
19:39:22 2014
@@ -22,7 +22,7 @@ limitations under the License.
<!-- <link href="http://openjpa.apache.org/styles/type-settings.css";
rel="stylesheet" type="text/css"/> -->
<link href="./css/type-settings.css" rel="stylesheet" type="text/css"/>
<LINK rel="schema.DC" href="http://purl.org/DC/elements/1.0/";>
- <META name="Description" content="Apache OpenJPA -- Entity Enhancement
" />
+ <META name="Description" content="Apache OpenJPA -- Entity
Enhancement" />
<META name="Keywords" content="Apache OpenJPA, JPA, JPA 1.0, JSR-220,
JPA2, JPA 2.0, JSR-317, " />
<META name="Owner" content="[email protected]" />
<META name="Robots" content="index, follow" />
@@ -68,7 +68,7 @@ limitations under the License.
<div class="bottom_red_bar">
<div id="site-breadcrumbs">
<!-- Breadcrumbs --
- <a href="/">Home</a> » <a
href="/entity-enhancement.html">Entity Enhancement
</a>
+ <a href="/">Home</a> » <a
href="/entity-enhancement.html">Entity Enhancement</a>
-- Breadcrumbs -->
</div>
</div>
@@ -151,7 +151,7 @@ limitations under the License.
<p>The JPA spec requires some type of monitoring of Entity objects, but the
spec does not define how to implement this monitoring. Some JPA providers
auto-generate new subclasses or proxy objects that front the user's Entity
objects at runtime, while others use <a
href="#EntityEnhancement-byteCode">byte-code weaving</a> technologies to
enhance the actual Entity class objects. OpenJPA supports both mechanisms, but
strongly suggests only using the byte-code weaving enhancement. The <a
href="#EntityEnhancement-SubclassingEnhancement">subclassing</a> support (as
provided by OpenJPA)
is not recommended (and is disabled by default in OpenJPA 2.0 and beyond).</p>
<p>For complete details on entity enhancement, please checkout the section in
-the latest <a
href="http://openjpa.apache.org/builds/latest/docs/manual/manual.html#ref_guide_pc_enhance";>User's
Guide on Enhancement</a>
+the latest <a
href="http://ci.apache.org/projects/openjpa/trunk/docbook/manual.html#ref_guide_pc_enhance";>User's
Guide on Enhancement</a>
. The following sections will only cover the high-level concepts and the
ways to use the enhancer in different build and runtime setups.</p>
<p><a name="EntityEnhancement-byteCode"></a></p>
@@ -201,15 +201,14 @@ EntityManagerFactory is created prior to
</blockquote>
<p>If your application uses some other method of enhancement, this support can
be explicitly disabled by setting the following property in your
persistence.xml.</p>
<blockquote>
-<property name="openjpa.DynamicEnhancementAgent" value="false"/>
-
+<p><property name="openjpa.DynamicEnhancementAgent" value="false"/></p>
</blockquote>
<p><a name="EntityEnhancement-SubclassingEnhancement"></a></p>
<h2 id="subclassing-enhancement">Subclassing Enhancement</h2>
<p><span class="note">The use of OpenJPA's subclassing support is not
recommended, and is disabled by default in OpenJPA 2.0 and beyond.</span></p>
<p>When running in a Java SE environment or in a non-Java EE 5 compliant
container, OpenJPA can utilize runtime subclassing enhancement. The subclassing
enhancement support was added originally as a convenience to new developers to
reduce the amount of work to get a 'HelloWorld-ish' OpenJPA application working
out of the box. It was never meant to run in production. So you're probably
thinking that this sounds great! OpenJPA handles enhancement automatically for
me and I can stop reading this post. Wrong! Subclassing has two major
drawbacks. First off, it isn't nearly as fast as byte-code enhancement and the
second drawback is that there are some documented functional problems when
using the subclassing support. The moral of the story is, don't use this method
of enhancement.</p>
<p>For reference, the property that enables/disables the subclassing support
is openjpa.RuntimeUnenhancedClasses. The value "unsupported" is the recommended
and default setting for this property.</p>
-<p>Additional information regarding the subclassing enhancement can be found
in the <a
href="http://openjpa.apache.org/builds/latest/docs/manual/manual.html#ref_guide_pc_enhance";>OpenJPA
docs</a>.</p>
+<p>Additional information regarding the subclassing enhancement can be found
in the <a
href="http://ci.apache.org/projects/openjpa/trunk/docbook/manual.html#ref_guide_pc_enhance";>OpenJPA
docs</a>.</p>
<p><a name="EntityEnhancement-AuthorAttribution"></a></p>
<h2 id="author-attribution">Author Attribution</h2>
<p>The content for this page and sub-pages was adapted from content created by
