View source for EclipseLink/UserGuide/JPA/Advanced JPA Development/Performance/Weaving/Disabling Weaving with Persistence Unit Properties

----


'''[[Image:Elug_draft_icon.png|Warning]] This page is now obsolete. '''

For current information, please see "Weaving" in the ''Java Persistence API (JPA) Extensions Reference for EclipseLink,'':
http://www.eclipse.org/eclipselink/documentation/latest/jpa/extensions/persistenceproperties_ref.htm#CACGCEIJ2


----


{{EclipseLink_UserGuide
|info=y
|toc=n
|eclipselink=y
|eclipselinktype=JPA}}

=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>



{{EclipseLink_JPA
|previous=[[EclipseLink/UserGuide/JPA/Advanced_JPA_Development/Performance/Weaving/Static Weaving|Static Weaving]]
|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]]
|version=2.4 DRAFT}}