You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cayenne.apache.org by aa...@apache.org on 2006/05/10 03:11:01 UTC
svn commit: r405581 [10/14] - in
/incubator/cayenne/main/trunk/cayenne/cayenne-other: docs/ docs/images/
wiki-docs/ wiki-docs/Documentation/ wiki-docs/Documentation/Modeler Guide/
wiki-docs/Documentation/Modeler Guide/Cayenne Project Structure/ wiki-do...
Added: incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Expressions/NULL Handling/index.html
URL: http://svn.apache.org/viewcvs/incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User%20Guide/Expressions/NULL%20Handling/index.html?rev=405581&view=auto
==============================================================================
--- incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Expressions/NULL Handling/index.html (added)
+++ incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Expressions/NULL Handling/index.html Tue May 9 18:10:42 2006
@@ -0,0 +1,58 @@
+<html>
+ <head>
+ <title>Cayenne Documentation - NULL Handling</title>
+ <style type="text/css">@import "../../../../style.css";</style>
+ </head>
+<body>
+ <div class="header">
+ <div style="float: left;"><a href="http://objectstyle.org/cayenne/"><img src="../../../../images/logo.gif" align="absmiddle" border="0"></a></div>
+ <span class="logoSpaceLink"><a href="../../../../index.html">Cayenne User Documentation</a></span><br />
+ <span class="pagetitle">NULL Handling</span>
+ </div>
+<div id="cayenne_toc">
+<ul>
+<li><a href="../../../../Documentation/User Guide/Introduction/index.html">Introduction</a></li>
+<li><a href="../../../../Documentation/User Guide/Installation/index.html">Installation</a></li>
+<li><a href="../../../../Documentation/User Guide/Quick Start/index.html">Quick Start</a></li>
+<li><a href="../../../../Documentation/User Guide/Design/index.html">Design</a></li>
+<li><a href="../../../../Documentation/User Guide/Generating Classes/index.html">Generating Classes</a></li>
+<li><a href="../../../../Documentation/User Guide/DataContext/index.html">DataContext</a></li>
+<li><a href="../../../../Documentation/User Guide/Queries/index.html">Queries</a></li>
+<li><a href="../../../../Documentation/User Guide/DataObjects/index.html">DataObjects</a></li>
+<li><a href="../../../../Documentation/User Guide/Stored Procedures/index.html">Stored Procedures</a></li>
+<li><a href="../../../../Documentation/User Guide/Expressions/index.html">Expressions</a><ul>
+<li><a href="../../../../Documentation/User Guide/Expressions/Building Expressions/index.html">Building Expressions</a></li>
+<li><a href="../../../../Documentation/User Guide/Expressions/Expression Factory Utilities/index.html">Expression Factory Utilities</a></li>
+<li><a href="../../../../Documentation/User Guide/Expressions/In-Memory Evaluation/index.html">In-Memory Evaluation</a></li>
+<li><a href="../../../../Documentation/User Guide/Expressions/NULL Handling/index.html">NULL Handling</a><ul>
+</ul>
+</li>
+<li><a href="../../../../Documentation/User Guide/Expressions/Path Expressions/index.html">Path Expressions</a></li>
+</ul>
+</li>
+<li><a href="../../../../Documentation/User Guide/Performance Tuning/index.html">Performance Tuning</a></li>
+<li><a href="../../../../Documentation/User Guide/Deployment/index.html">Deployment</a></li>
+<li><a href="../../../../Documentation/User Guide/Ant Tasks/index.html">Ant Tasks</a></li>
+<li><a href="../../../../Documentation/User Guide/Access Stack Internals/index.html">Access Stack Internals</a></li>
+<li><a href="../../../../Documentation/User Guide/DataViews/index.html">DataViews</a></li>
+</ul>
+</div>
+<div id="ConfluenceContent"><p>Handling of Java nulls as operands is no different from normal values. Instead of using special conditional operators, like SQL does, EQUAL_TO and NOT_EQUAL_TO expressions can be used directly with null values. It is up to Cayenne to translate expressions with nulls to the valid SQL.</p>
+
+<p>For example:</p>
+
+<div class="code"><div class="codeContent">
+<pre class="code-java"><span class="code-comment">// <span class="code-keyword">this</span> expression will be translated by Cayenne to the SQL like:
+</span><span class="code-comment">// ...WHERE BIRTH_DATE IS NOT NULL
+</span>Expression exp = ExpressionFactory.noMatchExp(<span class="code-quote">"birthDate"</span>, <span class="code-keyword">null</span>);</pre>
+</div></div></div>
+</div>
+ <div class="clearer">.</div>
+ <div style="height: 12px; background-image: url('../../../../images/border_bottom.gif'); background-repeat: repeat-x;"></div>
+
+ <div class="smalltext copyright">
+ Copyright ©2001-2006 ObjectStyle Group and content authors
+ </div>
+
+</body>
+</html>
Propchange: incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Expressions/NULL Handling/index.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Expressions/Path Expressions/index.html
URL: http://svn.apache.org/viewcvs/incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User%20Guide/Expressions/Path%20Expressions/index.html?rev=405581&view=auto
==============================================================================
--- incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Expressions/Path Expressions/index.html (added)
+++ incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Expressions/Path Expressions/index.html Tue May 9 18:10:42 2006
@@ -0,0 +1,80 @@
+<html>
+ <head>
+ <title>Cayenne Documentation - Path Expressions</title>
+ <style type="text/css">@import "../../../../style.css";</style>
+ </head>
+<body>
+ <div class="header">
+ <div style="float: left;"><a href="http://objectstyle.org/cayenne/"><img src="../../../../images/logo.gif" align="absmiddle" border="0"></a></div>
+ <span class="logoSpaceLink"><a href="../../../../index.html">Cayenne User Documentation</a></span><br />
+ <span class="pagetitle">Path Expressions</span>
+ </div>
+<div id="cayenne_toc">
+<ul>
+<li><a href="../../../../Documentation/User Guide/Introduction/index.html">Introduction</a></li>
+<li><a href="../../../../Documentation/User Guide/Installation/index.html">Installation</a></li>
+<li><a href="../../../../Documentation/User Guide/Quick Start/index.html">Quick Start</a></li>
+<li><a href="../../../../Documentation/User Guide/Design/index.html">Design</a></li>
+<li><a href="../../../../Documentation/User Guide/Generating Classes/index.html">Generating Classes</a></li>
+<li><a href="../../../../Documentation/User Guide/DataContext/index.html">DataContext</a></li>
+<li><a href="../../../../Documentation/User Guide/Queries/index.html">Queries</a></li>
+<li><a href="../../../../Documentation/User Guide/DataObjects/index.html">DataObjects</a></li>
+<li><a href="../../../../Documentation/User Guide/Stored Procedures/index.html">Stored Procedures</a></li>
+<li><a href="../../../../Documentation/User Guide/Expressions/index.html">Expressions</a><ul>
+<li><a href="../../../../Documentation/User Guide/Expressions/Building Expressions/index.html">Building Expressions</a></li>
+<li><a href="../../../../Documentation/User Guide/Expressions/Expression Factory Utilities/index.html">Expression Factory Utilities</a></li>
+<li><a href="../../../../Documentation/User Guide/Expressions/In-Memory Evaluation/index.html">In-Memory Evaluation</a></li>
+<li><a href="../../../../Documentation/User Guide/Expressions/NULL Handling/index.html">NULL Handling</a></li>
+<li><a href="../../../../Documentation/User Guide/Expressions/Path Expressions/index.html">Path Expressions</a><ul>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="../../../../Documentation/User Guide/Performance Tuning/index.html">Performance Tuning</a></li>
+<li><a href="../../../../Documentation/User Guide/Deployment/index.html">Deployment</a></li>
+<li><a href="../../../../Documentation/User Guide/Ant Tasks/index.html">Ant Tasks</a></li>
+<li><a href="../../../../Documentation/User Guide/Access Stack Internals/index.html">Access Stack Internals</a></li>
+<li><a href="../../../../Documentation/User Guide/DataViews/index.html">DataViews</a></li>
+</ul>
+</div>
+<div id="ConfluenceContent"><p>Before we start discussing how to build expressions, it is important to understand one group of expressions widely used in Cayenne: path expressions. There are two types of path expressions: object path used to navigate graphs of Java objects that follow Java Bean property naming conventions and database path used to navigate the database schema.</p>
+
+<h3><a name="PathExpressions-ObjectPathExpressions"></a>Object Path Expressions</h3>
+<p>An Object Path Expression is a property navigation path. Such path is represented by a String made of dot-separated names of properties of a Java Bean class. E.g. a path expression "toArtist.artistName" is a valid property path for a Painting class, pointing to the name of the Artist who created a given Painting. A few more examples:</p>
+
+<ul>
+ <li><b>paintingTitle</b><br/>
+ Can be used to navigate to the value of "paintingTitle" property of the Painting class.</li>
+ <li><b>toArtist.exhibitArray.closingDate</b><br/>
+ Can be used to navigate to a closing date of any of the exhibits of a Painting's Artist object.</li>
+</ul>
+
+
+<table cellpadding='5' width='85%' cellspacing='8px' class='infoMacro' border="0" align='center'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="../../../../images/emoticons/information.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td><b class="strong">What Does 'navigation' Means</b><br />The term "navigation" in the description above could mean different things depending on the context. For instance, when evaluating an expression in memory, "navigating" an object path would simply return the value of a corresponding object property. When the same expression is used in a select query qualifier, it resolves to the name of a table column used in a WHERE clause of a generated SQL statement.</td></tr></table>
+
+<h3><a name="PathExpressions-DatabasePathExpressions"></a>Database Path Expressions</h3>
+<p>Database Path Expressions provide an easy way to navigate through DB table joins. Instead of complex join semantics such expressions utilize the names of DbRelationships defined in Cayenne DataMap. Translating the above object path examples into the DB realm, database path expressions might look like this:</p>
+
+<ul>
+ <li><b>PAINTING_TITLE</b><br/>
+ Can be used to match the value of "PAINTING_TITLE" column of a PAINTING table.</li>
+ <li><b>toArtist.artistExhibitArray.toExhibit.CLOSING_DATE</b><br/>
+ Can be used to match a closing date of any of the exhibits of a related artist record.</li>
+</ul>
+
+
+<p>Though database path expressions are widely used by Cayenne framework internally, they are rarely used in applications. There are only a few cases when their explicit use is justified.</p>
+
+<h3><a name="PathExpressions-MatchingPathExpressions"></a>Matching Path Expressions</h3>
+
+<p>As described in the following chapters a path expression is usually matched against some value (see for example <a href="../../../../Documentation/User Guide/Expressions/Expression Factory Utilities/index.html" title="Expression Factory Utilities">ExpressionFactory API</a> - the first argument to each method is a path, and a second - an Object value that is matched against the path). Such value type must be compatible with the type of the property pointed to by the path. E.g. toArtist.artistName can only be matched against a String, and toArtist - against instances of Artist. </p></div>
+</div>
+ <div class="clearer">.</div>
+ <div style="height: 12px; background-image: url('../../../../images/border_bottom.gif'); background-repeat: repeat-x;"></div>
+
+ <div class="smalltext copyright">
+ Copyright ©2001-2006 ObjectStyle Group and content authors
+ </div>
+
+</body>
+</html>
Propchange: incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Expressions/Path Expressions/index.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Expressions/index.html
URL: http://svn.apache.org/viewcvs/incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User%20Guide/Expressions/index.html?rev=405581&view=auto
==============================================================================
--- incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Expressions/index.html (added)
+++ incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Expressions/index.html Tue May 9 18:10:42 2006
@@ -0,0 +1,50 @@
+<html>
+ <head>
+ <title>Cayenne Documentation - Expressions</title>
+ <style type="text/css">@import "../../../style.css";</style>
+ </head>
+<body>
+ <div class="header">
+ <div style="float: left;"><a href="http://objectstyle.org/cayenne/"><img src="../../../images/logo.gif" align="absmiddle" border="0"></a></div>
+ <span class="logoSpaceLink"><a href="../../../index.html">Cayenne User Documentation</a></span><br />
+ <span class="pagetitle">Expressions</span>
+ </div>
+<div id="cayenne_toc">
+<ul>
+<li><a href="../../../Documentation/User Guide/Introduction/index.html">Introduction</a></li>
+<li><a href="../../../Documentation/User Guide/Installation/index.html">Installation</a></li>
+<li><a href="../../../Documentation/User Guide/Quick Start/index.html">Quick Start</a></li>
+<li><a href="../../../Documentation/User Guide/Design/index.html">Design</a></li>
+<li><a href="../../../Documentation/User Guide/Generating Classes/index.html">Generating Classes</a></li>
+<li><a href="../../../Documentation/User Guide/DataContext/index.html">DataContext</a></li>
+<li><a href="../../../Documentation/User Guide/Queries/index.html">Queries</a></li>
+<li><a href="../../../Documentation/User Guide/DataObjects/index.html">DataObjects</a></li>
+<li><a href="../../../Documentation/User Guide/Stored Procedures/index.html">Stored Procedures</a></li>
+<li><a href="../../../Documentation/User Guide/Expressions/index.html">Expressions</a><ul>
+<li><a href="../../../Documentation/User Guide/Expressions/Building Expressions/index.html">Building Expressions</a></li>
+<li><a href="../../../Documentation/User Guide/Expressions/Expression Factory Utilities/index.html">Expression Factory Utilities</a></li>
+<li><a href="../../../Documentation/User Guide/Expressions/In-Memory Evaluation/index.html">In-Memory Evaluation</a></li>
+<li><a href="../../../Documentation/User Guide/Expressions/NULL Handling/index.html">NULL Handling</a></li>
+<li><a href="../../../Documentation/User Guide/Expressions/Path Expressions/index.html">Path Expressions</a></li>
+</ul>
+</li>
+<li><a href="../../../Documentation/User Guide/Performance Tuning/index.html">Performance Tuning</a></li>
+<li><a href="../../../Documentation/User Guide/Deployment/index.html">Deployment</a></li>
+<li><a href="../../../Documentation/User Guide/Ant Tasks/index.html">Ant Tasks</a></li>
+<li><a href="../../../Documentation/User Guide/Access Stack Internals/index.html">Access Stack Internals</a></li>
+<li><a href="../../../Documentation/User Guide/DataViews/index.html">DataViews</a></li>
+</ul>
+</div>
+<div id="ConfluenceContent"><p>Cayenne defines a simple yet powerful object-based expression language. Cayenne expressions are database independent and are used as query qualifiers and orderings and also to perform in-memory evaluation with DataObjects (and generally any kind of Java Beans). BNF of Cayenne expression language is described <span class="nobr"><a href="http://objectstyle.org/cayenne/grammar/ExpressionParser.html" title="Visit page outside Confluence" rel="nofollow">here<sup><img class="rendericon" src="../../../images/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span>.</p>
+
+<p>Expressions are broadly divided into the following categories: object property expressions (also called "path expressions"), arithmetic operations, and conditional expressions. Cayenne contains a parser to build expressions from strings, and also features explicit expression API. Various ways of creating and using expressions are described later in this chapter. </p></div>
+</div>
+ <div class="clearer">.</div>
+ <div style="height: 12px; background-image: url('../../../images/border_bottom.gif'); background-repeat: repeat-x;"></div>
+
+ <div class="smalltext copyright">
+ Copyright ©2001-2006 ObjectStyle Group and content authors
+ </div>
+
+</body>
+</html>
Propchange: incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Expressions/index.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Generating Classes/index.html
URL: http://svn.apache.org/viewcvs/incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User%20Guide/Generating%20Classes/index.html?rev=405581&view=auto
==============================================================================
--- incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Generating Classes/index.html (added)
+++ incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Generating Classes/index.html Tue May 9 18:10:42 2006
@@ -0,0 +1,49 @@
+<html>
+ <head>
+ <title>Cayenne Documentation - Generating Classes</title>
+ <style type="text/css">@import "../../../style.css";</style>
+ </head>
+<body>
+ <div class="header">
+ <div style="float: left;"><a href="http://objectstyle.org/cayenne/"><img src="../../../images/logo.gif" align="absmiddle" border="0"></a></div>
+ <span class="logoSpaceLink"><a href="../../../index.html">Cayenne User Documentation</a></span><br />
+ <span class="pagetitle">Generating Classes</span>
+ </div>
+<div id="cayenne_toc">
+<ul>
+<li><a href="../../../Documentation/User Guide/Introduction/index.html">Introduction</a></li>
+<li><a href="../../../Documentation/User Guide/Installation/index.html">Installation</a></li>
+<li><a href="../../../Documentation/User Guide/Quick Start/index.html">Quick Start</a></li>
+<li><a href="../../../Documentation/User Guide/Design/index.html">Design</a></li>
+<li><a href="../../../Documentation/User Guide/Generating Classes/index.html">Generating Classes</a><ul>
+</ul>
+</li>
+<li><a href="../../../Documentation/User Guide/DataContext/index.html">DataContext</a></li>
+<li><a href="../../../Documentation/User Guide/Queries/index.html">Queries</a></li>
+<li><a href="../../../Documentation/User Guide/DataObjects/index.html">DataObjects</a></li>
+<li><a href="../../../Documentation/User Guide/Stored Procedures/index.html">Stored Procedures</a></li>
+<li><a href="../../../Documentation/User Guide/Expressions/index.html">Expressions</a></li>
+<li><a href="../../../Documentation/User Guide/Performance Tuning/index.html">Performance Tuning</a></li>
+<li><a href="../../../Documentation/User Guide/Deployment/index.html">Deployment</a></li>
+<li><a href="../../../Documentation/User Guide/Ant Tasks/index.html">Ant Tasks</a></li>
+<li><a href="../../../Documentation/User Guide/Access Stack Internals/index.html">Access Stack Internals</a></li>
+<li><a href="../../../Documentation/User Guide/DataViews/index.html">DataViews</a></li>
+</ul>
+</div>
+<div id="ConfluenceContent"><p>Cayenne supports continious synchronization of the Java class code with the latest mapping via class generation. Class generation can be done using one of the following techniques:</p>
+
+<ul>
+ <li><a href="../../../Documentation/Modeler Guide/Common Modeling Tasks/Generate Java Classes/index.html" title="Generate Java Classes">Generating Classes from CayenneModeler</a></li>
+ <li><a href="../../../Documentation/User Guide/Ant Tasks/cgen/index.html" title="cgen">Generating Classes with cgen Ant task</a></li>
+</ul>
+</div>
+</div>
+ <div class="clearer">.</div>
+ <div style="height: 12px; background-image: url('../../../images/border_bottom.gif'); background-repeat: repeat-x;"></div>
+
+ <div class="smalltext copyright">
+ Copyright ©2001-2006 ObjectStyle Group and content authors
+ </div>
+
+</body>
+</html>
Propchange: incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Generating Classes/index.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Installation/JAR Files and Dependencies/index.html
URL: http://svn.apache.org/viewcvs/incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User%20Guide/Installation/JAR%20Files%20and%20Dependencies/index.html?rev=405581&view=auto
==============================================================================
--- incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Installation/JAR Files and Dependencies/index.html (added)
+++ incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Installation/JAR Files and Dependencies/index.html Tue May 9 18:10:42 2006
@@ -0,0 +1,96 @@
+<html>
+ <head>
+ <title>Cayenne Documentation - JAR Files and Dependencies</title>
+ <style type="text/css">@import "../../../../style.css";</style>
+ </head>
+<body>
+ <div class="header">
+ <div style="float: left;"><a href="http://objectstyle.org/cayenne/"><img src="../../../../images/logo.gif" align="absmiddle" border="0"></a></div>
+ <span class="logoSpaceLink"><a href="../../../../index.html">Cayenne User Documentation</a></span><br />
+ <span class="pagetitle">JAR Files and Dependencies</span>
+ </div>
+<div id="cayenne_toc">
+<ul>
+<li><a href="../../../../Documentation/User Guide/Introduction/index.html">Introduction</a></li>
+<li><a href="../../../../Documentation/User Guide/Installation/index.html">Installation</a><ul>
+<li><a href="../../../../Documentation/User Guide/Installation/JAR Files and Dependencies/index.html">JAR Files and Dependencies</a><ul>
+</ul>
+</li>
+<li><a href="../../../../Documentation/User Guide/Installation/Upgrading From Earlier Versions/index.html">Upgrading From Earlier Versions</a></li>
+</ul>
+</li>
+<li><a href="../../../../Documentation/User Guide/Quick Start/index.html">Quick Start</a></li>
+<li><a href="../../../../Documentation/User Guide/Design/index.html">Design</a></li>
+<li><a href="../../../../Documentation/User Guide/Generating Classes/index.html">Generating Classes</a></li>
+<li><a href="../../../../Documentation/User Guide/DataContext/index.html">DataContext</a></li>
+<li><a href="../../../../Documentation/User Guide/Queries/index.html">Queries</a></li>
+<li><a href="../../../../Documentation/User Guide/DataObjects/index.html">DataObjects</a></li>
+<li><a href="../../../../Documentation/User Guide/Stored Procedures/index.html">Stored Procedures</a></li>
+<li><a href="../../../../Documentation/User Guide/Expressions/index.html">Expressions</a></li>
+<li><a href="../../../../Documentation/User Guide/Performance Tuning/index.html">Performance Tuning</a></li>
+<li><a href="../../../../Documentation/User Guide/Deployment/index.html">Deployment</a></li>
+<li><a href="../../../../Documentation/User Guide/Ant Tasks/index.html">Ant Tasks</a></li>
+<li><a href="../../../../Documentation/User Guide/Access Stack Internals/index.html">Access Stack Internals</a></li>
+<li><a href="../../../../Documentation/User Guide/DataViews/index.html">DataViews</a></li>
+</ul>
+</div>
+<div id="ConfluenceContent"><p>This sections explains where all the relevant jar files are located. It also lists Cayenne dependencies.</p>
+
+<h3><a name="JARFilesandDependencies-CayenneRuntimeFramework"></a>Cayenne Runtime Framework</h3>
+
+<p>One of two Cayenne jar files, <tt>cayenne.jar</tt> or <tt>cayenne-nodeps.jar</tt>, should be accessible in runtime (i.e. present in the application CLASSPATH). Either one or the other should be used (but not both at the same time). In most cases <tt>cayenne.jar</tt> is the best choice. It has Cayenne classes as well as a minimum set of third-party dependencies. Bundled dependencies include:</p>
+
+<ul>
+ <li><span class="nobr"><a href="http://objectstyle.org/ashwood/" title="Visit page outside Confluence" rel="nofollow">ObjectStyle Ashwood Graph Library<sup><img class="rendericon" src="../../../../images/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span>, version 1.1</li>
+ <li><span class="nobr"><a href="http://jakarta.apache.org/velocity/" title="Visit page outside Confluence" rel="nofollow">Apache Velocity Template Engine<sup><img class="rendericon" src="../../../../images/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span>, version 1.3 (and all its dependencies bundled with velocity-dep)</li>
+ <li><span class="nobr"><a href="http://jakarta.apache.org/log4j/" title="Visit page outside Confluence" rel="nofollow">Apache Log4J<sup><img class="rendericon" src="../../../../images/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span>, version 1.2.9</li>
+ <li><span class="nobr"><a href="http://jakarta.apache.org/commons/lang/" title="Visit page outside Confluence" rel="nofollow">Apache Commons Lang<sup><img class="rendericon" src="../../../../images/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span>, version 2.1</li>
+ <li><span class="nobr"><a href="http://jakarta.apache.org/commons/collections" title="Visit page outside Confluence" rel="nofollow">Apache Commons Collections<sup><img class="rendericon" src="../../../../images/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span>, version 3.1</li>
+ <li><span class="nobr"><a href="http://jakarta.apache.org/commons/logging/" title="Visit page outside Confluence" rel="nofollow">Apache Commons Logging<sup><img class="rendericon" src="../../../../images/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span>, version 1.0.4</li>
+</ul>
+
+
+<p>If bundled Cayenne dependencies conflict with different versions of the same library, a leaner <tt>cayenne-nodeps.jar</tt> file should be used. In this case all the dependencies above must be provided by the user.</p>
+
+<h3><a name="JARFilesandDependencies-OptionalRuntimeDependencies"></a>Optional Runtime Dependencies</h3>
+
+<p>One or more of the following libraries may be needed depending on how you use Cayenne:</p>
+
+<ul>
+ <li><span class="nobr"><a href="http://ant.apache.org/" title="Visit page outside Confluence" rel="nofollow">Apache Ant<sup><img class="rendericon" src="../../../../images/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span>, version 1.6 or newer. Needed for <a href="../../../../Documentation/User Guide/Ant Tasks/index.html" title="Ant Tasks">Cayenne Ant Tasks</a>.</li>
+ <li><span class="nobr"><a href="http://jakarta.apache.org/commons/pool/" title="Visit page outside Confluence" rel="nofollow">Apache Commons Pool<sup><img class="rendericon" src="../../../../images/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span>, version 1.2 and <span class="nobr"><a href="http://jakarta.apache.org/commons/dbcp/" title="Visit page outside Confluence" rel="nofollow">Apache Commons DBCP<sup><img class="rendericon" src="../../../../images/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span>, version 1.2.1. Needed if you use DBCPDataSourceFactory for one of the DataNodes.</li>
+ <li><span class="nobr"><a href="http://www.jgroups.org/" title="Visit page outside Confluence" rel="nofollow">JGroups<sup><img class="rendericon" src="../../../../images/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span>, version 2.2.7 or newer. Needed if you plan to use remote notifications via JGroups transport.</li>
+ <li><span class="nobr"><a href="http://java.sun.com/products/jms/" title="Visit page outside Confluence" rel="nofollow">Java Messaging Service (JMS)<sup><img class="rendericon" src="../../../../images/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span>. Needed if you plan to use remote notifications via JMS transport.</li>
+ <li><span class="nobr"><a href="http://www.jdom.org/" title="Visit page outside Confluence" rel="nofollow">JDOM<sup><img class="rendericon" src="../../../../images/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span>, version 1.0. Needed if you use <a href="../../../../Documentation/User Guide/DataViews/index.html" title="DataViews">DataViews</a>.</li>
+</ul>
+
+
+
+<h3><a name="JARFilesandDependencies-CayenneModelerTool"></a>CayenneModeler Tool</h3>
+
+<p>Java classes and resources used exclusively by CayenneModeler and not required by the runtime are located in [cayenne_install_dir]/lib/modeler/ directory:</p>
+
+<ul>
+ <li>cayenne-modeler.jar</li>
+ <li>scope-bin-1.0.1.jar</li>
+ <li>forms-1.0.3.jar</li>
+ <li>plastic-1.1.2.jar</li>
+ <li>hsqldb-1.7.2.jar</li>
+ <li>ognl-2.6.5.jar</li>
+ <li>commons-dbcp-1.2.1.jar</li>
+ <li>commons-pool-1.2.jar</li>
+</ul>
+
+
+<p>cayenne-modeler.jar implicitly relies on the presence of [cayenne_install_dir]/lib/cayenne.jar. Instructions on how to start modeler can be found <a href="../../../../Documentation/Modeler Guide/Introduction to CayenneModeler/Running CayenneModeler/index.html" title="Running CayenneModeler">here</a>.</p>
+</div>
+</div>
+ <div class="clearer">.</div>
+ <div style="height: 12px; background-image: url('../../../../images/border_bottom.gif'); background-repeat: repeat-x;"></div>
+
+ <div class="smalltext copyright">
+ Copyright ©2001-2006 ObjectStyle Group and content authors
+ </div>
+
+</body>
+</html>
Propchange: incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Installation/JAR Files and Dependencies/index.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Installation/Upgrading From Earlier Versions/index.html
URL: http://svn.apache.org/viewcvs/incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User%20Guide/Installation/Upgrading%20From%20Earlier%20Versions/index.html?rev=405581&view=auto
==============================================================================
--- incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Installation/Upgrading From Earlier Versions/index.html (added)
+++ incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Installation/Upgrading From Earlier Versions/index.html Tue May 9 18:10:42 2006
@@ -0,0 +1,62 @@
+<html>
+ <head>
+ <title>Cayenne Documentation - Upgrading From Earlier Versions</title>
+ <style type="text/css">@import "../../../../style.css";</style>
+ </head>
+<body>
+ <div class="header">
+ <div style="float: left;"><a href="http://objectstyle.org/cayenne/"><img src="../../../../images/logo.gif" align="absmiddle" border="0"></a></div>
+ <span class="logoSpaceLink"><a href="../../../../index.html">Cayenne User Documentation</a></span><br />
+ <span class="pagetitle">Upgrading From Earlier Versions</span>
+ </div>
+<div id="cayenne_toc">
+<ul>
+<li><a href="../../../../Documentation/User Guide/Introduction/index.html">Introduction</a></li>
+<li><a href="../../../../Documentation/User Guide/Installation/index.html">Installation</a><ul>
+<li><a href="../../../../Documentation/User Guide/Installation/JAR Files and Dependencies/index.html">JAR Files and Dependencies</a></li>
+<li><a href="../../../../Documentation/User Guide/Installation/Upgrading From Earlier Versions/index.html">Upgrading From Earlier Versions</a><ul>
+</ul>
+</li>
+</ul>
+</li>
+<li><a href="../../../../Documentation/User Guide/Quick Start/index.html">Quick Start</a></li>
+<li><a href="../../../../Documentation/User Guide/Design/index.html">Design</a></li>
+<li><a href="../../../../Documentation/User Guide/Generating Classes/index.html">Generating Classes</a></li>
+<li><a href="../../../../Documentation/User Guide/DataContext/index.html">DataContext</a></li>
+<li><a href="../../../../Documentation/User Guide/Queries/index.html">Queries</a></li>
+<li><a href="../../../../Documentation/User Guide/DataObjects/index.html">DataObjects</a></li>
+<li><a href="../../../../Documentation/User Guide/Stored Procedures/index.html">Stored Procedures</a></li>
+<li><a href="../../../../Documentation/User Guide/Expressions/index.html">Expressions</a></li>
+<li><a href="../../../../Documentation/User Guide/Performance Tuning/index.html">Performance Tuning</a></li>
+<li><a href="../../../../Documentation/User Guide/Deployment/index.html">Deployment</a></li>
+<li><a href="../../../../Documentation/User Guide/Ant Tasks/index.html">Ant Tasks</a></li>
+<li><a href="../../../../Documentation/User Guide/Access Stack Internals/index.html">Access Stack Internals</a></li>
+<li><a href="../../../../Documentation/User Guide/DataViews/index.html">DataViews</a></li>
+</ul>
+</div>
+<div id="ConfluenceContent"><h3><a name="UpgradingFromEarlierVersions-GeneralUpgradeRecommendations"></a>General Upgrade Recommendations</h3>
+
+<ul>
+ <li>Upgrade XML files. Open your project with the version of the Modeler that came with the latest download. If an upgrade dialog pops up, select "yes" to do an upgrade. Also if you are using a milestone or a nightly build it is also a good idea to make some insignificant change to the model (so that a "Save" button is activated) and do a save.</li>
+ <li>Do a clean recomplie. Recompile all your code, to make sure that you are not using any old classes or methods. Pay attention to deprecation warnings. It is always a good idea to update your code to avoid deprecated API.</li>
+</ul>
+
+
+<table cellpadding='5' width='85%' cellspacing='8px' class='warningMacro' border="0" align='center'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="../../../../images/emoticons/forbidden.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td>Upgrading project XML files will likely make them unusable with earlier versions of Cayenne.</td></tr></table>
+
+<h3><a name="UpgradingFromEarlierVersions-Upgradingfrom1.1and1.0"></a>Upgrading from 1.1 and 1.0</h3>
+
+<ul>
+ <li><b>PostgreSQL PK Generator</b> (For PostgreSQL users only) Since Cayenne 1.2 default PK generator for PostgreSQL database uses database sequences instead of AUTO_PK_TABLE. To port an existing application, you will need to create those sequences and assign correct current values to them (e.g. taken from the old AUTO_PK_TABLE). After that AUTO_PK_TABLE can be dropped.</li>
+</ul>
+</div>
+</div>
+ <div class="clearer">.</div>
+ <div style="height: 12px; background-image: url('../../../../images/border_bottom.gif'); background-repeat: repeat-x;"></div>
+
+ <div class="smalltext copyright">
+ Copyright ©2001-2006 ObjectStyle Group and content authors
+ </div>
+
+</body>
+</html>
Propchange: incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Installation/Upgrading From Earlier Versions/index.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Installation/index.html
URL: http://svn.apache.org/viewcvs/incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User%20Guide/Installation/index.html?rev=405581&view=auto
==============================================================================
--- incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Installation/index.html (added)
+++ incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Installation/index.html Tue May 9 18:10:42 2006
@@ -0,0 +1,83 @@
+<html>
+ <head>
+ <title>Cayenne Documentation - Installation</title>
+ <style type="text/css">@import "../../../style.css";</style>
+ </head>
+<body>
+ <div class="header">
+ <div style="float: left;"><a href="http://objectstyle.org/cayenne/"><img src="../../../images/logo.gif" align="absmiddle" border="0"></a></div>
+ <span class="logoSpaceLink"><a href="../../../index.html">Cayenne User Documentation</a></span><br />
+ <span class="pagetitle">Installation</span>
+ </div>
+<div id="cayenne_toc">
+<ul>
+<li><a href="../../../Documentation/User Guide/Introduction/index.html">Introduction</a></li>
+<li><a href="../../../Documentation/User Guide/Installation/index.html">Installation</a><ul>
+<li><a href="../../../Documentation/User Guide/Installation/JAR Files and Dependencies/index.html">JAR Files and Dependencies</a></li>
+<li><a href="../../../Documentation/User Guide/Installation/Upgrading From Earlier Versions/index.html">Upgrading From Earlier Versions</a></li>
+</ul>
+</li>
+<li><a href="../../../Documentation/User Guide/Quick Start/index.html">Quick Start</a></li>
+<li><a href="../../../Documentation/User Guide/Design/index.html">Design</a></li>
+<li><a href="../../../Documentation/User Guide/Generating Classes/index.html">Generating Classes</a></li>
+<li><a href="../../../Documentation/User Guide/DataContext/index.html">DataContext</a></li>
+<li><a href="../../../Documentation/User Guide/Queries/index.html">Queries</a></li>
+<li><a href="../../../Documentation/User Guide/DataObjects/index.html">DataObjects</a></li>
+<li><a href="../../../Documentation/User Guide/Stored Procedures/index.html">Stored Procedures</a></li>
+<li><a href="../../../Documentation/User Guide/Expressions/index.html">Expressions</a></li>
+<li><a href="../../../Documentation/User Guide/Performance Tuning/index.html">Performance Tuning</a></li>
+<li><a href="../../../Documentation/User Guide/Deployment/index.html">Deployment</a></li>
+<li><a href="../../../Documentation/User Guide/Ant Tasks/index.html">Ant Tasks</a></li>
+<li><a href="../../../Documentation/User Guide/Access Stack Internals/index.html">Access Stack Internals</a></li>
+<li><a href="../../../Documentation/User Guide/DataViews/index.html">DataViews</a></li>
+</ul>
+</div>
+<div id="ConfluenceContent"><h3><a name="Installation-SystemRequirements"></a>System Requirements</h3>
+
+<ul>
+ <li><b>JDK:</b> Cayenne, including GUI tools, is written in 100% Java, and runs on any Java-compatible platform. Required JDK version is 1.4 or higher. If your deployment environment uses JDK 1.3, you still can use Cayenne, just downgrade to version 1.1.x - the last version compatible with JDK 1.3.</li>
+</ul>
+
+
+<ul>
+ <li><b>JDBC Driver:</b> You will need a JDBC driver to access the database. Information about various drivers and database-specific configuration is available on the <span class="error">[Database Support]</span> page.</li>
+</ul>
+
+
+<ul>
+ <li><b>Third-party Libraries:</b> Depending on the application nature, Cayenne may optionally require a few third-party open source packages. See <a href="../../../Documentation/User Guide/Installation/JAR Files and Dependencies/index.html" title="JAR Files and Dependencies">JAR Files and Dependencies</a> page for details.</li>
+</ul>
+
+
+
+<h3><a name="Installation-ObtainingCayenne"></a>Obtaining Cayenne</h3>
+
+<p>Installation of Cayenne is simple - just download and unpack the distribution. Download page is located here: <span class="nobr"><a href="http://objectstyle.org/cayenne/download.html" title="Visit page outside Confluence" rel="nofollow">http://objectstyle.org/cayenne/download.html<sup><img class="rendericon" src="../../../images/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span>. </p>
+
+<p>To unpack the downloaded distribution file, on Windows use <span class="nobr"><a href="http://winzip.com/" title="Visit page outside Confluence" rel="nofollow">WinZip<sup><img class="rendericon" src="../../../images/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span>, on UNIX use GNU tar:</p>
+
+<div class="code"><div class="codeContent">
+<pre class="code-java"># tar xzf [filename].tar.gz</pre>
+</div></div>
+
+<p>In most environments this is all you need. Setting environment variables step discussed below is only required to use the tools from a cross-platform distribution that does not have native tool launchers. It is NOT needed on a deployment machine.</p>
+
+<h3><a name="Installation-SettingEnvironmentVariables"></a>Setting Environment Variables</h3>
+
+<p>To run CayenneModeler and other tools, you may need to set the following environment variables as discussed in the <a href="../../../Documentation/Modeler Guide/Introduction to CayenneModeler/Running CayenneModeler/index.html" title="Running CayenneModeler">Running CayenneModeler</a> chapter of the Modeler Guide:</p>
+
+<ul>
+ <li><tt>JAVA_HOME</tt> - should point to your JSDK 1.4 installation. It may already exist in the environment.</li>
+ <li><tt>CAYENNE_HOME</tt> (optional) - should point to the directory created when your unpacked Cayenne distribution in the previous steps. (Directory named like cayenne-[release-suffix]). If CAYENNE_HOME is undefined, scripts can still guess it as long as they are run from their own directory (cayenne-[release-suffix]/bin/)</li>
+</ul>
+</div>
+</div>
+ <div class="clearer">.</div>
+ <div style="height: 12px; background-image: url('../../../images/border_bottom.gif'); background-repeat: repeat-x;"></div>
+
+ <div class="smalltext copyright">
+ Copyright ©2001-2006 ObjectStyle Group and content authors
+ </div>
+
+</body>
+</html>
Propchange: incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Installation/index.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Introduction/Acknowledgements/index.html
URL: http://svn.apache.org/viewcvs/incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User%20Guide/Introduction/Acknowledgements/index.html?rev=405581&view=auto
==============================================================================
--- incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Introduction/Acknowledgements/index.html (added)
+++ incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Introduction/Acknowledgements/index.html Tue May 9 18:10:42 2006
@@ -0,0 +1,49 @@
+<html>
+ <head>
+ <title>Cayenne Documentation - Acknowledgements</title>
+ <style type="text/css">@import "../../../../style.css";</style>
+ </head>
+<body>
+ <div class="header">
+ <div style="float: left;"><a href="http://objectstyle.org/cayenne/"><img src="../../../../images/logo.gif" align="absmiddle" border="0"></a></div>
+ <span class="logoSpaceLink"><a href="../../../../index.html">Cayenne User Documentation</a></span><br />
+ <span class="pagetitle">Acknowledgements</span>
+ </div>
+<div id="cayenne_toc">
+<ul>
+<li><a href="../../../../Documentation/User Guide/Introduction/index.html">Introduction</a><ul>
+<li><a href="../../../../Documentation/User Guide/Introduction/Acknowledgements/index.html">Acknowledgements</a><ul>
+</ul>
+</li>
+<li><a href="../../../../Documentation/User Guide/Introduction/Guide to 1.1 features/index.html">Guide to 1.1 features</a></li>
+<li><a href="../../../../Documentation/User Guide/Introduction/Guide to 1.2 Features/index.html">Guide to 1.2 Features</a></li>
+<li><a href="../../../../Documentation/User Guide/Introduction/License/index.html">License</a></li>
+</ul>
+</li>
+<li><a href="../../../../Documentation/User Guide/Installation/index.html">Installation</a></li>
+<li><a href="../../../../Documentation/User Guide/Quick Start/index.html">Quick Start</a></li>
+<li><a href="../../../../Documentation/User Guide/Design/index.html">Design</a></li>
+<li><a href="../../../../Documentation/User Guide/Generating Classes/index.html">Generating Classes</a></li>
+<li><a href="../../../../Documentation/User Guide/DataContext/index.html">DataContext</a></li>
+<li><a href="../../../../Documentation/User Guide/Queries/index.html">Queries</a></li>
+<li><a href="../../../../Documentation/User Guide/DataObjects/index.html">DataObjects</a></li>
+<li><a href="../../../../Documentation/User Guide/Stored Procedures/index.html">Stored Procedures</a></li>
+<li><a href="../../../../Documentation/User Guide/Expressions/index.html">Expressions</a></li>
+<li><a href="../../../../Documentation/User Guide/Performance Tuning/index.html">Performance Tuning</a></li>
+<li><a href="../../../../Documentation/User Guide/Deployment/index.html">Deployment</a></li>
+<li><a href="../../../../Documentation/User Guide/Ant Tasks/index.html">Ant Tasks</a></li>
+<li><a href="../../../../Documentation/User Guide/Access Stack Internals/index.html">Access Stack Internals</a></li>
+<li><a href="../../../../Documentation/User Guide/DataViews/index.html">DataViews</a></li>
+</ul>
+</div>
+<div id="ConfluenceContent"><p>We would like to thank our dedicated team of <span class="nobr"><a href="http://objectstyle.org/cayenne/contributors.html" title="Visit page outside Confluence" rel="nofollow">contributors<sup><img class="rendericon" src="../../../../images/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span> - for making this project possible, early adopters - for taking all the pain to help us make a usable product, other users - for providing feedback, comments, patches and bug reports.</p></div>
+</div>
+ <div class="clearer">.</div>
+ <div style="height: 12px; background-image: url('../../../../images/border_bottom.gif'); background-repeat: repeat-x;"></div>
+
+ <div class="smalltext copyright">
+ Copyright ©2001-2006 ObjectStyle Group and content authors
+ </div>
+
+</body>
+</html>
Propchange: incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Introduction/Acknowledgements/index.html
------------------------------------------------------------------------------
svn:eol-style = native
Added: incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Introduction/Guide to 1.1 features/cayenne-data-map-1_2.dtd
URL: http://svn.apache.org/viewcvs/incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User%20Guide/Introduction/Guide%20to%201.1%20features/cayenne-data-map-1_2.dtd?rev=405581&view=auto
==============================================================================
--- incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Introduction/Guide to 1.1 features/cayenne-data-map-1_2.dtd (added)
+++ incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Introduction/Guide to 1.1 features/cayenne-data-map-1_2.dtd Tue May 9 18:10:42 2006
@@ -0,0 +1,262 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+
+<!-- ===================================================
+Cayenne DataMap DTD, v 1.1
+
+Copyright (c) 2002-2005 Andrei Adamchik and individual authors. All rights reserved
+
+Author: Michael Shengaout
+Author: Andrei Adamchik
+Author: Andriy Shapochka
+
+Defines format of Cayenne DataMap XML files (*.map.xml). DataMap files contain
+the metadata needed for Cayenne object-relational features. Multiple DataMaps
+are usually combined in one shared namespace, so the elements of the DataMap
+may reference objects from other DataMaps.
+-->
+
+<!-- ===================================================
+A generic property used by other configuration objects.
+-->
+<!ELEMENT property EMPTY>
+<!ATTLIST property
+ name CDATA #REQUIRED
+ value CDATA #REQUIRED
+>
+
+<!-- ===================================================
+Root element.
+-->
+<!ELEMENT data-map (property*, db-entity*, obj-entity*, db-relationship*, obj-relationship*, procedure*, query*)>
+<!ATTLIST data-map
+ project-version CDATA #REQUIRED
+>
+
+<!-- ===================================================
+A descriptor of a DB table or view.
+-->
+<!ELEMENT db-entity (db-attribute+, db-attribute-derived+, db-key-generator?)>
+<!ATTLIST db-entity
+ name CDATA #REQUIRED
+ schema CDATA #IMPLIED
+ catalog CDATA #IMPLIED
+ parentName CDATA #IMPLIED
+>
+
+<!-- ===================================================
+A descriptor of a DB table column.
+-->
+<!ELEMENT db-attribute EMPTY>
+<!ATTLIST db-attribute
+ name CDATA #REQUIRED
+ isPrimaryKey (true | false) "false"
+ isMandatory (true | false) "false"
+ isGenerated (true|false) "false"
+ type CDATA #REQUIRED
+ length CDATA #IMPLIED
+ precision CDATA #IMPLIED
+>
+
+<!-- ===================================================
+A descriptor of a column of a "dynamic view" defined via a derived DbEntity.
+-->
+<!ELEMENT db-attribute-derived (db-attribute-ref*)>
+<!ATTLIST db-attribute-derived
+ name CDATA #REQUIRED
+ isPrimaryKey (true | false) "false"
+ isMandatory (true | false) "false"
+ type CDATA #REQUIRED
+ length CDATA #IMPLIED
+ precision CDATA #IMPLIED
+ isGroupBy (true | false) "false"
+ spec CDATA #IMPLIED
+>
+
+<!ELEMENT db-attribute-ref EMPTY>
+<!ATTLIST db-attribute
+ name CDATA #REQUIRED
+>
+
+<!-- ===================================================
+Defines an ObjEntity - a metadata element describing a persistent Java
+class. Since 1.1 allows "superEntityName" to specify a parent in the inheritance
+hierarchy.
+-->
+<!ELEMENT obj-entity (qualifier?, obj-attribute+)>
+<!ATTLIST obj-entity
+ name CDATA #REQUIRED
+ className CDATA #REQUIRED
+ dbEntityName CDATA #REQUIRED
+ superEntityName CDATA #IMPLIED
+ superClassName CDATA #IMPLIED
+ clientClassName CDATA #IMPLIED
+ clientSuperClassName CDATA #IMPLIED
+ readOnly (true | false) "false"
+ lock-type (optimistic | none) "none"
+>
+
+<!ELEMENT obj-attribute EMPTY>
+<!ATTLIST obj-attribute
+ name CDATA #REQUIRED
+ db-attribute-path CDATA #REQUIRED
+ type CDATA #REQUIRED
+ lock (true | false) "false"
+>
+
+<!ELEMENT obj-relationship EMPTY>
+<!ATTLIST obj-relationship
+ name CDATA #REQUIRED
+ source CDATA #REQUIRED
+ target CDATA #REQUIRED
+ toMany (true | false) "false"
+ lock (true | false) "false"
+ db-relationship-path CDATA #IMPLIED
+>
+
+<!ELEMENT db-relationship (db-attribute-pair+)>
+<!ATTLIST db-relationship
+ source CDATA #REQUIRED
+ target CDATA #REQUIRED
+ toMany (true | false) "false"
+ toDependentPK (true | false) "false"
+ name CDATA #REQUIRED
+>
+
+<!ELEMENT db-attribute-pair EMPTY>
+<!ATTLIST db-attribute-pair
+ source CDATA #REQUIRED
+ target CDATA #REQUIRED
+>
+
+<!ELEMENT procedure (procedure-parameter*)>
+<!ATTLIST procedure
+ name CDATA #REQUIRED
+ schema CDATA #IMPLIED
+ catalog CDATA #IMPLIED
+ returningValue (true | false) "false"
+>
+
+<!ELEMENT procedure-parameter EMPTY>
+<!ATTLIST procedure-parameter
+ name CDATA #REQUIRED
+ direction (in | in_out | out | void) "void"
+ type CDATA #REQUIRED
+ length CDATA #IMPLIED
+ precision CDATA #IMPLIED
+>
+
+<!-- ===================================================
+Defines a Cayenne Query that can be either at the DataMap
+level, or linked to an entity or procedure.
+-->
+<!ELEMENT query (property*, result-column*, (sql* | (qualifier?, ordering*, prefetch*)?) >
+<!ATTLIST query
+ name CDATA #REQUIRED
+ factory CDATA #REQUIRED
+ root (db-entity | obj-entity | procedure | data-map | java-class) "data-map"
+ root-name CDATA #IMPLIED
+ result-class CDATA #IMPLIED
+ selecting (true | false) "true"
+>
+
+<!-- ===================================================
+Defines a query ResultSet column. This can be viewed as
+a stripped down combination of ObjAttribute and DbAttribute.
+-->
+<!ELEMENT result-column>
+<!ATTLIST result-column
+ label CDATA #IMPLIED
+ db-type CDATA #REQUIRED
+ java-type CDATA #REQUIRED
+>
+
+<!-- ===================================================
+Defines a query qualifier, normally an encoded expression
+wrapped in CDATA, like "abc.name != $param2 and salary >
+$param2".
+-->
+<!ELEMENT qualifier (#PCDATA)>
+
+<!-- ===================================================
+Defines a query ordering.
+-->
+<!ELEMENT ordering (#PCDATA)>
+<!ATTLIST ordering
+ descending (true | false) "false"
+ ignore-case (true | false) "false"
+>
+
+<!-- ===================================================
+Defines a query relationship prefetching.
+-->
+<!ELEMENT prefetch (#PCDATA)>
+
+<!-- ===================================================
+Defines arbitrary SQL statement, normally wrapped in
+CDATA section. Note that SQL statement can be customized
+for different SQL dialects per DbAdapter class. If no
+adapter-specific statement is found, the one with no
+adapter label is used by default
+-->
+<!ELEMENT sql (#PCDATA)>
+<!ATTLIST sql
+ adapter-class CDATA #IMPLIED
+>
+
+
+<!-- ===================================================
+"db-key-generator" optional tag is used to install the
+Automatic Sequence/Key Generation facility for db-entity.
+
+Example:
+ <db-key-generator>
+ <db-generator-type>ORACLE</db-generator-type>
+ <db-generator-name>test_sequence</db-generator-name>
+ <db-key-cache-size>10</db-key-cache-size>
+ </db-key-generator>
+
+Notes: This feature is intended for use with Simple (non-Compound)
+ Integral Primary Keys.
+-->
+<!ELEMENT db-key-generator (
+ db-generator-type,
+ db-generator-name?,
+ db-key-cache-size?
+)>
+
+<!-- ===================================================
+Specifies the Key Generation Method that will be employed
+ 'ORACLE' - use Oracle's SEQUENCE
+ 'NAMED_SEQUENCE_TABLE' - use USER designated SEQUENCE TABLE
+ User specifies the name of a DBMS Table
+ with the schema (sequence INT)
+ which will be used to hold sequence values
+ (not supported yet)
+-->
+<!ELEMENT db-generator-type (#PCDATA)>
+
+<!-- ===================================================
+If this is DBMS Key Generation,
+Then this may be used to specify the Name of the Generator,
+ e.g. for <db-generator-type>ORACLE
+ <db-generator-name> would be the name of the ORACLE SEQUENCE to use.
+ the SEQUENCE is assumed to already exist in the Database.
+
+If this is <db-generator-type>NAMED_SEQUENCE_TABLE Key Generation,
+Then this would be used to specify the name of the SEQUENCE TABLE to use.
+ the NAMED_SEQUENCE_TABLE is assumed to already exist in the Database
+ with 1 row.
+-->
+<!ELEMENT db-generator-name (#PCDATA)>
+
+<!-- ===================================================
+Optional size of key cache.
+For <db-generator-type>ORACLE , this value MUST match the
+ Oracle SEQUENCE INCREMENT value. If there is a mismatch
+ between this value and the Oracle SEQUENCE INCREMENT value,
+ then there will likely be duplicate key problems.
+
+For <db-generator-type>NAMED_SEQUENCE_TABLE , this tells how many keys
+ the Container will fetch in a single DBMS call
+-->
+<!ELEMENT db-key-cache-size (#PCDATA)>
Added: incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Introduction/Guide to 1.1 features/cayenne-data-view-1_1.dtd
URL: http://svn.apache.org/viewcvs/incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User%20Guide/Introduction/Guide%20to%201.1%20features/cayenne-data-view-1_1.dtd?rev=405581&view=auto
==============================================================================
--- incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Introduction/Guide to 1.1 features/cayenne-data-view-1_1.dtd (added)
+++ incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Introduction/Guide to 1.1 features/cayenne-data-view-1_1.dtd Tue May 9 18:10:42 2006
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+
+<!ELEMENT caption ( #PCDATA ) >
+
+<!ELEMENT data-view ( obj-entity-view+ ) >
+
+<!ELEMENT default-value ( #PCDATA ) >
+
+<!ELEMENT pattern ( #PCDATA ) >
+
+<!ELEMENT edit-format ( pattern? ) >
+<!ATTLIST edit-format class NMTOKEN #REQUIRED >
+
+
+<!ELEMENT display-format ( pattern? ) >
+<!ATTLIST display-format class NMTOKEN #REQUIRED >
+
+<!ELEMENT lookup EMPTY >
+<!ATTLIST lookup obj-entity-view-name NMTOKEN #REQUIRED >
+<!ATTLIST lookup field-name NMTOKEN #REQUIRED >
+
+<!ELEMENT field ( caption?, lookup?, edit-format?,
+ display-format?, default-value? ) >
+<!ATTLIST field obj-relationship-name NMTOKEN #IMPLIED >
+<!ATTLIST field pref-index NMTOKEN #IMPLIED >
+<!ATTLIST field name NMTOKEN #REQUIRED >
+<!ATTLIST field editable ( false | true ) #REQUIRED >
+<!ATTLIST field obj-attribute-name NMTOKEN #IMPLIED >
+<!ATTLIST field calc-type ( nocalc | lookup ) #REQUIRED >
+<!ATTLIST field data-type ( Object | String | Money |
+ Integer | Double | Percent |
+ Date | Datetime | Boolean ) #REQUIRED >
+<!ATTLIST field visible ( false | true ) #REQUIRED >
+
+<!ELEMENT obj-entity-view ( field+ ) >
+<!ATTLIST obj-entity-view name NMTOKEN #REQUIRED >
+<!ATTLIST obj-entity-view obj-entity-name NMTOKEN #IMPLIED >
+
+
Added: incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Introduction/Guide to 1.1 features/cayenne-driver-1_1.dtd
URL: http://svn.apache.org/viewcvs/incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User%20Guide/Introduction/Guide%20to%201.1%20features/cayenne-driver-1_1.dtd?rev=405581&view=auto
==============================================================================
--- incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Introduction/Guide to 1.1 features/cayenne-driver-1_1.dtd (added)
+++ incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Introduction/Guide to 1.1 features/cayenne-driver-1_1.dtd Tue May 9 18:10:42 2006
@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+
+<!-- =================================================== -->
+<!-- Cayenne Driver DTD, v 1.1 -->
+<!-- -->
+<!-- Copyright (c) 2002-2005 Andrei Adamchik and -->
+<!-- individual authors. All rights reserved -->
+<!-- -->
+<!-- Author: Andrei Adamchik -->
+<!-- -->
+<!-- Describes Cayenne JDBC driver configuration files -->
+<!-- usually called *.driver.xml. Note that driver files -->
+<!-- are only used when DataSource is NOT provided by -->
+<!-- container. -->
+<!-- =================================================== -->
+
+<!ELEMENT driver (url, connectionPool?, login?)>
+<!ATTLIST driver
+ class CDATA #REQUIRED
+>
+
+<!ELEMENT url EMPTY>
+<!ATTLIST url
+ value CDATA #REQUIRED
+>
+
+<!ELEMENT connectionPool>
+<!ATTLIST connectionPool
+ min CDATA #REQUIRED
+ max CDATA #REQUIRED
+>
+
+<!ELEMENT login>
+<!ATTLIST login
+ userName CDATA #REQUIRED
+ password CDATA #REQUIRED
+>
Added: incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Introduction/Guide to 1.1 features/cayenne-project-1_1.dtd
URL: http://svn.apache.org/viewcvs/incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User%20Guide/Introduction/Guide%20to%201.1%20features/cayenne-project-1_1.dtd?rev=405581&view=auto
==============================================================================
--- incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Introduction/Guide to 1.1 features/cayenne-project-1_1.dtd (added)
+++ incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Introduction/Guide to 1.1 features/cayenne-project-1_1.dtd Tue May 9 18:10:42 2006
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+
+<!-- =================================================== -->
+<!-- Cayenne Project DTD, v 1.1 -->
+<!-- -->
+<!-- Copyright (c) 2002-2005 Andrei Adamchik and -->
+<!-- individual authors. All rights reserved -->
+<!-- -->
+<!-- Author: Andrei Adamchik -->
+<!-- -->
+<!-- Cayenne project files described by this DTD are -->
+<!-- normally called "cayenne.xml" and describe -->
+<!-- Cayenne deployment configuration for a particular -->
+<!-- application. -->
+<!-- =================================================== -->
+
+<!ELEMENT domains (domain*)>
+<!ATTLIST domains
+ project-version CDATA
+>
+
+<!ELEMENT domain (property*, map*, node*, view*)>
+<!ATTLIST domain
+ name CDATA #REQUIRED
+>
+
+<!ELEMENT property>
+<!ATTLIST property
+ name CDATA #REQUIRED
+ value CDATA #REQUIRED
+>
+
+<!ELEMENT map>
+<!ATTLIST map
+ name CDATA #REQUIRED
+ location CDATA #REQUIRED
+>
+
+<!ELEMENT node (map-ref*)>
+<!ATTLIST node
+ name CDATA #REQUIRED
+ factory CDATA #REQUIRED
+ datasource CDATA #REQUIRED
+ adapter CDATA #IMPLIED
+>
+
+<!ELEMENT view>
+<!ATTLIST view
+ name CDATA #REQUIRED
+ location CDATA #REQUIRED
+>
+
+<!ELEMENT map-ref>
+<!ATTLIST map-ref
+ name CDATA #REQUIRED
+>
+
Added: incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Introduction/Guide to 1.1 features/index.html
URL: http://svn.apache.org/viewcvs/incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User%20Guide/Introduction/Guide%20to%201.1%20features/index.html?rev=405581&view=auto
==============================================================================
--- incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Introduction/Guide to 1.1 features/index.html (added)
+++ incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Introduction/Guide to 1.1 features/index.html Tue May 9 18:10:42 2006
@@ -0,0 +1,191 @@
+<html>
+ <head>
+ <title>Cayenne Documentation - Guide to 1.1 features</title>
+ <style type="text/css">@import "../../../../style.css";</style>
+ </head>
+<body>
+ <div class="header">
+ <div style="float: left;"><a href="http://objectstyle.org/cayenne/"><img src="../../../../images/logo.gif" align="absmiddle" border="0"></a></div>
+ <span class="logoSpaceLink"><a href="../../../../index.html">Cayenne User Documentation</a></span><br />
+ <span class="pagetitle">Guide to 1.1 features</span>
+ </div>
+<div id="cayenne_toc">
+<ul>
+<li><a href="../../../../Documentation/User Guide/Introduction/index.html">Introduction</a><ul>
+<li><a href="../../../../Documentation/User Guide/Introduction/Acknowledgements/index.html">Acknowledgements</a></li>
+<li><a href="../../../../Documentation/User Guide/Introduction/Guide to 1.1 features/index.html">Guide to 1.1 features</a><ul>
+</ul>
+</li>
+<li><a href="../../../../Documentation/User Guide/Introduction/Guide to 1.2 Features/index.html">Guide to 1.2 Features</a></li>
+<li><a href="../../../../Documentation/User Guide/Introduction/License/index.html">License</a></li>
+</ul>
+</li>
+<li><a href="../../../../Documentation/User Guide/Installation/index.html">Installation</a></li>
+<li><a href="../../../../Documentation/User Guide/Quick Start/index.html">Quick Start</a></li>
+<li><a href="../../../../Documentation/User Guide/Design/index.html">Design</a></li>
+<li><a href="../../../../Documentation/User Guide/Generating Classes/index.html">Generating Classes</a></li>
+<li><a href="../../../../Documentation/User Guide/DataContext/index.html">DataContext</a></li>
+<li><a href="../../../../Documentation/User Guide/Queries/index.html">Queries</a></li>
+<li><a href="../../../../Documentation/User Guide/DataObjects/index.html">DataObjects</a></li>
+<li><a href="../../../../Documentation/User Guide/Stored Procedures/index.html">Stored Procedures</a></li>
+<li><a href="../../../../Documentation/User Guide/Expressions/index.html">Expressions</a></li>
+<li><a href="../../../../Documentation/User Guide/Performance Tuning/index.html">Performance Tuning</a></li>
+<li><a href="../../../../Documentation/User Guide/Deployment/index.html">Deployment</a></li>
+<li><a href="../../../../Documentation/User Guide/Ant Tasks/index.html">Ant Tasks</a></li>
+<li><a href="../../../../Documentation/User Guide/Access Stack Internals/index.html">Access Stack Internals</a></li>
+<li><a href="../../../../Documentation/User Guide/DataViews/index.html">DataViews</a></li>
+</ul>
+</div>
+<div id="ConfluenceContent"><p>Cayenne version 1.1 introduces a large number of new features and enhancements over 1.0. This chapter lists most of them, providing the links to more detailed information about each feature.</p>
+
+<h3><a name="Guideto1.1features-DTDAdditions."></a>DTD Additions.</h3>
+
+<p>"cayenne.xml" and "*.map.xml" file formats were updated to support new features. 1.1 DTD files are located here:</p>
+<ul>
+ <li><span class="nobr"><a href="cayenne-project-1_1.dtd?version=1" title="cayenne-project-1_1.dtd attached to Guide to 1.1 features">cayenne-project-1_1.dtd<sup><img class="rendericon" src="../../../../images/link_attachment_7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span></li>
+ <li><span class="nobr"><a href="cayenne-data-map-1_2.dtd?version=1" title="cayenne-data-map-1_2.dtd attached to Guide to 1.1 features">cayenne-data-map-1_2.dtd<sup><img class="rendericon" src="../../../../images/link_attachment_7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span></li>
+ <li><span class="nobr"><a href="cayenne-data-view-1_1.dtd?version=1" title="cayenne-data-view-1_1.dtd attached to Guide to 1.1 features">cayenne-data-view-1_1.dtd<sup><img class="rendericon" src="../../../../images/link_attachment_7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span></li>
+ <li><span class="nobr"><a href="cayenne-driver-1_1.dtd?version=1" title="cayenne-driver-1_1.dtd attached to Guide to 1.1 features">cayenne-driver-1_1.dtd<sup><img class="rendericon" src="../../../../images/link_attachment_7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span></li>
+</ul>
+
+
+<table cellpadding='5' width='85%' cellspacing='8px' class='warningMacro' border="0" align='center'><colgroup><col width='24'><col></colgroup><tr><td valign='top'><img src="../../../../images/emoticons/forbidden.gif" width="16" height="16" align="absmiddle" alt="" border="0"></td><td><b class="strong">Upgrade Warning</b><br />Saving projects with CayenneModeler v.1.1 will render them uneditable with CayenneModeler v.1.0.</td></tr></table>
+
+<h3><a name="Guideto1.1features-AdvancedLocalandDistributedCaching"></a>Advanced Local and Distributed Caching</h3>
+
+<p>Cayenne now provides a way to share its object cache between DataContexts in the same JVM and across JVMs. The following chapters in the user guide describe this feature:</p>
+<ul>
+ <li><a href="../../../../Documentation/User Guide/Design/How Information Is Stored in Cayenne/index.html" title="How Information Is Stored in Cayenne">How Information Is Stored in Cayenne</a></li>
+ <li><a href="../../../../Documentation/User Guide/Design/Understanding Caching/index.html" title="Understanding Caching">Understanding Caching</a></li>
+ <li><span class="error">[Caching Query Result Lists]</span></li>
+ <li><a href="../../../../Documentation/User Guide/Performance Tuning/Caching Lookup Tables/index.html" title="Caching Lookup Tables">Caching Lookup Tables</a></li>
+</ul>
+
+
+<h3><a name="Guideto1.1features-OptimisticLocking"></a>Optimistic Locking</h3>
+
+<p>ObjAttributes and ObjRelationships can be marked to be used for "optimistic" locking. If an corresponding columns of the underlying database row are externally modified, an attempt to save an object results in OptimisticLockingException.</p>
+
+<h3><a name="Guideto1.1features-DataObjectUtilsaneasywaytomapobjectsbyPK"></a>DataObjectUtils - an easy way to map objects by PK</h3>
+
+<p><a href="../../../../Documentation/User Guide/DataObjects/DataObjectUtils/index.html" title="DataObjectUtils">DataObjectUtils</a> is an often requested feature for easy retrieval of an object primary key, or locating an object for a known key. It works in a generic way for any type of DataObjects, even if a PK is not a class property.</p>
+
+<h3><a name="Guideto1.1features-EntityInheritance"></a>Entity Inheritance</h3>
+
+<p>Cayenne now supports entity inheritance for entities rooted in the same DB table (single table inheritance).</p>
+
+<h3><a name="Guideto1.1features-DataViewsandDVModeler"></a>Data Views and DVModeler</h3>
+
+<p><span class="error">[Data Views]</span> is a completely new addition to Cayenne. This is a framework and a Swing modeler tool to quickly build Swing applications based on Cayenne.</p>
+
+<h3><a name="Guideto1.1features-GenericMultithreadedandDistributedEventsMechanism"></a>Generic Multithreaded and Distributed Events Mechanism</h3>
+
+<p>Cayenne now includes a generic <a href="../../../../Documentation/User Guide/Design/Event Package/index.html" title="Event Package">event package</a> "org.objectstyle.cayenne.event" for registering listeners and sending events, both locally and remotely. It supports both blocking and non-blocking listeners and dispatches. Supported remote transports include JMS and JavaGroups.</p>
+
+<h3><a name="Guideto1.1features-DataObjectsValidation"></a>DataObjects Validation</h3>
+
+<p>DataContext now performs validation of DataObjects before committing them. There is a set of default validation checks being executed, based on the DataMap information. Developers can override DataObject validation methods to provide custom validation checks.</p>
+
+<p>See user guide chapter on <span class="error">[object validation]</span>.</p>
+
+<p>Original implementation was submitted by Fabricio Voznika.</p>
+
+<h3><a name="Guideto1.1features-ExpressionAPIEnhancements"></a>Expression API Enhancements</h3>
+
+<p>There is a new expression parser that allows creation of complex expressions from strings ("Expression.fromString(..)"). This greatly reduces the amount of code needed to build an expression.</p>
+
+<p>In-memory evaluation API is improved, and now supports both boolean conditions (via "Expression.match" method) and generic expressions evaluation (via "Expression.evaluate" method), it also includes support for arithmetic operations.</p>
+<ul>
+ <li><a href="../../../../Documentation/User Guide/Expressions/index.html" title="Expressions">Expressions</a></li>
+</ul>
+
+
+<h3><a name="Guideto1.1features-SQLTemplateADynamicRawSQLQuery"></a>SQLTemplate - A Dynamic Raw SQL Query</h3>
+
+<p>SQLTemplate replaces SqlSelectQuery and SqlModifyQuery and is a scriptable parameterized raw SQL query. It supports DataObjects and other features declared in GenericSelectQuery interface.</p>
+<ul>
+ <li><span class="error">[SQLTemplate Overview]</span></li>
+ <li><span class="error">[SQLTemplate Scripting]</span></li>
+</ul>
+
+
+<h3><a name="Guideto1.1features-DataContextAPIforRunningParameterizedNamedQueries"></a>DataContext API for Running Parameterized Named Queries</h3>
+
+<p>DataContext now provides simple API to run SelectQuery, SQLTemplate and ProcedureQuery by name if such queries are mapped via CayenneModeler:</p>
+<ul>
+ <li><a href="../../../../Documentation/User Guide/DataContext/index.html" title="DataContext">DataContext Query API Overview</a></li>
+</ul>
+
+
+<h3><a name="Guideto1.1features-SupportforSharedMappingNamespace"></a>Support for Shared Mapping Namespace</h3>
+
+<p>DataDomain now provides a shared mapping namespace. This means that all mapping objects can reference other mapping objects outside their DataMaps. For example two DbEntities can be located in different DataMaps and still have relationships to each other.</p>
+
+<p>Temporary limitation of the shared mapping namespace is that Queries stored in the DataMap can't have a "root" from a different DataMap.</p>
+
+<h3><a name="Guideto1.1features-SnapshotEvents"></a>SnapshotEvents</h3>
+
+
+<h3><a name="Guideto1.1features-DataContextDelegate"></a>DataContextDelegate</h3>
+
+
+<h3><a name="Guideto1.1features-EntityRestrictingQualifier"></a>Entity Restricting Qualifier</h3>
+
+<p>ObjEntities now can hold a qualifier expression that is automatically appended to any query qualifiers, thus creating a global data filter for a given entity. This feature is used for inheritance mapping, however it has nothing to do with inheritance as such and can be used all by itself.</p>
+
+<h3><a name="Guideto1.1features-ExplicitTransactionAPIandContainerManagedTransactions"></a>Explicit Transaction API and Container Managed Transactions</h3>
+
+<p>Cayenne now supports container-managed transactions. As a result it can be used inside EJBs out of the box. It also allows a high degree of transactions customization. The following user guide chapter explains Transactions design and behavior in details:</p>
+<ul>
+ <li><a href="http://www.objectstyle.org/confluence/confluence/display/CAYDOC/Design#Design-CayenneTransactions" title="Cayenne Transactions on Design">Understanding Transactions</a></li>
+</ul>
+
+
+<h3><a name="Guideto1.1features-VariousPerformanceEnhancements"></a>Various Performance Enhancements</h3>
+
+<ul>
+ <li>Lazy Relationship Creation - when new objects are fetched, their relationships are not initialized immediately; a Fault singleton is used isntead as a placeholder. Of course in the past Cayenne also had "lazy" relationships, meaning that they didn't get resolved via a DB query until accessed. Current optimization goes further - it prevents a number of Java objects (such as empty Lists for to-many relationship, or "hollow" DataObjects for to-ones) from being created until absolutely necessary.</li>
+ <li>To-many relationships do not have to be fully resolved on modification - if an unresolved to-many relationship is modified (i.e. an object is added or removed from it), it is not resolved until the next "read" (i.e. until a call to "size()" or "iterator()" method). This is especially helpful with bi-directional one-to-many relationships. E.g. "painting.addToArtist(artist)" used to trigger the fetch of all paintings that belong to an artist. Not anymore.</li>
+</ul>
+
+
+<h3><a name="Guideto1.1features-MoreDatabasesHaveCustomDbAdapters"></a>More Databases Have Custom DbAdapters</h3>
+
+<p>Cayenne features new database adapters:</p>
+<ul>
+ <li>OpenBase Adapter</li>
+ <li>MS SQL Server Adapter</li>
+</ul>
+
+
+<h3><a name="Guideto1.1features-SupportforToOneRelationshipsNotPointingtoaPK."></a>Support for To-One Relationships Not Pointing to a PK.</h3>
+
+<p>Added support for one-to-one relationships between PK and non-PK columns of related tables. In the past this could only be modeled as one-to-many. CayenneModeler will create UNIQUE constraint for a non-PK columns during schema generation.</p>
+
+<h3><a name="Guideto1.1features-SupportforQueriesinDataMapDTD."></a>Support for Queries in DataMap DTD.</h3>
+
+<p>Queries are made first-class mapping objects. They can be modeled in CayenneModeler and stored in DataMaps. Application code can then reuse such queries.</p>
+<ul>
+ <li><a href="../../../../Documentation/Modeler Guide/Modeling Queries/index.html" title="Modeling Queries">Modeling Queries</a></li>
+ <li><span class="error">[Using Mapped Queries]</span></li>
+</ul>
+
+
+<h3><a name="Guideto1.1features-NonrefreshingSelectQueries"></a>Non-refreshing Select Queries</h3>
+
+
+<h3><a name="Guideto1.1features-CayenneModelerEnhancements."></a>CayenneModeler Enhancements.</h3>
+
+<p>The following is an incomplete list of enhancements: new professional look and feel, preference engine, reenginnering of stored procedures, local DataSources, configurable locations of JDBC drivers, custom class generation templates, etc. A number of Modeler tasks and dialogs have been redesigned and improved to be more user-friendly and consistent.</p>
+
+<p>Also CayenneModeler supports mapping of all the new 1.1 framework features, such as DataMap queries, cache synchronization configuration, etc.</p></div>
+</div>
+ <div class="clearer">.</div>
+ <div style="height: 12px; background-image: url('../../../../images/border_bottom.gif'); background-repeat: repeat-x;"></div>
+
+ <div class="smalltext copyright">
+ Copyright ©2001-2006 ObjectStyle Group and content authors
+ </div>
+
+</body>
+</html>
Propchange: incubator/cayenne/main/trunk/cayenne/cayenne-other/wiki-docs/Documentation/User Guide/Introduction/Guide to 1.1 features/index.html
------------------------------------------------------------------------------
svn:eol-style = native