openjpa-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From build...@apache.org
Subject svn commit: r906905 - in /websites/staging/openjpa/trunk/content: ./ entity-enhancement.html
Date Fri, 25 Apr 2014 19:39:23 GMT
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="dev@openjpa.apache.org" />
         <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>&nbsp;&raquo&nbsp;<a
href="/entity-enhancement.html">Entity Enhancement
</a>
+                                    <a href="/">Home</a>&nbsp;&raquo&nbsp;<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



Mime
View raw message