Jump to: navigation, search

Difference between revisions of "EclipseLink/UserGuide/JPA/Advanced JPA Development/Performance/Weaving/Disabling Weaving with Persistence Unit Properties"

m (New page: =Disabling Weaving with Persistence Unit Properties= {{EclipseLink_JPA |previous=Static Weaving...)
 
(Disabling Weaving with Persistence Unit Properties)
(10 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 +
{{EclipseLink_UserGuide
 +
|info=y
 +
|toc=n
 +
|eclipselink=y
 +
|eclipselinktype=JPA}}
 +
 
=Disabling Weaving with Persistence Unit Properties=
 
=Disabling Weaving with Persistence Unit Properties=
 +
To disable weaving using EclipseLink persistence unit properties:
 +
 +
<ol>
 +
<li>Configure your <tt>persistence.xml</tt> file with one or more of the following properties set to <tt>true</tt> or <tt>false</tt><nowiki>:</nowiki>
 +
* <tt>eclipselink.weaving</tt> – This can be used to disables all weaving.  This defaults to true if weaving is possible in the environment.
 +
* <tt>eclipselink.weaving.lazy</tt> – This can be used to disables weaving for lazy loading (indirection).  This defaults to true.
 +
* <tt>eclipselink.weaving.changetracking</tt> –  This can be used to disables weaving for change tracking.  This defaults to true if change tracking is possible for the entity (the entity must have LAZY collection relationships, no mutable basic mappings, and no embeddable element collection mappings).
 +
* <tt>eclipselink.weaving.fetchgroups</tt> – This can be used to disables weaving for fetch groups.  This defaults to true.
 +
* <tt>eclipselink.weaving.internal</tt> – This can be used to disables weaving for internal optimization.  This defaults to true.
 +
* <tt>eclipselink.weaving.eager</tt> – This can be used to enable weaving for indirection on eager relationships, this allows change tracking on eager collection relationships, and improves cache concurrency for eager object relationships.  This defaults to false.<br><br>
 +
This example shows how to disable weaving for change tracking only.
 +
<br>
 +
<span id="Example 19-41"></span>
 +
''''' Disabling Weaving for Change Tracking in the persistence.xml File'''''
 +
<source lang="xml">
 +
<persistence>
 +
  <persistence-unit name="HumanResources">
 +
      <class>com.acme.Employee</class>
 +
      ...
 +
      <properties>
 +
          <property name="eclipselink.weaving.changetracking" value="false"/>
 +
      </properties>
 +
  </persistence-unit>
 +
</persistence>
 +
</source>
 +
 +
The following example shows how to disable all weaving: in this example, EclipseLink does not weave for lazy loading (indirection), change tracking, or internal optimization.
 +
 +
<span id="Example 19-42"></span>
 +
''''' Disabling All Weaving in the persistence.xml File'''''
 +
<source lang="xml">
 +
persistence>
 +
  <persistence-unit name="HumanResources">
 +
      <class>com.acme.Employee</class>
 +
      ...
 +
      <properties>
 +
          <property name="eclipselink.weaving" value="false"/>
 +
      </properties>
 +
  </persistence-unit>
 +
</persistence>
 +
</source>
 +
 +
</li>
 +
<li>Package and and deploy your application. .
 +
</li>
 +
</ol>
  
  
Line 7: Line 59:
 
|next    =[[EclipseLink/UserGuide/JPA/Advanced_JPA_Development/Performance/Fetch Groups|Fetch Groups]]
 
|next    =[[EclipseLink/UserGuide/JPA/Advanced_JPA_Development/Performance/Fetch Groups|Fetch Groups]]
 
|up      =[[EclipseLink/UserGuide/JPA/Advanced_JPA_Development/Performance/Weaving/About Weaving|About Weaving]]
 
|up      =[[EclipseLink/UserGuide/JPA/Advanced_JPA_Development/Performance/Weaving/About Weaving|About Weaving]]
}}
+
|version=2.4 DRAFT}}

Revision as of 11:55, 24 May 2012

EclipseLink JPA

link="http://wiki.eclipse.org/EclipseLink"
EclipseLink
Website
Download
Community
Mailing ListForumsIRC
Bugzilla
Open
Help Wanted
Bug Day
Contribute
Browse Source


Disabling Weaving with Persistence Unit Properties

To disable weaving using EclipseLink persistence unit properties:

  1. Configure your persistence.xml file with one or more of the following properties set to true or false:
    • eclipselink.weaving – This can be used to disables all weaving. This defaults to true if weaving is possible in the environment.
    • eclipselink.weaving.lazy – This can be used to disables weaving for lazy loading (indirection). This defaults to true.
    • eclipselink.weaving.changetracking – This can be used to disables weaving for change tracking. This defaults to true if change tracking is possible for the entity (the entity must have LAZY collection relationships, no mutable basic mappings, and no embeddable element collection mappings).
    • eclipselink.weaving.fetchgroups – This can be used to disables weaving for fetch groups. This defaults to true.
    • eclipselink.weaving.internal – This can be used to disables weaving for internal optimization. This defaults to true.
    • eclipselink.weaving.eager – This can be used to enable weaving for indirection on eager relationships, this allows change tracking on eager collection relationships, and improves cache concurrency for eager object relationships. This defaults to false.

    This example shows how to disable weaving for change tracking only.
    Disabling Weaving for Change Tracking in the persistence.xml File
    <persistence>
       <persistence-unit name="HumanResources">
           <class>com.acme.Employee</class>
           ...
           <properties>
               <property name="eclipselink.weaving.changetracking" value="false"/>
           </properties>
       </persistence-unit>
    </persistence>

    The following example shows how to disable all weaving: in this example, EclipseLink does not weave for lazy loading (indirection), change tracking, or internal optimization.

    Disabling All Weaving in the persistence.xml File

    persistence>
       <persistence-unit name="HumanResources">
           <class>com.acme.Employee</class>
           ...
           <properties>
               <property name="eclipselink.weaving" value="false"/>
           </properties>
       </persistence-unit>
    </persistence>
  2. Package and and deploy your application. .


Eclipselink-logo.gif
Version: 2.4 DRAFT
Other versions...