Modified: cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/including-cayenne-in-project.html URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/including-cayenne-in-project.html?rev=1811298&r1=1811297&r2=1811298&view=diff ============================================================================== --- cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/including-cayenne-in-project.html (original) +++ cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/including-cayenne-in-project.html Fri Oct 6 07:40:21 2017 @@ -9,16 +9,16 @@ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); })(); - </script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div xmlns:d="http://docbook.org/ns/docbook"; class="navheader"><table width="100%" summary="Navigation header"><tr><th class="versioninfo">v.4.0 (4.0.B1)</th><th align="center">Chapter 4. Including Cayenne in a Project</th><th></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="cayenne-guide-part2.html">Prev</a> </td><th width="60%" align="center"><a accesskey="u" href="cayenne-guide-part2.html">Part II. Cayenne Framework</a></th><td width="20%" align="right"> <a accesskey="n" href="starting-cayenne.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="including-cayenne-in-project"></a>Chapter 4. Including Cayenne in a Project</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="including-ca yenne-in-project.html#jar-files-and-depdendencies">Jar Files</a></span></dt><dt><span class="section"><a href="including-cayenne-in-project.html#d0e424">Dependencies</a></span></dt><dt><span class="section"><a href="including-cayenne-in-project.html#maven-projects">Maven Projects</a></span></dt><dt><span class="section"><a href="including-cayenne-in-project.html#gradle-projects">Gradle Projects</a></span></dt><dt><span class="section"><a href="including-cayenne-in-project.html#ant-projects">Ant Projects</a></span></dt></dl></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="jar-files-and-depdendencies"></a>Jar Files</h2></div></div></div><p>This is an overview of Cayenne jars that is agnostic of the build tool used. The + </script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div xmlns:d="http://docbook.org/ns/docbook"; class="navheader"><table width="100%" summary="Navigation header"><tr><th class="versioninfo">v.4.0 (4.0.B2)</th><th align="center">Chapter 4. Including Cayenne in a Project</th><th></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="cayenne-guide-part2.html">Prev</a> </td><th width="60%" align="center"><a accesskey="u" href="cayenne-guide-part2.html">Part II. Cayenne Framework</a></th><td width="20%" align="right"> <a accesskey="n" href="starting-cayenne.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="including-cayenne-in-project"></a>Chapter 4. Including Cayenne in a Project</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="including-ca yenne-in-project.html#jar-files-and-depdendencies">Jar Files</a></span></dt><dt><span class="section"><a href="including-cayenne-in-project.html#d0e435">Dependencies</a></span></dt><dt><span class="section"><a href="including-cayenne-in-project.html#maven-projects">Maven Projects</a></span></dt><dt><span class="section"><a href="including-cayenne-in-project.html#gradle-projects">Gradle Projects</a></span></dt><dt><span class="section"><a href="including-cayenne-in-project.html#ant-projects">Ant Projects</a></span></dt></dl></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="jar-files-and-depdendencies"></a>Jar Files</h2></div></div></div><p>This is an overview of Cayenne jars that is agnostic of the build tool used. The following are the important libraries:</p><p> - </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><span class="italic">cayenne-di-4.0.B1.jar</span> - Cayenne + </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><span class="italic">cayenne-di-4.0.B2.jar</span> - Cayenne dependency injection (DI) container library. All applications will require - this file.</p></li><li class="listitem"><p><span class="italic">cayenne-server-4.0.B1.jar</span> - contains + this file.</p></li><li class="listitem"><p><span class="italic">cayenne-server-4.0.B2.jar</span> - contains main Cayenne runtime (adapters, DB access classes, etc.). Most applications - will require this file.</p></li><li class="listitem"><p><span class="emphasis"><em>cayenne-client-4.0.B1.jar</em></span> - a + will require this file.</p></li><li class="listitem"><p><span class="emphasis"><em>cayenne-client-4.0.B2.jar</em></span> - a client-side runtime for <a class="link" href="introduction-to-rop.html" title="Chapter 13. Introduction to ROP">ROP applications</a>.</p></li><li class="listitem"><p>Other cayenne-* jars - various Cayenne tools extensions.</p></li></ul></div><p> - </p></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="d0e424"></a>Dependencies</h2></div></div></div><p>With modern build tools like Maven and Gradle, you should not worry about tracking + </p></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="d0e435"></a>Dependencies</h2></div></div></div><p>With modern build tools like Maven and Gradle, you should not worry about tracking dependencies. If you have one of those, you can skip this section and go straight to the Maven section below. However if your environment requires manual dependency resolution (like Ant), the distribution provides all of Cayenne jars plus a minimal set of @@ -31,7 +31,7 @@ POM:</p><pre class="programlisting"><span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><dependency></span> <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><groupId></span>org.apache.cayenne<span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"></groupId></span> <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><artifactId></span>cayenne-server<span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"></artifactId></span> - <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><version></span>4.0.B1<span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"></version></span> + <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><version></span>4.0.B2<span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"></version></span> <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"></dependency></span></pre><p>Additionally Cayenne provides a Maven plugin with a set of goals to perform various project tasks, such as synching generated Java classes with the mapping, described in the following subsection. The full plugin name is @@ -56,7 +56,7 @@ generation. E.g. <code class="code">${project.basedir}/src/main/resources/my.map.xml</code></td> </tr></tbody></table></div></div><p><br class="table-break"> - </p><div class="table"><a name="d0e504"></a><p class="title"><b>Table 4.2. cgen optional parameters</b></p><div class="table-contents"><table frame="void"><col width="14%"><col width="7%"><col width="79%"><thead><tr> + </p><div class="table"><a name="d0e515"></a><p class="title"><b>Table 4.2. cgen optional parameters</b></p><div class="table-contents"><table frame="void"><col width="14%"><col width="7%"><col width="79%"><thead><tr> <th>Name</th> <th>Type</th> <th>Description</th> @@ -162,7 +162,7 @@ package:</p><pre class="programlisting"><span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><plugin></span> <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><groupId></span>org.apache.cayenne.plugins<span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"></groupId></span> <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><artifactId></span>cayenne-maven-plugin<span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"></artifactId></span> - <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><version></span>4.0.B1<span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"></version></span> + <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><version></span>4.0.B2<span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"></version></span> <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><configuration></span> <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><map></span>${project.basedir}/src/main/resources/my.map.xml<span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"></map></span> @@ -196,7 +196,7 @@ <td>An object that contains Data Source parameters</td> </tr></tbody></table></div></div><p><br class="table-break"> </p><p> - </p><div class="table"><a name="d0e779"></a><p class="title"><b>Table 4.4. <dataSource> parameters</b></p><div class="table-contents"><table frame="void"><col width="14%"><col width="7%"><col width="7%"><col width="72%"><thead><tr> + </p><div class="table"><a name="d0e790"></a><p class="title"><b>Table 4.4. <dataSource> parameters</b></p><div class="table-contents"><table frame="void"><col width="14%"><col width="7%"><col width="7%"><col width="72%"><thead><tr> <th>Name</th> <th>Type</th> <th>Required</th> @@ -223,7 +223,7 @@ <td>Database user password.</td> </tr></tbody></table></div></div><p><br class="table-break"> </p><p> - </p><div class="table"><a name="d0e865"></a><p class="title"><b>Table 4.5. cdbgen optional parameters</b></p><div class="table-contents"><table frame="void"><col width="14%"><col width="7%"><col width="79%"><thead><tr> + </p><div class="table"><a name="d0e876"></a><p class="title"><b>Table 4.5. cdbgen optional parameters</b></p><div class="table-contents"><table frame="void"><col width="14%"><col width="7%"><col width="79%"><thead><tr> <th>Name</th> <th>Type</th> <th>Description</th> @@ -263,7 +263,7 @@ database:</p><pre class="programlisting"><span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><plugin></span> <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><groupId></span>org.apache.cayenne.plugins<span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"></groupId></span> <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><artifactId></span>cayenne-maven-plugin<span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"></artifactId></span> - <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><version></span>4.0.B1<span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"></version></span> + <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><version></span>4.0.B2<span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"></version></span> <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><executions></span> <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><execution></span> <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><configuration></span> @@ -327,7 +327,7 @@ be processed. For full information about this parameter see <a class="link" href="re-introduction.html" title="Chapter 19. Introduction">"DB-First Flow"</a> chapter.</td> </tr></tbody></table></div></div><p><br class="table-break"> </p><p> - </p><div class="table"><a name="d0e1071"></a><p class="title"><b>Table 4.7. <dataSource> parameters</b></p><div class="table-contents"><table frame="void"><col width="14%"><col width="7%"><col width="7%"><col width="72%"><thead><tr> + </p><div class="table"><a name="d0e1082"></a><p class="title"><b>Table 4.7. <dataSource> parameters</b></p><div class="table-contents"><table frame="void"><col width="14%"><col width="7%"><col width="7%"><col width="72%"><thead><tr> <th>Name</th> <th>Type</th> <th>Required</th> @@ -354,7 +354,7 @@ <td>Database user password.</td> </tr></tbody></table></div></div><p><br class="table-break"> </p><p> - </p><div class="table"><a name="d0e1157"></a><p class="title"><b>Table 4.8. <dbimport> parameters</b></p><div class="table-contents"><table frame="void"><col width="14%"><col width="7%"><col width="79%"><thead><tr> + </p><div class="table"><a name="d0e1168"></a><p class="title"><b>Table 4.8. <dbimport> parameters</b></p><div class="table-contents"><table frame="void"><col width="14%"><col width="7%"><col width="79%"><thead><tr> <th>Name</th> <th>Type</th> <th>Description</th> @@ -450,7 +450,7 @@ :</p><pre class="programlisting"><span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><plugin></span> <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><groupId></span>org.apache.cayenne.plugins<span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"></groupId></span> <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><artifactId></span>cayenne-maven-plugin<span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"></artifactId></span> - <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><version></span>4.0.B1<span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"></version></span> + <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><version></span>4.0.B2<span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"></version></span> <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><executions></span> <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-tag"><execution></span> @@ -474,7 +474,7 @@ To include Cayenne into your Gradle project you have two options: </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p> Simply add Cayenne as a dependency: - </p><pre class="programlisting">compile 'org.apache.cayenne:cayenne-server:4.0.B1'</pre><p> + </p><pre class="programlisting">compile 'org.apache.cayenne:cayenne-server:4.0.B2'</pre><p> </p></li><li class="listitem"><p>Or you can use Cayenne Gradle plugin</p></li></ul></div><p> </p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a name="gradle-plugin"></a>Gradle Plugin</h3></div></div></div><p> Cayenne Gradle plugin provides several tasks, such as synching generated Java classes with the mapping @@ -489,7 +489,7 @@ buildscript { } // add Cayenne Gradle Plugin dependencies { - classpath group: 'org.apache.cayenne.plugins', name: 'cayenne-gradle-plugin', version: '4.0.B1' + classpath group: 'org.apache.cayenne.plugins', name: 'cayenne-gradle-plugin', version: '4.0.B2' } } @@ -509,7 +509,7 @@ dependencies { </p><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3> Cayenne Gradle plugin is experimental and it's API can change later. </div><p> - </p><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="d0e1395"></a>cgen</h4></div></div></div><p> + </p><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="d0e1406"></a>cgen</h4></div></div></div><p> Cgen task generates Java classes based on your DataMap, it has same configuration parameters as in Maven Plugin version, described in <a class="xref" href="including-cayenne-in-project.html#cgen_params_table" title="Table 4.1. cgen required parameters">Table 4.1, “cgen required parameters”</a>. @@ -530,7 +530,7 @@ cgen { task clientCgen(type: cayenne.cgen) { client = true }</pre><p> - </p></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="d0e1419"></a>cdbimport</h4></div></div></div><p> + </p></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="d0e1430"></a>cdbimport</h4></div></div></div><p> This task is for creating and synchronizing your Cayenne model from database schema. Full list of parameters are same as in Maven Plugin version, described in <a class="xref" href="including-cayenne-in-project.html#cdbimport_parameters" title="Table 4.6. cdbimport parameters">Table 4.6, “cdbimport parameters”</a>, with exception that Gradle version will use Groovy instead @@ -592,7 +592,7 @@ cdbimport { tableTypes 'TABLE', 'VIEW' } }</pre><p> - </p></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="d0e1431"></a>cdbgen</h4></div></div></div><p> + </p></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="d0e1442"></a>cdbgen</h4></div></div></div><p> Cdbgen task drops and/or generates tables in a database on Cayenne DataMap. Full list of parameters are same as in Maven Plugin version, described in <a class="xref" href="including-cayenne-in-project.html#cdbgen_parameters" title="Table 4.3. cdbgen required parameters">Table 4.3, “cdbgen required parameters”</a> @@ -617,7 +617,7 @@ cdbgen { createPk true createFk true }</pre><p> - </p></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="d0e1446"></a>Link tasks to Gradle build lifecycle</h4></div></div></div><p> + </p></div><div class="section"><div class="titlepage"><div><div><h4 class="title"><a name="d0e1457"></a>Link tasks to Gradle build lifecycle</h4></div></div></div><p> With gradle you can easily connect Cayenne tasks to default build lifecycle. Here is short example of how to connect defaut <code class="code">cgen</code> and <code class="code">cdbimport</code> tasks with <code class="code">compileJava</code> task:
Modified: cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/index.html URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/index.html?rev=1811298&r1=1811297&r2=1811298&view=diff ============================================================================== --- cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/index.html (original) +++ cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/index.html Fri Oct 6 07:40:21 2017 @@ -9,7 +9,7 @@ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); })(); - </script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div xmlns:d="http://docbook.org/ns/docbook"; class="navheader"><table width="100%" summary="Navigation header"><tr><th class="versioninfo">v.4.0 (4.0.B1)</th><th align="center">Cayenne Guide</th><th></th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="cayenne-guide-part1.html">Next</a></td></tr></table><hr></div><div class="book"><div class="titlepage"><div><div><h1 class="title"><a name="cayenne-guide"></a>Cayenne Guide</h1></div><div><p class="copyright">Copyright © 2011-2017 Apache Software Foundation and individual authors</p></div><div><div class="legalnotice"><a name="d0e12"></a><p class="legalnotice-title"><b>License</b></p><p>Licensed to the Apache Software Foundation (ASF) under one or more contributor + </script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div xmlns:d="http://docbook.org/ns/docbook"; class="navheader"><table width="100%" summary="Navigation header"><tr><th class="versioninfo">v.4.0 (4.0.B2)</th><th align="center">Cayenne Guide</th><th></th></tr><tr><td width="20%" align="left"> </td><th width="60%" align="center"> </th><td width="20%" align="right"> <a accesskey="n" href="cayenne-guide-part1.html">Next</a></td></tr></table><hr></div><div class="book"><div class="titlepage"><div><div><h1 class="title"><a name="cayenne-guide"></a>Cayenne Guide</h1></div><div><p class="copyright">Copyright © 2011-2017 Apache Software Foundation and individual authors</p></div><div><div class="legalnotice"><a name="d0e12"></a><p class="legalnotice-title"><b>License</b></p><p>Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in @@ -17,4 +17,4 @@ http://www.apache.org/licenses/LICENSE-2.0</p><p>Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific - language governing permissions and limitations under the License.</p></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="part"><a href="cayenne-guide-part1.html">I. Object Relational Mapping with Cayenne</a></span></dt><dd><dl><dt><span class="chapter"><a href="setup.html">1. Setup</a></span></dt><dd><dl><dt><span class="section"><a href="setup.html#system-requirements">System Requirements</a></span></dt><dt><span class="section"><a href="setup.html#running-cayennemodeler">Running CayenneModeler</a></span></dt></dl></dd><dt><span class="chapter"><a href="cayenne-mapping-structure.html">2. Cayenne Mapping Structure</a></span></dt><dd><dl><dt><span class="section"><a href="cayenne-mapping-structure.html#cayenne-project">Cayenne Project</a></span></dt><dt><span class="section"><a href="cayenne-mapping-structure.html#datamap">DataMap</a></span></dt><dt><span class="section"><a href="cayenne-mapping-structure.html#d atanode">DataNode</a></span></dt><dt><span class="section"><a href="cayenne-mapping-structure.html#dbentity">DbEntity</a></span></dt><dt><span class="section"><a href="cayenne-mapping-structure.html#objentity">ObjEntity</a></span></dt><dt><span class="section"><a href="cayenne-mapping-structure.html#embeddable">Embeddable</a></span></dt><dt><span class="section"><a href="cayenne-mapping-structure.html#procedure">Procedure</a></span></dt><dt><span class="section"><a href="cayenne-mapping-structure.html#query">Query</a></span></dt></dl></dd><dt><span class="chapter"><a href="cayennemodeler-application.html">3. CayenneModeler Application</a></span></dt><dd><dl><dt><span class="section"><a href="cayennemodeler-application.html#working-with-mapping-projects">Working with Mapping Projects</a></span></dt><dt><span class="section"><a href="cayennemodeler-application.html#reverse-engineering-database">Reverse Engineering Database</a></span></dt><dt><span class="section"><a href="cayennemodel er-application.html#generating-database-schema">Generating Database Schema</a></span></dt><dt><span class="section"><a href="cayennemodeler-application.html#migrations">Migrations</a></span></dt><dt><span class="section"><a href="cayennemodeler-application.html#generating-java-classes">Generating Java Classes</a></span></dt><dt><span class="section"><a href="cayennemodeler-application.html#modeling-inheritance">Modeling Inheritance</a></span></dt><dt><span class="section"><a href="cayennemodeler-application.html#modeling-generic-persistence-classes">Modeling Generic Persistent Classes</a></span></dt><dt><span class="section"><a href="cayennemodeler-application.html#mapping-objattributes-to-custom-classes">Mapping ObjAttributes to Custom Classes</a></span></dt><dt><span class="section"><a href="cayennemodeler-application.html#modeling-pk-generation-strategy">Modeling Primary Key Generation Strategy</a></span></dt></dl></dd></dl></dd><dt><span class="part"><a href="cayenne-guide-part2 .html">II. Cayenne Framework</a></span></dt><dd><dl><dt><span class="chapter"><a href="including-cayenne-in-project.html">4. Including Cayenne in a Project</a></span></dt><dd><dl><dt><span class="section"><a href="including-cayenne-in-project.html#jar-files-and-depdendencies">Jar Files</a></span></dt><dt><span class="section"><a href="including-cayenne-in-project.html#d0e424">Dependencies</a></span></dt><dt><span class="section"><a href="including-cayenne-in-project.html#maven-projects">Maven Projects</a></span></dt><dt><span class="section"><a href="including-cayenne-in-project.html#gradle-projects">Gradle Projects</a></span></dt><dt><span class="section"><a href="including-cayenne-in-project.html#ant-projects">Ant Projects</a></span></dt></dl></dd><dt><span class="chapter"><a href="starting-cayenne.html">5. Starting Cayenne</a></span></dt><dd><dl><dt><span class="section"><a href="starting-cayenne.html#starting-serverruntime">Starting and Stopping ServerRuntime</a></span></dt><dt> <span class="section"><a href="starting-cayenne.html#d0e1518">Merging Multiple Projects</a></span></dt><dt><span class="section"><a href="starting-cayenne.html#webapps">Web Applications</a></span></dt></dl></dd><dt><span class="chapter"><a href="persistent-objects-objectcontext.html">6. Persistent Objects and ObjectContext</a></span></dt><dd><dl><dt><span class="section"><a href="persistent-objects-objectcontext.html#objectcontext">ObjectContext</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#persistent-lifecycle">Persistent Object and its Lifecycle</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#persistent-operations">ObjectContext Persistence API</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#cayenne-helper-class">Cayenne Helper Class</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#objectcontext-nesting">ObjectContext Nest ing</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#generic-persistent-objects">Generic Persistent Objects</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#transactions">Transactions</a></span></dt></dl></dd><dt><span class="chapter"><a href="expressions.html">7. Expressions</a></span></dt><dd><dl><dt><span class="section"><a href="expressions.html#expressions-overview">Expressions Overview</a></span></dt><dt><span class="section"><a href="expressions.html#path-expressions">Path Expressions</a></span></dt><dt><span class="section"><a href="expressions.html#expressions-from-strings">Creating Expressions from Strings </a></span></dt><dt><span class="section"><a href="expressions.html#expressions-with-expressionfactory">Creating Expressions via API</a></span></dt><dt><span class="section"><a href="expressions.html#expressions-in-memory">Evaluating Expressions in Memory</a></span></dt><dt><span class="section "><a href="expressions.html#expressions-to-ejbql">Translating Expressions to EJBQL</a></span></dt></dl></dd><dt><span class="chapter"><a href="orderings.html">8. Orderings</a></span></dt><dt><span class="chapter"><a href="queries.html">9. Queries</a></span></dt><dd><dl><dt><span class="section"><a href="queries.html#selectquery">ObjectSelect</a></span></dt><dt><span class="section"><a href="queries.html#ejbqlquery">EJBQLQuery</a></span></dt><dt><span class="section"><a href="queries.html#sqltemplate">SQLTemplate</a></span></dt><dt><span class="section"><a href="queries.html#procedurequery">ProcedureQuery</a></span></dt><dt><span class="section"><a href="queries.html#namedquery">NamedQuery</a></span></dt><dt><span class="section"><a href="queries.html#custom-queries">Custom Queries</a></span></dt></dl></dd><dt><span class="chapter"><a href="lifecycle-events.html">10. Lifecycle Events</a></span></dt><dd><dl><dt><span class="section"><a href="lifecycle-events.html#types-of-lifecycle-ev ents">Types of Lifecycle Events</a></span></dt><dt><span class="section"><a href="lifecycle-events.html#callback-persistent">Callbacks on Persistent Objects</a></span></dt><dt><span class="section"><a href="lifecycle-events.html#callback-non-persistent">Callbacks on Non-Persistent Listeners</a></span></dt><dt><span class="section"><a href="lifecycle-events.html#comining-listeners-with-datachannelfilters">Combining Listeners with DataChannelFilters</a></span></dt></dl></dd><dt><span class="chapter"><a href="performance-tuning.html">11. Performance Tuning</a></span></dt><dd><dl><dt><span class="section"><a href="performance-tuning.html#prefetching">Prefetching</a></span></dt><dt><span class="section"><a href="performance-tuning.html#datarows">Data Rows</a></span></dt><dt><span class="section"><a href="performance-tuning.html#specific-attributes-with-ejbql">Specific Attributes and Relationships with EJBQL</a></span></dt><dt><span class="section"><a href="performance-tuning.html#iterate d-queries">Iterated Queries</a></span></dt><dt><span class="section"><a href="performance-tuning.html#paginated-queries">Paginated Queries</a></span></dt><dt><span class="section"><a href="performance-tuning.html#caching-and-fresh-data">Caching and Fresh Data</a></span></dt><dt><span class="section"><a href="performance-tuning.html#turning-off-synchronization-of-objectcontexts">Turning off Synchronization of ObjectContexts</a></span></dt></dl></dd><dt><span class="chapter"><a href="customizing-cayenne-runtime.html">12. Customizing Cayenne Runtime</a></span></dt><dd><dl><dt><span class="section"><a href="customizing-cayenne-runtime.html#depdendency-injection-container">Dependency Injection Container</a></span></dt><dt><span class="section"><a href="customizing-cayenne-runtime.html#ways-to-customize-runtime"> Customization Strategies</a></span></dt><dt><span class="section"><a href="customizing-cayenne-runtime.html#extendedtypes">Extended Types</a></span></dt><dt><span class="section" ><a >href="customizing-cayenne-runtime.html#noteworthy-runtime-components">Noteworthy > Built-in Services</a></span></dt></dl></dd></dl></dd><dt><span >class="part"><a href="cayenne-guide-part3.html">III. Cayenne Framework - >Remote Object Persistence </a></span></dt><dd><dl><dt><span >class="chapter"><a href="introduction-to-rop.html">13. Introduction to >ROP</a></span></dt><dd><dl><dt><span class="section"><a >href="introduction-to-rop.html#what-is-rop">What is >ROP</a></span></dt><dt><span class="section"><a >href="introduction-to-rop.html#main-features">Main >Features</a></span></dt></dl></dd><dt><span class="chapter"><a >href="rop-setup.html">14. ROP Setup</a></span></dt><dd><dl><dt><span >class="section"><a href="rop-setup.html#rop-system-requirements">System >Requirements</a></span></dt><dt><span class="section"><a >href="rop-setup.html#rop-jar-files-dependencies">Jar Files and >Dependencies</a></span></dt></dl></dd><dt><span class="chapter"><a >href="implementing-rop-server.html">15. Impleme nting ROP Server</a></span></dt><dt><span class="chapter"><a href="implementing-rop-client.html">16. Implementing ROP Client</a></span></dt><dt><span class="chapter"><a href="rop-deployment.html">17. ROP Deployment</a></span></dt><dd><dl><dt><span class="section"><a href="rop-deployment.html#deploying-rop-server">Deploying ROP Server</a></span></dt><dt><span class="section"><a href="rop-deployment.html#deploying-rop-client">Deploying ROP Client</a></span></dt><dt><span class="section"><a href="rop-deployment.html#rop-security">Security</a></span></dt></dl></dd><dt><span class="chapter"><a href="current-limitations.html">18. Current Limitations</a></span></dt></dl></dd><dt><span class="part"><a href="cayenne-guide-part4.html">IV. DB-First Flow</a></span></dt><dd><dl><dt><span class="chapter"><a href="re-introduction.html">19. Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="re-introduction.html#what-is-cdbimport">"DB-first" Flow</a></span></dt><dt><span class="s ection"><a href="re-introduction.html#re-configuration-file">Introduction to "cdbimport"</a></span></dt></dl></dd><dt><span class="chapter"><a href="re-filtering.html">20. Filtering</a></span></dt><dd><dl><dt><span class="section"><a href="re-filtering.html#everything-schema-catalog">Process everything from schema/catalog</a></span></dt><dt><span class="section"><a href="re-filtering.html#combine-schema-catalog">Combine Schema and Catalog filters</a></span></dt><dt><span class="section"><a href="re-filtering.html#including-excluding-tables-columns-procedures">Including and Excluding tables, columns and procedures</a></span></dt><dt><span class="section"><a href="re-filtering.html#complete-filtering-example">Complete filtering example</a></span></dt><dt><span class="section"><a href="re-filtering.html#d0e3620">Ant configuration example</a></span></dt></dl></dd><dt><span class="chapter"><a href="re-relationships-loading-control.html">21. Other Settings</a></span></dt><dd><dl><dt><span class="section"><a href="re-relationships-loading-control.html#skip-relationships-loading">Skip Relationships Loading</a></span></dt><dt><span class="section"><a href="re-relationships-loading-control.html#skip-pk-loading">Skip Primary Keys Loading</a></span></dt><dt><span class="section"><a href="re-relationships-loading-control.html#d0e3666">Table Types</a></span></dt></dl></dd><dt><span class="chapter"><a href="re-modeler.html">22. Reverse Engineering in Cayenne Modeler</a></span></dt><dd><dl><dt><span class="section"><a href="re-modeler.html#modeler-re-datasource">DataSource selection</a></span></dt><dt><span class="section"><a href="re-modeler.html#modeler-re-options">Reverse engineering options</a></span></dt></dl></dd></dl></dd><dt><span class="appendix"><a href="configuration-properties.html">A. Configuration Properties</a></span></dt><dt><span class="appendix"><a href="service-collections.html">B. Service Collections</a></span></dt><dt><span class="appendix"><a href="expre ssions-bnf.html">C. Expressions BNF</a></span></dt></dl></div><div class="list-of-tables"><p><b>List of Tables</b></p><dl><dt>1.1. <a href="setup.html#d0e38">Cayenne Version History</a></dt><dt>1.2. <a href="setup.html#d0e171">modeler plugin parameters</a></dt><dt>4.1. <a href="including-cayenne-in-project.html#cgen_params_table">cgen required parameters</a></dt><dt>4.2. <a href="including-cayenne-in-project.html#d0e504">cgen optional parameters</a></dt><dt>4.3. <a href="including-cayenne-in-project.html#cdbgen_parameters">cdbgen required parameters</a></dt><dt>4.4. <a href="including-cayenne-in-project.html#d0e779"><dataSource> parameters</a></dt><dt>4.5. <a href="including-cayenne-in-project.html#d0e865">cdbgen optional parameters</a></dt><dt>4.6. <a href="including-cayenne-in-project.html#cdbimport_parameters">cdbimport parameters</a></dt><dt>4.7. <a href="including-cayenne-in-project.html#d0e1071"><dataSource> parameters</a></dt><dt>4.8. <a href="including-cayenne-in -project.html#d0e1157"><dbimport> parameters</a></dt><dt>6.1. <a href="persistent-objects-objectcontext.html#d0e1617">Persistence States</a></dt><dt>10.1. <a href="lifecycle-events.html#d0e2596">Lifecycle Event Types</a></dt><dt>A.1. <a href="configuration-properties.html#d0e3820">Configuration Properties Recognized by ServerRuntime and/or ClientRuntime</a></dt><dt>B.1. <a href="service-collections.html#d0e4094">Service Collection Keys Present in ServerRuntime and/or ClientRuntime</a></dt></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="cayenne-guide-part1.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"> </td><td width="40%" align="right" valign="top"> Part I. Object Relational Mapping with Cayenne</td></tr></ table></div></body></html> \ No newline at end of file + language governing permissions and limitations under the License.</p></div></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="part"><a href="cayenne-guide-part1.html">I. Object Relational Mapping with Cayenne</a></span></dt><dd><dl><dt><span class="chapter"><a href="setup.html">1. Setup</a></span></dt><dd><dl><dt><span class="section"><a href="setup.html#system-requirements">System Requirements</a></span></dt><dt><span class="section"><a href="setup.html#running-cayennemodeler">Running CayenneModeler</a></span></dt></dl></dd><dt><span class="chapter"><a href="cayenne-mapping-structure.html">2. Cayenne Mapping Structure</a></span></dt><dd><dl><dt><span class="section"><a href="cayenne-mapping-structure.html#cayenne-project">Cayenne Project</a></span></dt><dt><span class="section"><a href="cayenne-mapping-structure.html#datamap">DataMap</a></span></dt><dt><span class="section"><a href="cayenne-mapping-structure.html#d atanode">DataNode</a></span></dt><dt><span class="section"><a href="cayenne-mapping-structure.html#dbentity">DbEntity</a></span></dt><dt><span class="section"><a href="cayenne-mapping-structure.html#objentity">ObjEntity</a></span></dt><dt><span class="section"><a href="cayenne-mapping-structure.html#embeddable">Embeddable</a></span></dt><dt><span class="section"><a href="cayenne-mapping-structure.html#procedure">Procedure</a></span></dt><dt><span class="section"><a href="cayenne-mapping-structure.html#query">Query</a></span></dt></dl></dd><dt><span class="chapter"><a href="cayennemodeler-application.html">3. CayenneModeler Application</a></span></dt><dd><dl><dt><span class="section"><a href="cayennemodeler-application.html#working-with-mapping-projects">Working with Mapping Projects</a></span></dt><dt><span class="section"><a href="cayennemodeler-application.html#reverse-engineering-database">Reverse Engineering Database</a></span></dt><dt><span class="section"><a href="cayennemodel er-application.html#generating-database-schema">Generating Database Schema</a></span></dt><dt><span class="section"><a href="cayennemodeler-application.html#migrations">Migrations</a></span></dt><dt><span class="section"><a href="cayennemodeler-application.html#generating-java-classes">Generating Java Classes</a></span></dt><dt><span class="section"><a href="cayennemodeler-application.html#modeling-inheritance">Modeling Inheritance</a></span></dt><dt><span class="section"><a href="cayennemodeler-application.html#modeling-generic-persistence-classes">Modeling Generic Persistent Classes</a></span></dt><dt><span class="section"><a href="cayennemodeler-application.html#mapping-objattributes-to-custom-classes">Mapping ObjAttributes to Custom Classes</a></span></dt><dt><span class="section"><a href="cayennemodeler-application.html#modeling-pk-generation-strategy">Modeling Primary Key Generation Strategy</a></span></dt></dl></dd></dl></dd><dt><span class="part"><a href="cayenne-guide-part2 .html">II. Cayenne Framework</a></span></dt><dd><dl><dt><span class="chapter"><a href="including-cayenne-in-project.html">4. Including Cayenne in a Project</a></span></dt><dd><dl><dt><span class="section"><a href="including-cayenne-in-project.html#jar-files-and-depdendencies">Jar Files</a></span></dt><dt><span class="section"><a href="including-cayenne-in-project.html#d0e435">Dependencies</a></span></dt><dt><span class="section"><a href="including-cayenne-in-project.html#maven-projects">Maven Projects</a></span></dt><dt><span class="section"><a href="including-cayenne-in-project.html#gradle-projects">Gradle Projects</a></span></dt><dt><span class="section"><a href="including-cayenne-in-project.html#ant-projects">Ant Projects</a></span></dt></dl></dd><dt><span class="chapter"><a href="starting-cayenne.html">5. Starting Cayenne</a></span></dt><dd><dl><dt><span class="section"><a href="starting-cayenne.html#starting-serverruntime">Starting and Stopping ServerRuntime</a></span></dt><dt> <span class="section"><a href="starting-cayenne.html#d0e1529">Merging Multiple Projects</a></span></dt><dt><span class="section"><a href="starting-cayenne.html#webapps">Web Applications</a></span></dt></dl></dd><dt><span class="chapter"><a href="persistent-objects-objectcontext.html">6. Persistent Objects and ObjectContext</a></span></dt><dd><dl><dt><span class="section"><a href="persistent-objects-objectcontext.html#objectcontext">ObjectContext</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#persistent-lifecycle">Persistent Object and its Lifecycle</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#persistent-operations">ObjectContext Persistence API</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#cayenne-helper-class">Cayenne Helper Class</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#objectcontext-nesting">ObjectContext Nest ing</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#generic-persistent-objects">Generic Persistent Objects</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#transactions">Transactions</a></span></dt></dl></dd><dt><span class="chapter"><a href="expressions.html">7. Expressions</a></span></dt><dd><dl><dt><span class="section"><a href="expressions.html#expressions-overview">Expressions Overview</a></span></dt><dt><span class="section"><a href="expressions.html#path-expressions">Path Expressions</a></span></dt><dt><span class="section"><a href="expressions.html#expressions-from-strings">Creating Expressions from Strings </a></span></dt><dt><span class="section"><a href="expressions.html#expressions-with-expressionfactory">Creating Expressions via API</a></span></dt><dt><span class="section"><a href="expressions.html#expressions-in-memory">Evaluating Expressions in Memory</a></span></dt><dt><span class="section "><a href="expressions.html#expressions-to-ejbql">Translating Expressions to EJBQL</a></span></dt></dl></dd><dt><span class="chapter"><a href="orderings.html">8. Orderings</a></span></dt><dt><span class="chapter"><a href="queries.html">9. Queries</a></span></dt><dd><dl><dt><span class="section"><a href="queries.html#selectquery">ObjectSelect</a></span></dt><dt><span class="section"><a href="queries.html#ejbqlquery">EJBQLQuery</a></span></dt><dt><span class="section"><a href="queries.html#selectbyid">SelectById</a></span></dt><dt><span class="section"><a href="queries.html#sqlselect">SQLSelect and SQLExec</a></span></dt><dt><span class="section"><a href="queries.html#mappedqueries">MappedSelect and MappedExec</a></span></dt><dt><span class="section"><a href="queries.html#procedurecallquery">ProcedureCall</a></span></dt><dt><span class="section"><a href="queries.html#custom-queries">Custom Queries</a></span></dt><dt><span class="section"><a href="queries.html#sqltemplate">SQLTemplate< /a></span></dt></dl></dd><dt><span class="chapter"><a href="lifecycle-events.html">10. Lifecycle Events</a></span></dt><dd><dl><dt><span class="section"><a href="lifecycle-events.html#types-of-lifecycle-events">Types of Lifecycle Events</a></span></dt><dt><span class="section"><a href="lifecycle-events.html#callback-persistent">Callbacks on Persistent Objects</a></span></dt><dt><span class="section"><a href="lifecycle-events.html#callback-non-persistent">Callbacks on Non-Persistent Listeners</a></span></dt><dt><span class="section"><a href="lifecycle-events.html#comining-listeners-with-datachannelfilters">Combining Listeners with DataChannelFilters</a></span></dt></dl></dd><dt><span class="chapter"><a href="performance-tuning.html">11. Performance Tuning</a></span></dt><dd><dl><dt><span class="section"><a href="performance-tuning.html#prefetching">Prefetching</a></span></dt><dt><span class="section"><a href="performance-tuning.html#datarows">Data Rows</a></span></dt><dt><span class= "section"><a href="performance-tuning.html#specific-attributes-with-ejbql">Specific Attributes and Relationships with EJBQL</a></span></dt><dt><span class="section"><a href="performance-tuning.html#iterated-queries">Iterated Queries</a></span></dt><dt><span class="section"><a href="performance-tuning.html#paginated-queries">Paginated Queries</a></span></dt><dt><span class="section"><a href="performance-tuning.html#caching-and-fresh-data">Caching and Fresh Data</a></span></dt><dt><span class="section"><a href="performance-tuning.html#turning-off-synchronization-of-objectcontexts">Turning off Synchronization of ObjectContexts</a></span></dt></dl></dd><dt><span class="chapter"><a href="customizing-cayenne-runtime.html">12. Customizing Cayenne Runtime</a></span></dt><dd><dl><dt><span class="section"><a href="customizing-cayenne-runtime.html#depdendency-injection-container">Dependency Injection Container</a></span></dt><dt><span class="section"><a href="customizing-cayenne-runtime.html#w ays-to-customize-runtime"> Customization Strategies</a></span></dt><dt><span class="section"><a href="customizing-cayenne-runtime.html#d0e3408">Using custom data types</a></span></dt><dt><span class="section"><a href="customizing-cayenne-runtime.html#noteworthy-runtime-components">Noteworthy Built-in Services</a></span></dt></dl></dd></dl></dd><dt><span class="part"><a href="cayenne-guide-part3.html">III. Cayenne Framework - Remote Object Persistence </a></span></dt><dd><dl><dt><span class="chapter"><a href="introduction-to-rop.html">13. Introduction to ROP</a></span></dt><dd><dl><dt><span class="section"><a href="introduction-to-rop.html#what-is-rop">What is ROP</a></span></dt><dt><span class="section"><a href="introduction-to-rop.html#main-features">Main Features</a></span></dt></dl></dd><dt><span class="chapter"><a href="rop-setup.html">14. ROP Setup</a></span></dt><dd><dl><dt><span class="section"><a href="rop-setup.html#rop-system-requirements">System Requirements</a></span></d t><dt><span class="section"><a href="rop-setup.html#rop-jar-files-dependencies">Jar Files and Dependencies</a></span></dt></dl></dd><dt><span class="chapter"><a href="implementing-rop-server.html">15. Implementing ROP Server</a></span></dt><dt><span class="chapter"><a href="implementing-rop-client.html">16. Implementing ROP Client</a></span></dt><dt><span class="chapter"><a href="rop-deployment.html">17. ROP Deployment</a></span></dt><dd><dl><dt><span class="section"><a href="rop-deployment.html#deploying-rop-server">Deploying ROP Server</a></span></dt><dt><span class="section"><a href="rop-deployment.html#deploying-rop-client">Deploying ROP Client</a></span></dt><dt><span class="section"><a href="rop-deployment.html#rop-security">Security</a></span></dt></dl></dd><dt><span class="chapter"><a href="current-limitations.html">18. Current Limitations</a></span></dt></dl></dd><dt><span class="part"><a href="cayenne-guide-part4.html">IV. DB-First Flow</a></span></dt><dd><dl><dt><span cla ss="chapter"><a href="re-introduction.html">19. Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="re-introduction.html#what-is-cdbimport">"DB-first" Flow</a></span></dt><dt><span class="section"><a href="re-introduction.html#re-configuration-file">Introduction to "cdbimport"</a></span></dt></dl></dd><dt><span class="chapter"><a href="re-filtering.html">20. Filtering</a></span></dt><dd><dl><dt><span class="section"><a href="re-filtering.html#everything-schema-catalog">Process everything from schema/catalog</a></span></dt><dt><span class="section"><a href="re-filtering.html#combine-schema-catalog">Combine Schema and Catalog filters</a></span></dt><dt><span class="section"><a href="re-filtering.html#including-excluding-tables-columns-procedures">Including and Excluding tables, columns and procedures</a></span></dt><dt><span class="section"><a href="re-filtering.html#complete-filtering-example">Complete filtering example</a></span></dt><dt><span class="section"><a h ref="re-filtering.html#d0e3843">Ant configuration example</a></span></dt></dl></dd><dt><span class="chapter"><a href="re-relationships-loading-control.html">21. Other Settings</a></span></dt><dd><dl><dt><span class="section"><a href="re-relationships-loading-control.html#skip-relationships-loading">Skip Relationships Loading</a></span></dt><dt><span class="section"><a href="re-relationships-loading-control.html#skip-pk-loading">Skip Primary Keys Loading</a></span></dt><dt><span class="section"><a href="re-relationships-loading-control.html#d0e3889">Table Types</a></span></dt></dl></dd><dt><span class="chapter"><a href="re-modeler.html">22. Reverse Engineering in Cayenne Modeler</a></span></dt><dd><dl><dt><span class="section"><a href="re-modeler.html#modeler-re-datasource">DataSource selection</a></span></dt><dt><span class="section"><a href="re-modeler.html#modeler-re-options">Reverse engineering options</a></span></dt></dl></dd></dl></dd><dt><span class="part"><a href="cayenne-gui de-part5.html">V. Cayenne Additional Modules</a></span></dt><dd><dl><dt><span class="chapter"><a href="ext-cache-invalidation.html">23. Cache invalidation extension</a></span></dt><dd><dl><dt><span class="section"><a href="ext-cache-invalidation.html#d0e4040">Description</a></span></dt><dt><span class="section"><a href="ext-cache-invalidation.html#d0e4045">Including in a project</a></span></dt><dt><span class="section"><a href="ext-cache-invalidation.html#d0e4064">Usage</a></span></dt></dl></dd><dt><span class="chapter"><a href="ext-commit-log.html">24. Commit log extension</a></span></dt><dd><dl><dt><span class="section"><a href="ext-commit-log.html#d0e4118">Description</a></span></dt><dt><span class="section"><a href="ext-commit-log.html#d0e4123">Including in a project</a></span></dt><dt><span class="section"><a href="ext-commit-log.html#d0e4142">Usage</a></span></dt></dl></dd><dt><span class="chapter"><a href="ext-crypto.html">25. Crypto extension</a></span></dt><dd><dl><dt><span class="section"><a href="ext-crypto.html#d0e4182">Description</a></span></dt><dt><span class="section"><a href="ext-crypto.html#d0e4187">Including in a project</a></span></dt><dt><span class="section"><a href="ext-crypto.html#d0e4206">Usage</a></span></dt></dl></dd><dt><span class="chapter"><a href="ext-dbcp2.html">26. Apache Commons DBCP integration</a></span></dt><dd><dl><dt><span class="section"><a href="ext-dbcp2.html#d0e4323">Description</a></span></dt><dt><span class="section"><a href="ext-dbcp2.html#d0e4328">Including in a project</a></span></dt><dt><span class="section"><a href="ext-dbcp2.html#d0e4347">Usage</a></span></dt></dl></dd><dt><span class="chapter"><a href="ext-java8.html">27. Java 8 extension</a></span></dt><dd><dl><dt><span class="section"><a href="ext-java8.html#d0e4363">Description</a></span></dt><dt><span class="section"><a href="ext-java8.html#d0e4377">Including in a project</a></span></dt><dt><span class="section"><a href="ext-java8.html#d0e4396">Usage</a>< /span></dt></dl></dd><dt><span class="chapter"><a href="ext-jcache.html">28. JCache integration</a></span></dt><dd><dl><dt><span class="section"><a href="ext-jcache.html#d0e4405">Description</a></span></dt><dt><span class="section"><a href="ext-jcache.html#d0e4410">Including in a project</a></span></dt><dt><span class="section"><a href="ext-jcache.html#d0e4429">Usage</a></span></dt></dl></dd><dt><span class="chapter"><a href="ext-joda.html">29. Joda time extension</a></span></dt><dd><dl><dt><span class="section"><a href="ext-joda.html#d0e4454">Description</a></span></dt><dt><span class="section"><a href="ext-joda.html#d0e4471">Including in a project</a></span></dt><dt><span class="section"><a href="ext-joda.html#d0e4490">Usage</a></span></dt></dl></dd></dl></dd><dt><span class="appendix"><a href="configuration-properties.html">A. Configuration Properties</a></span></dt><dt><span class="appendix"><a href="service-collections.html">B. Service Collections</a></span></dt><dt><span class ="appendix"><a href="expressions-bnf.html">C. Expressions BNF</a></span></dt></dl></div><div class="list-of-tables"><p><b>List of Tables</b></p><dl><dt>1.1. <a href="setup.html#d0e38">Cayenne Version History</a></dt><dt>1.2. <a href="setup.html#d0e182">modeler plugin parameters</a></dt><dt>4.1. <a href="including-cayenne-in-project.html#cgen_params_table">cgen required parameters</a></dt><dt>4.2. <a href="including-cayenne-in-project.html#d0e515">cgen optional parameters</a></dt><dt>4.3. <a href="including-cayenne-in-project.html#cdbgen_parameters">cdbgen required parameters</a></dt><dt>4.4. <a href="including-cayenne-in-project.html#d0e790"><dataSource> parameters</a></dt><dt>4.5. <a href="including-cayenne-in-project.html#d0e876">cdbgen optional parameters</a></dt><dt>4.6. <a href="including-cayenne-in-project.html#cdbimport_parameters">cdbimport parameters</a></dt><dt>4.7. <a href="including-cayenne-in-project.html#d0e1082"><dataSource> parameters</a></dt><dt>4.8. <a href="including-cayenne-in-project.html#d0e1168"><dbimport> parameters</a></dt><dt>6.1. <a href="persistent-objects-objectcontext.html#d0e1628">Persistence States</a></dt><dt>10.1. <a href="lifecycle-events.html#d0e2763">Lifecycle Event Types</a></dt><dt>A.1. <a href="configuration-properties.html#d0e4506">Configuration Properties Recognized by ServerRuntime and/or ClientRuntime</a></dt><dt>B.1. <a href="service-collections.html#d0e4780">Service Collection Keys Present in ServerRuntime and/or ClientRuntime</a></dt></dl></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"> </td><td width="20%" align="center"> </td><td width="40%" align="right"> <a accesskey="n" href="cayenne-guide-part1.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"> </td><td width="20%" align="center"> </td><td width="40%" align="right" valign="top"> Part I. Object Relational Mappin g with Cayenne</td></tr></table></div></body></html> \ No newline at end of file Modified: cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/introduction-to-rop.html URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/introduction-to-rop.html?rev=1811298&r1=1811297&r2=1811298&view=diff ============================================================================== --- cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/introduction-to-rop.html (original) +++ cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/introduction-to-rop.html Fri Oct 6 07:40:21 2017 @@ -9,7 +9,7 @@ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); })(); - </script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div xmlns:d="http://docbook.org/ns/docbook"; class="navheader"><table width="100%" summary="Navigation header"><tr><th class="versioninfo">v.4.0 (4.0.B1)</th><th align="center">Chapter 13. Introduction to ROP</th><th></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="cayenne-guide-part3.html">Prev</a> </td><th width="60%" align="center"><a accesskey="u" href="cayenne-guide-part3.html">Part III. Cayenne Framework - Remote Object Persistence </a></th><td width="20%" align="right"> <a accesskey="n" href="rop-setup.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="introduction-to-rop"></a>Chapter 13. Introduction to ROP</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="introduction-to-ro p.html#what-is-rop">What is ROP</a></span></dt><dt><span class="section"><a href="introduction-to-rop.html#main-features">Main Features</a></span></dt></dl></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="what-is-rop"></a>What is ROP</h2></div></div></div><p>"Remote Object Persistence" is a low-overhead web services-based technology that + </script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div xmlns:d="http://docbook.org/ns/docbook"; class="navheader"><table width="100%" summary="Navigation header"><tr><th class="versioninfo">v.4.0 (4.0.B2)</th><th align="center">Chapter 13. Introduction to ROP</th><th></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="cayenne-guide-part3.html">Prev</a> </td><th width="60%" align="center"><a accesskey="u" href="cayenne-guide-part3.html">Part III. Cayenne Framework - Remote Object Persistence </a></th><td width="20%" align="right"> <a accesskey="n" href="rop-setup.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="introduction-to-rop"></a>Chapter 13. Introduction to ROP</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="introduction-to-ro p.html#what-is-rop">What is ROP</a></span></dt><dt><span class="section"><a href="introduction-to-rop.html#main-features">Main Features</a></span></dt></dl></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="what-is-rop"></a>What is ROP</h2></div></div></div><p>"Remote Object Persistence" is a low-overhead web services-based technology that provides lightweight object persistence and query functionality to 'remote' applications. In other words it provides familiar Cayenne API to applications that do not have direct access to the database. Instead such applications would access Cayenne Modified: cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/lifecycle-events.html URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/lifecycle-events.html?rev=1811298&r1=1811297&r2=1811298&view=diff ============================================================================== --- cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/lifecycle-events.html (original) +++ cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/lifecycle-events.html Fri Oct 6 07:40:21 2017 @@ -9,7 +9,7 @@ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); })(); - </script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div xmlns:d="http://docbook.org/ns/docbook"; class="navheader"><table width="100%" summary="Navigation header"><tr><th class="versioninfo">v.4.0 (4.0.B1)</th><th align="center">Chapter 10. Lifecycle Events</th><th></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="queries.html">Prev</a> </td><th width="60%" align="center"><a accesskey="u" href="cayenne-guide-part2.html">Part II. Cayenne Framework</a></th><td width="20%" align="right"> <a accesskey="n" href="performance-tuning.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="lifecycle-events"></a>Chapter 10. Lifecycle Events</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="lifecycle-events.html#types-of-lifecycle-events">Types of Li fecycle Events</a></span></dt><dt><span class="section"><a href="lifecycle-events.html#callback-persistent">Callbacks on Persistent Objects</a></span></dt><dt><span class="section"><a href="lifecycle-events.html#callback-non-persistent">Callbacks on Non-Persistent Listeners</a></span></dt><dt><span class="section"><a href="lifecycle-events.html#comining-listeners-with-datachannelfilters">Combining Listeners with DataChannelFilters</a></span></dt></dl></div><p>An application might be interested in getting notified when a Persistent object moves + </script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div xmlns:d="http://docbook.org/ns/docbook"; class="navheader"><table width="100%" summary="Navigation header"><tr><th class="versioninfo">v.4.0 (4.0.B2)</th><th align="center">Chapter 10. Lifecycle Events</th><th></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="queries.html">Prev</a> </td><th width="60%" align="center"><a accesskey="u" href="cayenne-guide-part2.html">Part II. Cayenne Framework</a></th><td width="20%" align="right"> <a accesskey="n" href="performance-tuning.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="lifecycle-events"></a>Chapter 10. Lifecycle Events</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="lifecycle-events.html#types-of-lifecycle-events">Types of Li fecycle Events</a></span></dt><dt><span class="section"><a href="lifecycle-events.html#callback-persistent">Callbacks on Persistent Objects</a></span></dt><dt><span class="section"><a href="lifecycle-events.html#callback-non-persistent">Callbacks on Non-Persistent Listeners</a></span></dt><dt><span class="section"><a href="lifecycle-events.html#comining-listeners-with-datachannelfilters">Combining Listeners with DataChannelFilters</a></span></dt></dl></div><p>An application might be interested in getting notified when a Persistent object moves through its lifecycle (i.e. fetched from DB, created, modified, committed). E.g. when a new object is created, the application may want to initialize its default properties (this can't be done in constructor, as constructor is also called when an object is fetched from DB). @@ -25,7 +25,7 @@ evnironment outside Cayenne. This power comes from such features as filtering which entity events are sent to a given listener and the ability to create a common operation context for multiple callback invocations. All of these are discussed later in this chapter.</p><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="types-of-lifecycle-events"></a>Types of Lifecycle Events</h2></div></div></div><p>Cayenne defines the following 8 types of lifecycle events for which callbacks can be - regsitered:</p><div class="table"><a name="d0e2596"></a><p class="title"><b>Table 10.1. Lifecycle Event Types</b></p><div class="table-contents"><table frame="void"><col width="16%"><col width="84%"><thead><tr> + regsitered:</p><div class="table"><a name="d0e2763"></a><p class="title"><b>Table 10.1. Lifecycle Event Types</b></p><div class="table-contents"><table frame="void"><col width="16%"><col width="84%"><thead><tr> <th>Event</th> <th>Occurs...</th> </tr></thead><tbody><tr> Modified: cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/orderings.html URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/orderings.html?rev=1811298&r1=1811297&r2=1811298&view=diff ============================================================================== --- cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/orderings.html (original) +++ cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/orderings.html Fri Oct 6 07:40:21 2017 @@ -9,7 +9,7 @@ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); })(); - </script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div xmlns:d="http://docbook.org/ns/docbook"; class="navheader"><table width="100%" summary="Navigation header"><tr><th class="versioninfo">v.4.0 (4.0.B1)</th><th align="center">Chapter 8. Orderings</th><th></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="expressions.html">Prev</a> </td><th width="60%" align="center"><a accesskey="u" href="cayenne-guide-part2.html">Part II. Cayenne Framework</a></th><td width="20%" align="right"> <a accesskey="n" href="queries.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="orderings"></a>Chapter 8. Orderings</h2></div></div></div><p>An Ordering object defines how a list of objects should be ordered. Orderings are + </script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div xmlns:d="http://docbook.org/ns/docbook"; class="navheader"><table width="100%" summary="Navigation header"><tr><th class="versioninfo">v.4.0 (4.0.B2)</th><th align="center">Chapter 8. Orderings</th><th></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="expressions.html">Prev</a> </td><th width="60%" align="center"><a accesskey="u" href="cayenne-guide-part2.html">Part II. Cayenne Framework</a></th><td width="20%" align="right"> <a accesskey="n" href="queries.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="orderings"></a>Chapter 8. Orderings</h2></div></div></div><p>An Ordering object defines how a list of objects should be ordered. Orderings are essentially path expressions combined with a sorting strategy. Creating an Ordering: </p><pre class="programlisting">Ordering o = <span xmlns="http://www.w3.org/1999/xhtml"; class="hl-keyword">new</span> Ordering(Painting.NAME_PROPERTY, SortOrder.ASCENDING);</pre><p>Like expressions, orderings are translated into SQL as parts of queries (and the sorting occurs in the database). Also like expressions, orderings can be used in memory, naturally - Modified: cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/performance-tuning.html URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/performance-tuning.html?rev=1811298&r1=1811297&r2=1811298&view=diff ============================================================================== --- cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/performance-tuning.html (original) +++ cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/performance-tuning.html Fri Oct 6 07:40:21 2017 @@ -9,7 +9,7 @@ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); })(); - </script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div xmlns:d="http://docbook.org/ns/docbook"; class="navheader"><table width="100%" summary="Navigation header"><tr><th class="versioninfo">v.4.0 (4.0.B1)</th><th align="center">Chapter 11. Performance Tuning</th><th></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="lifecycle-events.html">Prev</a> </td><th width="60%" align="center"><a accesskey="u" href="cayenne-guide-part2.html">Part II. Cayenne Framework</a></th><td width="20%" align="right"> <a accesskey="n" href="customizing-cayenne-runtime.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="performance-tuning"></a>Chapter 11. Performance Tuning</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="performance-tuning.html#prefetching" >Prefetching</a></span></dt><dt><span class="section"><a >href="performance-tuning.html#datarows">Data Rows</a></span></dt><dt><span >class="section"><a >href="performance-tuning.html#specific-attributes-with-ejbql">Specific >Attributes and Relationships with EJBQL</a></span></dt><dt><span >class="section"><a href="performance-tuning.html#iterated-queries">Iterated >Queries</a></span></dt><dt><span class="section"><a >href="performance-tuning.html#paginated-queries">Paginated >Queries</a></span></dt><dt><span class="section"><a >href="performance-tuning.html#caching-and-fresh-data">Caching and Fresh >Data</a></span></dt><dt><span class="section"><a >href="performance-tuning.html#turning-off-synchronization-of-objectcontexts">Turning > off Synchronization of ObjectContexts</a></span></dt></dl></div><div >class="section"><div class="titlepage"><div><div><h2 class="title"><a >name="prefetching"></a>Prefetching</h2></div></div></div><p>Prefetching is a >technique that allows to bring back in one query not only the queried + </script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div xmlns:d="http://docbook.org/ns/docbook"; class="navheader"><table width="100%" summary="Navigation header"><tr><th class="versioninfo">v.4.0 (4.0.B2)</th><th align="center">Chapter 11. Performance Tuning</th><th></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="lifecycle-events.html">Prev</a> </td><th width="60%" align="center"><a accesskey="u" href="cayenne-guide-part2.html">Part II. Cayenne Framework</a></th><td width="20%" align="right"> <a accesskey="n" href="customizing-cayenne-runtime.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="performance-tuning"></a>Chapter 11. Performance Tuning</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="performance-tuning.html#prefetching" >Prefetching</a></span></dt><dt><span class="section"><a >href="performance-tuning.html#datarows">Data Rows</a></span></dt><dt><span >class="section"><a >href="performance-tuning.html#specific-attributes-with-ejbql">Specific >Attributes and Relationships with EJBQL</a></span></dt><dt><span >class="section"><a href="performance-tuning.html#iterated-queries">Iterated >Queries</a></span></dt><dt><span class="section"><a >href="performance-tuning.html#paginated-queries">Paginated >Queries</a></span></dt><dt><span class="section"><a >href="performance-tuning.html#caching-and-fresh-data">Caching and Fresh >Data</a></span></dt><dt><span class="section"><a >href="performance-tuning.html#turning-off-synchronization-of-objectcontexts">Turning > off Synchronization of ObjectContexts</a></span></dt></dl></div><div >class="section"><div class="titlepage"><div><div><h2 class="title"><a >name="prefetching"></a>Prefetching</h2></div></div></div><p>Prefetching is a >technique that allows to bring back in one query not only the queried objects, but also objects related to them. In other words it is a controlled eager relationship resolving mechanism. Prefetching is discussed in the "Performance Tuning" chapter, as it is a powerful performance optimization method. However another common Modified: cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/persistent-objects-objectcontext.html URL: http://svn.apache.org/viewvc/cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/persistent-objects-objectcontext.html?rev=1811298&r1=1811297&r2=1811298&view=diff ============================================================================== --- cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/persistent-objects-objectcontext.html (original) +++ cayenne/site/cms/trunk/content/docs/4.0/cayenne-guide/persistent-objects-objectcontext.html Fri Oct 6 07:40:21 2017 @@ -9,7 +9,7 @@ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js'; var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s); })(); - </script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div xmlns:d="http://docbook.org/ns/docbook"; class="navheader"><table width="100%" summary="Navigation header"><tr><th class="versioninfo">v.4.0 (4.0.B1)</th><th align="center">Chapter 6. Persistent Objects and ObjectContext</th><th></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="starting-cayenne.html">Prev</a> </td><th width="60%" align="center"><a accesskey="u" href="cayenne-guide-part2.html">Part II. Cayenne Framework</a></th><td width="20%" align="right"> <a accesskey="n" href="expressions.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="persistent-objects-objectcontext"></a>Chapter 6. Persistent Objects and ObjectContext</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="pers istent-objects-objectcontext.html#objectcontext">ObjectContext</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#persistent-lifecycle">Persistent Object and its Lifecycle</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#persistent-operations">ObjectContext Persistence API</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#cayenne-helper-class">Cayenne Helper Class</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#objectcontext-nesting">ObjectContext Nesting</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#generic-persistent-objects">Generic Persistent Objects</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#transactions">Transactions</a></span></dt></dl></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="objectcontext"></a >ObjectContext</h2></div></div></div><p>ObjectContext is an interface that >users normally work with to access the database. It + </script></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div xmlns:d="http://docbook.org/ns/docbook"; class="navheader"><table width="100%" summary="Navigation header"><tr><th class="versioninfo">v.4.0 (4.0.B2)</th><th align="center">Chapter 6. Persistent Objects and ObjectContext</th><th></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="starting-cayenne.html">Prev</a> </td><th width="60%" align="center"><a accesskey="u" href="cayenne-guide-part2.html">Part II. Cayenne Framework</a></th><td width="20%" align="right"> <a accesskey="n" href="expressions.html">Next</a></td></tr></table><hr></div><div class="chapter"><div class="titlepage"><div><div><h2 class="title"><a name="persistent-objects-objectcontext"></a>Chapter 6. Persistent Objects and ObjectContext</h2></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="section"><a href="pers istent-objects-objectcontext.html#objectcontext">ObjectContext</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#persistent-lifecycle">Persistent Object and its Lifecycle</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#persistent-operations">ObjectContext Persistence API</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#cayenne-helper-class">Cayenne Helper Class</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#objectcontext-nesting">ObjectContext Nesting</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#generic-persistent-objects">Generic Persistent Objects</a></span></dt><dt><span class="section"><a href="persistent-objects-objectcontext.html#transactions">Transactions</a></span></dt></dl></div><div class="section"><div class="titlepage"><div><div><h2 class="title"><a name="objectcontext"></a >ObjectContext</h2></div></div></div><p>ObjectContext is an interface that >users normally work with to access the database. It provides the API to execute database operations and to manage persistent objects. A context is obtained from the ServerRuntime:</p><pre class="programlisting">ObjectContext context = runtime.newContext();</pre><p>The call above creates a new instance of ObjectContext that can access the database via this @@ -39,7 +39,7 @@ equality check of 2 objects, knowing persistence state would allow highlighting changed objects, etc.</p><p>Each persistent object belongs to a single ObjectContext, and can be in one of the following persistence states (as defined in <code class="code">org.apache.cayenne.PersistenceState</code>) - :</p><div class="table"><a name="d0e1617"></a><p class="title"><b>Table 6.1. Persistence States</b></p><div class="table-contents"><table frame="void"><col width="16%"><col width="84%"><tbody><tr> + :</p><div class="table"><a name="d0e1628"></a><p class="title"><b>Table 6.1. Persistence States</b></p><div class="table-contents"><table frame="void"><col width="16%"><col width="84%"><tbody><tr> <td>TRANSIENT</td> <td>The object is not registered with an ObjectContext and will not be persisted.</td>
