diff options
| author | Rick Sapir | 2012-09-27 13:59:22 +0000 |
|---|---|---|
| committer | Rick Sapir | 2012-09-27 13:59:22 +0000 |
| commit | 3c27ef18cf04f6860538968ebcb0bb518f7c3e5f (patch) | |
| tree | 773f4c65588e35db2afbdd7e3574c1cd225ab983 /jpa/plugins/org.eclipse.jpt.doc.user/reference052.htm | |
| parent | 21fb9bf2b3596877852953a14f897419cc943e03 (diff) | |
| download | webtools.dali-3c27ef18cf04f6860538968ebcb0bb518f7c3e5f.tar.gz webtools.dali-3c27ef18cf04f6860538968ebcb0bb518f7c3e5f.tar.xz webtools.dali-3c27ef18cf04f6860538968ebcb0bb518f7c3e5f.zip | |
doc updates
Diffstat (limited to 'jpa/plugins/org.eclipse.jpt.doc.user/reference052.htm')
| -rw-r--r-- | jpa/plugins/org.eclipse.jpt.doc.user/reference052.htm | 189 |
1 files changed, 83 insertions, 106 deletions
diff --git a/jpa/plugins/org.eclipse.jpt.doc.user/reference052.htm b/jpa/plugins/org.eclipse.jpt.doc.user/reference052.htm index a8ec678dfc..8c7277498f 100644 --- a/jpa/plugins/org.eclipse.jpt.doc.user/reference052.htm +++ b/jpa/plugins/org.eclipse.jpt.doc.user/reference052.htm @@ -5,155 +5,132 @@ <meta http-equiv="Content-Type" content="text/html; charset=us-ascii" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <meta http-equiv="Content-Script-Type" content="text/javascript" /> -<title>Caching</title> +<title>Queries</title> <meta name="copyright" content="Copyright (c) 2000, 2009 oracle . All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html. Contributors: Oracle - initial API and implementation" /> <meta name="generator" content="Oracle DARB XHTML Converter (Mode = ohj/ohw) - Version 1.0.11" /> -<meta name="date" content="2012-09-19T13:28:0Z" /> +<meta name="date" content="2012-09-27T9:43:53Z" /> <meta name="robots" content="noarchive" /> -<meta name="doctitle" content="Caching" /> +<meta name="doctitle" content="Queries" /> <meta name="relnum" content="Release 3.2" /> <meta name="partnum" content="Release 3.2" /> <link rel="copyright" href="dcommon/html/cpyr.htm" title="Copyright" type="text/html" /> <link rel="stylesheet" href="dcommon/css/blafdoc.css" title="Oracle BLAFDoc" type="text/css" /> </head> <body> -<p class="betadraftsubtitle">Beta Draft: 2012-09-19</p> -<p><a id="CIABEDCH" name="CIABEDCH"></a><a id="ref_persistence_caching" name="ref_persistence_caching"></a></p> +<p class="betadraftsubtitle">Beta Draft: 2012-09-27</p> +<p><a id="CIAIBAAJ" name="CIAIBAAJ"></a></p> <div class="sect3"><!-- infolevel="all" infotype="General" --> -<h1><a id="sthref596" name="sthref596"></a><a id="sthref597" name="sthref597"></a>Caching</h1> -<p>This table lists the properties of the Caching page of the <a href="ref_persistence_xmll_editor.htm#CIACCHID">persistence.xml Editor</a>.</p> +<h1><a id="sthref594" name="sthref594"></a><a id="sthref595" name="sthref595"></a><a id="sthref596" name="sthref596"></a><a id="sthref597" name="sthref597"></a><a id="sthref598" name="sthref598"></a><a id="sthref599" name="sthref599"></a><a id="sthref600" name="sthref600"></a>Queries</h1> +<p>This table lists the Query information fields available in the <span class="gui-object-title">JPA Details</span> view for the <code>orm.xml</code> file.</p> <div class="inftblhruleinformal"> -<table class="HRuleInformal" summary="This table lists the properties of the Caching page of the persistence.xml Editor." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> -<col width="24%" /> +<table class="HRuleInformal" title="This table describes the options on the Persistence Properties view, General tab." summary="This table describes the options on the Persistence Properties view, General tab." dir="ltr" border="1" width="100%" frame="hsides" rules="rows" cellpadding="3" cellspacing="0"> +<col width="21%" /> <col width="*" /> -<col width="24%" /> +<col width="23%" /> <thead> <tr align="left" valign="top"> -<th align="left" valign="bottom" id="r1c1-t56">Property</th> -<th align="left" valign="bottom" id="r1c2-t56">Description</th> -<th align="left" valign="bottom" id="r1c3-t56">Default</th> +<th align="left" valign="bottom" id="r1c1-t51">Property</th> +<th align="left" valign="bottom" id="r1c2-t51">Description</th> +<th align="left" valign="bottom" id="r1c3-t51">Default</th> </tr> </thead> <tbody> <tr align="left" valign="top"> -<td align="left" id="r2c1-t56" headers="r1c1-t56"> -<p>Shared cache mode</p> +<td align="left" id="r2c1-t51" headers="r1c1-t51"> +<p><span class="bold">Queries</span></p> </td> -<td align="left" headers="r2c1-t56 r1c2-t56"> -<p>Select one of the following as the shared cache mode:</p> -<ul> -<li> -<p><span class="bold">All</span> – .</p> -</li> -<li> -<p><span class="bold">None</span> –</p> -</li> -<li> -<p><span class="bold">Enable Selective</span> –</p> -</li> -<li> -<p><span class="bold">Disable Selective</span> –</p> -</li> -<li> -<p><span class="bold">Unspecified</span> –</p> -</li> -</ul> -</td> -<td align="left" headers="r2c1-t56 r1c3-t56"> -<p>Disable selective</p> +<td align="left" headers="r2c1-t51 r1c2-t51"> +<p>Displays the existing Named and Native queries.</p> +<p>Click <span class="bold">Add</span> to add a named query, or <span class="bold">Add Native</span> for a native query.</p> +<p>For named queries, enter the query in the Query field.</p> +<p>For native queries, select a result class, then enter the query in the Query field.</p> </td> +<td align="left" headers="r2c1-t51 r1c3-t51"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r3c1-t56" headers="r1c1-t56"> -<p>Default Cache Type</p> +<td align="left" id="r3c1-t51" headers="r1c1-t51"> +<p><span class="bold">Named Queries</span></p> </td> -<td align="left" headers="r3c1-t56 r1c2-t56"> -<p>Select one of the following as the Default Cache Type:</p> -<ul> -<li> -<p><span class="bold">Weak with Soft Subcache</span>–This option is similar to <span class="bold">Weak with Hard Subcache</span> except that it maintains a most frequently used subcache that uses soft references. The size of the subcache is proportional to the size of the identity map. The subcache uses soft references to ensure that these objects are garbage-collected only if the system is low on memory.</p> -<p>Use this identity map in most circumstances as a means to control memory used by the cache.</p> -</li> -<li> -<p><span class="bold">Weak with Hard Subcache</span>–This option is similar to <span class="bold">Soft with Weak</span> subcache except that it maintains a most frequently used subcache that uses hard references. Use this identity map if soft references are not suitable for your platform.</p> -</li> -<li> -<p><span class="bold">Weak</span>–This option is similar to <span class="bold">Full</span>, except that objects are referenced using weak references. This option uses less memory than <span class="bold">Full</span>, allows complete garbage collection and provides full caching and guaranteed identity.</p> -<p>Use this identity map for transactions that, once started, stay on the server side.</p> -</li> -<li> -<p><span class="bold">Soft</span>–This option is similar to <span class="bold">Weak</span> except that the map holds the objects using soft references. This identity map enables full garbage collection when memory is low. It provides full caching and guaranteed identity.</p> -</li> -<li> -<p><span class="bold">Full</span>–This option provides full caching and guaranteed identity: all objects are cached and not removed.</p> -<p>Note: This process may be memory-intensive when many objects are read.</p> -</li> -<li> -<p><span class="bold">None</span>–This option does not preserve object identity and does not cache objects.This option is not recommended.</p> -</li> -</ul> +<td align="left" headers="r3c1-t51 r1c2-t51"><br /></td> +<td align="left" headers="r3c1-t51 r1c3-t51"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r4c1-t51" headers="r1c1-t51"> +<p>Name</p> </td> -<td align="left" headers="r3c1-t56 r1c3-t56"> -<p>Weak with soft subcache</p> +<td align="left" headers="r4c1-t51 r1c2-t51"><br /></td> +<td align="left" headers="r4c1-t51 r1c3-t51"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r5c1-t51" headers="r1c1-t51"> +<p>Query</p> </td> +<td align="left" headers="r5c1-t51 r1c2-t51"><br /></td> +<td align="left" headers="r5c1-t51 r1c3-t51"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r4c1-t56" headers="r1c1-t56"> -<p>Default Cache Size</p> +<td align="left" id="r6c1-t51" headers="r1c1-t51"> +<p>Lock mode</p> </td> -<td align="left" headers="r4c1-t56 r1c2-t56"> -<p>Set the size (maximum number of objects) of the cache.</p> +<td align="left" headers="r6c1-t51 r1c2-t51"><br /></td> +<td align="left" headers="r6c1-t51 r1c3-t51"> +<p>None</p> </td> -<td align="left" headers="r4c1-t56 r1c3-t56"> -<p>100</p> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r7c1-t51" headers="r1c1-t51"> +<p><span class="bold">Native Queries</span></p> </td> +<td align="left" headers="r7c1-t51 r1c2-t51"><br /></td> +<td align="left" headers="r7c1-t51 r1c3-t51"><br /></td> </tr> <tr align="left" valign="top"> -<td align="left" id="r5c1-t56" headers="r1c1-t56"> -<p>Flush clear cache</p> +<td align="left" id="r8c1-t51" headers="r1c1-t51"> +<p>Name</p> </td> -<td align="left" headers="r5c1-t56 r1c2-t56"> -<p>Select one of the following as the Default Cache Type:</p> -<ul> -<li> -<p><span class="bold">Drop</span> – This mode is the fastest and uses the least memory. However, after commit the shared cache might potentially contain stale data.</p> -</li> -<li> -<p><span class="bold">Drop Invalidate</span> – Classes that have at least one object updated or deleted are invalidated in the shared cache at commit time. This mode is slower than <span class="bold">Drop</span>, but as efficient memory usage-wise, and prevents stale data.</p> -</li> -<li> -<p><span class="bold">Merge</span> – Drop classes from the EntityManager's cache of objects that have not been flushed. This mode leaves the shared cache in a perfect state after commit. However, it is the least memory-efficient mode; the memory might even run out in a very large transaction.</p> -</li> -</ul> +<td align="left" headers="r8c1-t51 r1c2-t51"><br /></td> +<td align="left" headers="r8c1-t51 r1c3-t51"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r9c1-t51" headers="r1c1-t51"> +<p>Result class</p> </td> -<td align="left" headers="r5c1-t56 r1c3-t56"> -<p>Drop Invalidate</p> +<td align="left" headers="r9c1-t51 r1c2-t51"><br /></td> +<td align="left" headers="r9c1-t51 r1c3-t51"><br /></td> +</tr> +<tr align="left" valign="top"> +<td align="left" id="r10c1-t51" headers="r1c1-t51"> +<p>Query</p> </td> +<td align="left" headers="r10c1-t51 r1c2-t51"><br /></td> +<td align="left" headers="r10c1-t51 r1c3-t51"><br /></td> </tr> -</tbody> -</table> -<br /></div> -<!-- class="inftblhruleinformal" --> -<div align="center"> -<div class="inftblnote"><br /> -<table class="Note oac_no_warn" summary="" cellpadding="3" cellspacing="0"> -<tbody> -<tr> -<td align="left"> -<p class="notep1">Note:</p> -<p>This page is not available for projects using the <span class="bold">Generic</span> platform.</p> +<tr align="left" valign="top"> +<td align="left" id="r11c1-t51" headers="r1c1-t51"> +<p><span class="bold">Query Hints</span></p> +</td> +<td align="left" headers="r11c1-t51 r1c2-t51"> +<p>Displays the existing query hints (Name and Value).</p> +<p>Click <span class="bold">Add</span> to add a new query hint.</p> </td> +<td align="left" headers="r11c1-t51 r1c3-t51"><br /></td> </tr> </tbody> </table> <br /></div> -<!-- class="inftblnote" --></div> -<a id="sthref598" name="sthref598"></a> -<p class="subhead2">Related references</p> +<!-- class="inftblhruleinformal" --> +<a id="sthref601" name="sthref601"></a> +<p class="subhead2">Related tasks</p> +<ul> +<li> +<p><a href="tasks011.htm#BABIGBGG">Creating queries</a></p> +</li> +</ul> +<a id="sthref602" name="sthref602"></a> +<p class="subhead2">Related reference</p> <ul> <li> -<p><span class="italic">Java Persistence API (JPA) Extensions Reference for EclipseLink</span><br /> -<code><a href="http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm">http://www.eclipse.org/eclipselink/documentation/2.4/jpa/extensions/toc.htm</a></code></p> +<p><a href="ref_details_orm.htm#CACGDGHC">JPA Details view (for orm.xml)</a></p> </li> </ul> </div> |