You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cayenne.apache.org by bu...@apache.org on 2012/11/09 08:29:36 UTC
svn commit: r837766 [17/23] - in /websites/staging/cayenne/trunk/content: ./
docs/ docs/1.2/ docs/2.0/ docs/3.0/ docs/3.1/
Modified: websites/staging/cayenne/trunk/content/docs/3.0/dataobject-validation.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/dataobject-validation.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/dataobject-validation.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » DataObject Validation
-
- <P>DataObject implements a set of methods to validate its state. DataContext calls these methods before performing a commit. If validation fails, the commit is aborted with ValidationException. There are a few clear benefits of validating DataObjects at the application level before committing them to the database:</P>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang="en">
+<head>
+<title>Apache Cayenne » 3.0 » DataObject Validation</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="Apache Cayenne is a powerful, full-featured, open-source object relational mapping framework created for developers working with relational databases.">
+<link rel="stylesheet" type="text/css" media="screen, projection" href="/css/styles.css">
+<link rel="stylesheet" type="text/css" media="print" href="/css/print.css">
+<link rel="shortcut icon" href="/img/favicon.ico" type="image/ico">
+<script type="text/javascript" src="/js/scripts.js"></script>
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-7036673-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ 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>
+<div id="wrap"><div id="wrap-inner">
+
+<div id="header">
+ <h1><a href="/" title="Return to Apache Cayenne home"><span>The Apache Cayenne Project</span></a></h1>
+ <h2><a href="http://www.apache.org" title="The Apache Software Foundation"><span>The Apache Software Foundation</span></a></h2>
+</div>
+
+<div id="container">
+
+
+<div id="sidebar">
+<ul id="nav">
+ <li><a href="/docs/3.0/index.html">3.0.x Documentation</a>
+ <ul>
+ <li><a href="/docs/3.0/overview.html">Overview</a></li>
+ <li><a href="/docs/3.0/cayenne-guide.html">Cayenne Guide</a></li>
+ <li><a href="/docs/3.0/remote-object-persistence-guide.html">Remote Client Guide</a></li>
+ <li><a href="/docs/3.0/modeler-guide.html">Modeler Guide</a></li>
+ <li><a href="/docs/3.0/api/index.html">JavaDoc</a></li>
+ <li><a href="/index.html">Back...</a>
+ </ul>
+ </li>
+</ul>
+</div>
+
+
+<hr>
+<div id="content">
+ <P>DataObject implements a set of methods to validate its state. DataContext calls these methods before performing a commit. If validation fails, the commit is aborted with ValidationException. There are a few clear benefits of validating DataObjects at the application level before committing them to the database:</P>
<UL>
<LI>Cayenne can leverage ORM metadata (DataMap) to check for many standard error conditions.</LI>
@@ -62,3 +110,12 @@ Title: 3.0 » DataObject Validation
<H2><A name="DataObjectValidation-TurningValidationOn%2FOff"></A>Turning Validation On/Off</H2>
<P>Whether DataContext performs validation at all depends on the value of its property <TT>validatingObjectsOnCommit</TT>. Calling <TT>isValidatingObjectsOnCommit()</TT> returns currently configured value. Default value (usually "true") is propagated from the parent DataDomain when DataContext is created. This default value can be configured using CayenneModeler as described in <A href="configuring-object-validation.html" title="Configuring Object Validation">Configuring Object Validation</A> section.</P>
+
+ <hr>
+ <p id="footer">Copyright © 2001-2012 Apache Software Foundation. Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache Cayenne project logo are trademarks of The Apache Software Foundation. <a href="/privacy-policy.html">Privacy policy</a>.
+</div>
+</div>
+
+</div></div>
+</body>
+</html>
Modified: websites/staging/cayenne/trunk/content/docs/3.0/dataobjects-example.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/dataobjects-example.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/dataobjects-example.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » DataObjects Example
-
- <P>As discussed in <A href="dataobjects.html" title="DataObjects">DataContext</A> chapter, any changes made to the DataObjects via "set*" methods are synchronized with the database by calling <TT>DataContext.commitChanges</TT>. Here is an example showing how the <TT>Painting</TT> object is fetched, modified and saved back. The following modifications are performed: the price of the first retrieved painting is doubled, a new painting is added that belongs to the same artist as the painting fetched before:</P>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang="en">
+<head>
+<title>Apache Cayenne » 3.0 » DataObjects Example</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="Apache Cayenne is a powerful, full-featured, open-source object relational mapping framework created for developers working with relational databases.">
+<link rel="stylesheet" type="text/css" media="screen, projection" href="/css/styles.css">
+<link rel="stylesheet" type="text/css" media="print" href="/css/print.css">
+<link rel="shortcut icon" href="/img/favicon.ico" type="image/ico">
+<script type="text/javascript" src="/js/scripts.js"></script>
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-7036673-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ 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>
+<div id="wrap"><div id="wrap-inner">
+
+<div id="header">
+ <h1><a href="/" title="Return to Apache Cayenne home"><span>The Apache Cayenne Project</span></a></h1>
+ <h2><a href="http://www.apache.org" title="The Apache Software Foundation"><span>The Apache Software Foundation</span></a></h2>
+</div>
+
+<div id="container">
+
+
+<div id="sidebar">
+<ul id="nav">
+ <li><a href="/docs/3.0/index.html">3.0.x Documentation</a>
+ <ul>
+ <li><a href="/docs/3.0/overview.html">Overview</a></li>
+ <li><a href="/docs/3.0/cayenne-guide.html">Cayenne Guide</a></li>
+ <li><a href="/docs/3.0/remote-object-persistence-guide.html">Remote Client Guide</a></li>
+ <li><a href="/docs/3.0/modeler-guide.html">Modeler Guide</a></li>
+ <li><a href="/docs/3.0/api/index.html">JavaDoc</a></li>
+ <li><a href="/index.html">Back...</a>
+ </ul>
+ </li>
+</ul>
+</div>
+
+
+<hr>
+<div id="content">
+ <P>As discussed in <A href="dataobjects.html" title="DataObjects">DataContext</A> chapter, any changes made to the DataObjects via "set*" methods are synchronized with the database by calling <TT>DataContext.commitChanges</TT>. Here is an example showing how the <TT>Painting</TT> object is fetched, modified and saved back. The following modifications are performed: the price of the first retrieved painting is doubled, a new painting is added that belongs to the same artist as the painting fetched before:</P>
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-java">
<SPAN class="code-keyword">import</SPAN> java.math.BigDecimal;
@@ -61,3 +109,12 @@ List realExpensiveArt = ctxt.performQuer
[main 12-22 15:50:19] QueryLogger: +++ transaction committed.
</PRE>
</DIV></DIV>
+
+ <hr>
+ <p id="footer">Copyright © 2001-2012 Apache Software Foundation. Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache Cayenne project logo are trademarks of The Apache Software Foundation. <a href="/privacy-policy.html">Privacy policy</a>.
+</div>
+</div>
+
+</div></div>
+</body>
+</html>
Modified: websites/staging/cayenne/trunk/content/docs/3.0/dataobjects.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/dataobjects.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/dataobjects.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » DataObjects
-
- <H2><A name="DataObjects-DataObjects"></A>DataObjects</H2>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang="en">
+<head>
+<title>Apache Cayenne » 3.0 » DataObjects</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="Apache Cayenne is a powerful, full-featured, open-source object relational mapping framework created for developers working with relational databases.">
+<link rel="stylesheet" type="text/css" media="screen, projection" href="/css/styles.css">
+<link rel="stylesheet" type="text/css" media="print" href="/css/print.css">
+<link rel="shortcut icon" href="/img/favicon.ico" type="image/ico">
+<script type="text/javascript" src="/js/scripts.js"></script>
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-7036673-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ 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>
+<div id="wrap"><div id="wrap-inner">
+
+<div id="header">
+ <h1><a href="/" title="Return to Apache Cayenne home"><span>The Apache Cayenne Project</span></a></h1>
+ <h2><a href="http://www.apache.org" title="The Apache Software Foundation"><span>The Apache Software Foundation</span></a></h2>
+</div>
+
+<div id="container">
+
+
+<div id="sidebar">
+<ul id="nav">
+ <li><a href="/docs/3.0/index.html">3.0.x Documentation</a>
+ <ul>
+ <li><a href="/docs/3.0/overview.html">Overview</a></li>
+ <li><a href="/docs/3.0/cayenne-guide.html">Cayenne Guide</a></li>
+ <li><a href="/docs/3.0/remote-object-persistence-guide.html">Remote Client Guide</a></li>
+ <li><a href="/docs/3.0/modeler-guide.html">Modeler Guide</a></li>
+ <li><a href="/docs/3.0/api/index.html">JavaDoc</a></li>
+ <li><a href="/index.html">Back...</a>
+ </ul>
+ </li>
+</ul>
+</div>
+
+
+<hr>
+<div id="content">
+ <H2><A name="DataObjects-DataObjects"></A>DataObjects</H2>
<P>DataObjects (Cayenne persistent objects) are composed of attributes and relationships. Attributes are the simplest object properties (as in "java bean properties") that can be stored in the columns in the database. Those are usually string, numeric, binary or date values. Another type of properties is relationships. They represent related DataObjects (to-one relationships) or collections of DataObjects (to-many relationships). To read and modify attributes and relationships, application code would simply invoke corresponding get or set methods. In case of to-many relationships represented by collections there are also add and remove methods.</P>
<P>Queries discussed in the previous chapter are used to obtain the initial sets of DataObjects. After that a graph of persistent objects is navigated and modified via relationship methods, thus hiding the underlying relational storage complexity and giving application a nice object view of the relevant subset of the database data.</P>
@@ -23,3 +71,12 @@ Title: 3.0 » DataObjects
</OL>
+
+ <hr>
+ <p id="footer">Copyright © 2001-2012 Apache Software Foundation. Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache Cayenne project logo are trademarks of The Apache Software Foundation. <a href="/privacy-policy.html">Privacy policy</a>.
+</div>
+</div>
+
+</div></div>
+</body>
+</html>
Modified: websites/staging/cayenne/trunk/content/docs/3.0/dataobjectutils.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/dataobjectutils.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/dataobjectutils.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » DataObjectUtils
-
- <P>DataObjectUtils class provides an important and easy to use facility to obtain a primary key value from a DataObject and to locate a DataObject in the database for a known primary key. Both operations work in a generic fashion and do not require primary key to be an object property.</P>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang="en">
+<head>
+<title>Apache Cayenne » 3.0 » DataObjectUtils</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="Apache Cayenne is a powerful, full-featured, open-source object relational mapping framework created for developers working with relational databases.">
+<link rel="stylesheet" type="text/css" media="screen, projection" href="/css/styles.css">
+<link rel="stylesheet" type="text/css" media="print" href="/css/print.css">
+<link rel="shortcut icon" href="/img/favicon.ico" type="image/ico">
+<script type="text/javascript" src="/js/scripts.js"></script>
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-7036673-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ 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>
+<div id="wrap"><div id="wrap-inner">
+
+<div id="header">
+ <h1><a href="/" title="Return to Apache Cayenne home"><span>The Apache Cayenne Project</span></a></h1>
+ <h2><a href="http://www.apache.org" title="The Apache Software Foundation"><span>The Apache Software Foundation</span></a></h2>
+</div>
+
+<div id="container">
+
+
+<div id="sidebar">
+<ul id="nav">
+ <li><a href="/docs/3.0/index.html">3.0.x Documentation</a>
+ <ul>
+ <li><a href="/docs/3.0/overview.html">Overview</a></li>
+ <li><a href="/docs/3.0/cayenne-guide.html">Cayenne Guide</a></li>
+ <li><a href="/docs/3.0/remote-object-persistence-guide.html">Remote Client Guide</a></li>
+ <li><a href="/docs/3.0/modeler-guide.html">Modeler Guide</a></li>
+ <li><a href="/docs/3.0/api/index.html">JavaDoc</a></li>
+ <li><a href="/index.html">Back...</a>
+ </ul>
+ </li>
+</ul>
+</div>
+
+
+<hr>
+<div id="content">
+ <P>DataObjectUtils class provides an important and easy to use facility to obtain a primary key value from a DataObject and to locate a DataObject in the database for a known primary key. Both operations work in a generic fashion and do not require primary key to be an object property.</P>
<DIV class="panelMacro"><TABLE class="warningMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="https://cwiki.apache.org/confluence/images/icons/emoticons/forbidden.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B>Security Warning</B><BR>DataObjectUtils make it very easy to use a primary key value as a universal "code" for an object in web forms and URLs. This opens a potential security hole in the interface. If application code is not careful enough, a malicious user can gain access to the information she is not allowed to see (e.g. other people's accounts) simply by trying a series of sequential numbers. So, for example, it is probably okay to use product PK to build a bookmarkable link to a catalog product, but it may not be appropriate to do that for a private user profile record.</TD></TR></TABLE></DIV>
@@ -27,3 +75,12 @@ DataContext context = ...;
}
</PRE>
</DIV></DIV>
+
+ <hr>
+ <p id="footer">Copyright © 2001-2012 Apache Software Foundation. Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache Cayenne project logo are trademarks of The Apache Software Foundation. <a href="/privacy-policy.html">Privacy policy</a>.
+</div>
+</div>
+
+</div></div>
+</body>
+</html>
Modified: websites/staging/cayenne/trunk/content/docs/3.0/datasource.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/datasource.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/datasource.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,63 @@
-Title: 3.0 » DataSource
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang="en">
+<head>
+<title>Apache Cayenne » 3.0 » DataSource</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="Apache Cayenne is a powerful, full-featured, open-source object relational mapping framework created for developers working with relational databases.">
+<link rel="stylesheet" type="text/css" media="screen, projection" href="/css/styles.css">
+<link rel="stylesheet" type="text/css" media="print" href="/css/print.css">
+<link rel="shortcut icon" href="/img/favicon.ico" type="image/ico">
+<script type="text/javascript" src="/js/scripts.js"></script>
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-7036673-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ 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>
+<div id="wrap"><div id="wrap-inner">
- <P><A href="datanode.html" title="DataNode">DataNode</A> obtains connections via a <TT>javax.sql.DataSource</TT>. If an application is deployed in a J2EE container, DataSource is normally provided by container <A href="using-jndi.html" title="Using JNDI">via JNDI</A>. For standalone applications (or if you don't want to use JNDI) Cayenne provides its own DataSource that includes connection pooling features. Whenever you select <TT>org.apache.cayenne.conf.DriverDataSourceFactory</TT> in the Modeler, you are choosing to use Cayenne DataSource. </P>
+<div id="header">
+ <h1><a href="/" title="Return to Apache Cayenne home"><span>The Apache Cayenne Project</span></a></h1>
+ <h2><a href="http://www.apache.org" title="The Apache Software Foundation"><span>The Apache Software Foundation</span></a></h2>
+</div>
+
+<div id="container">
+
+
+<div id="sidebar">
+<ul id="nav">
+ <li><a href="/docs/3.0/index.html">3.0.x Documentation</a>
+ <ul>
+ <li><a href="/docs/3.0/overview.html">Overview</a></li>
+ <li><a href="/docs/3.0/cayenne-guide.html">Cayenne Guide</a></li>
+ <li><a href="/docs/3.0/remote-object-persistence-guide.html">Remote Client Guide</a></li>
+ <li><a href="/docs/3.0/modeler-guide.html">Modeler Guide</a></li>
+ <li><a href="/docs/3.0/api/index.html">JavaDoc</a></li>
+ <li><a href="/index.html">Back...</a>
+ </ul>
+ </li>
+</ul>
+</div>
+
+
+<hr>
+<div id="content">
+ <P><A href="datanode.html" title="DataNode">DataNode</A> obtains connections via a <TT>javax.sql.DataSource</TT>. If an application is deployed in a J2EE container, DataSource is normally provided by container <A href="using-jndi.html" title="Using JNDI">via JNDI</A>. For standalone applications (or if you don't want to use JNDI) Cayenne provides its own DataSource that includes connection pooling features. Whenever you select <TT>org.apache.cayenne.conf.DriverDataSourceFactory</TT> in the Modeler, you are choosing to use Cayenne DataSource. </P>
<P>Cayenne DataSource implementation is located in the <TT>org.apache.cayenne.conn</TT> package and is fully independent from the rest of the framework. Since Cayenne DataSource is chosen automatically, users rarely need to know more details. One notable exception are applications requiring users to interactively <A href="http://cwiki.apache.org/CAY/setting-database-connection.html" class="external-link" rel="nofollow">enter database login information</A>. In this case you can write your own DataSource wrapper, and internally instantiate Cayenne DataSource (<TT>org.apache.cayenne.conn.PoolManager</TT>) after the user provides login and password.</P>
+
+ <hr>
+ <p id="footer">Copyright © 2001-2012 Apache Software Foundation. Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache Cayenne project logo are trademarks of The Apache Software Foundation. <a href="/privacy-policy.html">Privacy policy</a>.
+</div>
+</div>
+
+</div></div>
+</body>
+</html>
Modified: websites/staging/cayenne/trunk/content/docs/3.0/dbadapter.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/dbadapter.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/dbadapter.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » DbAdapter
-
- <H3><A name="DbAdapter-PortabilityAcrossDatabases"></A>Portability Across Databases</H3>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang="en">
+<head>
+<title>Apache Cayenne » 3.0 » DbAdapter</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="Apache Cayenne is a powerful, full-featured, open-source object relational mapping framework created for developers working with relational databases.">
+<link rel="stylesheet" type="text/css" media="screen, projection" href="/css/styles.css">
+<link rel="stylesheet" type="text/css" media="print" href="/css/print.css">
+<link rel="shortcut icon" href="/img/favicon.ico" type="image/ico">
+<script type="text/javascript" src="/js/scripts.js"></script>
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-7036673-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ 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>
+<div id="wrap"><div id="wrap-inner">
+
+<div id="header">
+ <h1><a href="/" title="Return to Apache Cayenne home"><span>The Apache Cayenne Project</span></a></h1>
+ <h2><a href="http://www.apache.org" title="The Apache Software Foundation"><span>The Apache Software Foundation</span></a></h2>
+</div>
+
+<div id="container">
+
+
+<div id="sidebar">
+<ul id="nav">
+ <li><a href="/docs/3.0/index.html">3.0.x Documentation</a>
+ <ul>
+ <li><a href="/docs/3.0/overview.html">Overview</a></li>
+ <li><a href="/docs/3.0/cayenne-guide.html">Cayenne Guide</a></li>
+ <li><a href="/docs/3.0/remote-object-persistence-guide.html">Remote Client Guide</a></li>
+ <li><a href="/docs/3.0/modeler-guide.html">Modeler Guide</a></li>
+ <li><a href="/docs/3.0/api/index.html">JavaDoc</a></li>
+ <li><a href="/index.html">Back...</a>
+ </ul>
+ </li>
+</ul>
+</div>
+
+
+<hr>
+<div id="content">
+ <H3><A name="DbAdapter-PortabilityAcrossDatabases"></A>Portability Across Databases</H3>
<P>The JDBC specification provides a great abstraction for relational database work. Still in practice some cross-database portability issues remain:</P>
@@ -20,3 +68,12 @@ Title: 3.0 » DbAdapter
<P>Usually Cayenne detects the type of the database dynamically and installs the right adapter in runtime. However a user can enforce a specific adapter class by entering its name using "Adapter" tab in the DataNode Editor panel in CayenneModeler. Alternatively an adapter can be set on a DataNode via a method call.</P>
+
+ <hr>
+ <p id="footer">Copyright © 2001-2012 Apache Software Foundation. Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache Cayenne project logo are trademarks of The Apache Software Foundation. <a href="/privacy-policy.html">Privacy policy</a>.
+</div>
+</div>
+
+</div></div>
+</body>
+</html>
Modified: websites/staging/cayenne/trunk/content/docs/3.0/dbcpdatasourcefactory.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/dbcpdatasourcefactory.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/dbcpdatasourcefactory.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » DBCPDataSourceFactory
-
- <P>As an alternative to a simple and easy-to-use DataSource bundled with Cayenne, it is possible to configure a more feature-rich DataSource based on Apache Jakarta <A href="http://jakarta.apache.org/commons/dbcp" class="external-link" rel="nofollow">commons-dbcp</A>. To enable commons-dbcp pool, select <TT>DBCPDataSourceFactory</TT> in the Modeler for a DataNode:</P>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang="en">
+<head>
+<title>Apache Cayenne » 3.0 » DBCPDataSourceFactory</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="Apache Cayenne is a powerful, full-featured, open-source object relational mapping framework created for developers working with relational databases.">
+<link rel="stylesheet" type="text/css" media="screen, projection" href="/css/styles.css">
+<link rel="stylesheet" type="text/css" media="print" href="/css/print.css">
+<link rel="shortcut icon" href="/img/favicon.ico" type="image/ico">
+<script type="text/javascript" src="/js/scripts.js"></script>
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-7036673-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ 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>
+<div id="wrap"><div id="wrap-inner">
+
+<div id="header">
+ <h1><a href="/" title="Return to Apache Cayenne home"><span>The Apache Cayenne Project</span></a></h1>
+ <h2><a href="http://www.apache.org" title="The Apache Software Foundation"><span>The Apache Software Foundation</span></a></h2>
+</div>
+
+<div id="container">
+
+
+<div id="sidebar">
+<ul id="nav">
+ <li><a href="/docs/3.0/index.html">3.0.x Documentation</a>
+ <ul>
+ <li><a href="/docs/3.0/overview.html">Overview</a></li>
+ <li><a href="/docs/3.0/cayenne-guide.html">Cayenne Guide</a></li>
+ <li><a href="/docs/3.0/remote-object-persistence-guide.html">Remote Client Guide</a></li>
+ <li><a href="/docs/3.0/modeler-guide.html">Modeler Guide</a></li>
+ <li><a href="/docs/3.0/api/index.html">JavaDoc</a></li>
+ <li><a href="/index.html">Back...</a>
+ </ul>
+ </li>
+</ul>
+</div>
+
+
+<hr>
+<div id="content">
+ <P>As an alternative to a simple and easy-to-use DataSource bundled with Cayenne, it is possible to configure a more feature-rich DataSource based on Apache Jakarta <A href="http://jakarta.apache.org/commons/dbcp" class="external-link" rel="nofollow">commons-dbcp</A>. To enable commons-dbcp pool, select <TT>DBCPDataSourceFactory</TT> in the Modeler for a DataNode:</P>
<P><SPAN class="image-wrap" style=""><IMG src="dbcpdatasourcefactory.data/dbcp-step1.jpg" style="border: 0px solid black"></SPAN></P>
@@ -193,3 +241,12 @@ cayenne.dbcp.maxWait=10000</PRE>
</TBODY></TABLE>
</DIV>
+
+ <hr>
+ <p id="footer">Copyright © 2001-2012 Apache Software Foundation. Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache Cayenne project logo are trademarks of The Apache Software Foundation. <a href="/privacy-policy.html">Privacy policy</a>.
+</div>
+</div>
+
+</div></div>
+</body>
+</html>
Modified: websites/staging/cayenne/trunk/content/docs/3.0/delete-rules.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/delete-rules.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/delete-rules.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » Delete Rules
-
-
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang="en">
+<head>
+<title>Apache Cayenne » 3.0 » Delete Rules</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="Apache Cayenne is a powerful, full-featured, open-source object relational mapping framework created for developers working with relational databases.">
+<link rel="stylesheet" type="text/css" media="screen, projection" href="/css/styles.css">
+<link rel="stylesheet" type="text/css" media="print" href="/css/print.css">
+<link rel="shortcut icon" href="/img/favicon.ico" type="image/ico">
+<script type="text/javascript" src="/js/scripts.js"></script>
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-7036673-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ 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>
+<div id="wrap"><div id="wrap-inner">
+
+<div id="header">
+ <h1><a href="/" title="Return to Apache Cayenne home"><span>The Apache Cayenne Project</span></a></h1>
+ <h2><a href="http://www.apache.org" title="The Apache Software Foundation"><span>The Apache Software Foundation</span></a></h2>
+</div>
+
+<div id="container">
+
+
+<div id="sidebar">
+<ul id="nav">
+ <li><a href="/docs/3.0/index.html">3.0.x Documentation</a>
+ <ul>
+ <li><a href="/docs/3.0/overview.html">Overview</a></li>
+ <li><a href="/docs/3.0/cayenne-guide.html">Cayenne Guide</a></li>
+ <li><a href="/docs/3.0/remote-object-persistence-guide.html">Remote Client Guide</a></li>
+ <li><a href="/docs/3.0/modeler-guide.html">Modeler Guide</a></li>
+ <li><a href="/docs/3.0/api/index.html">JavaDoc</a></li>
+ <li><a href="/index.html">Back...</a>
+ </ul>
+ </li>
+</ul>
+</div>
+
+
+<hr>
+<div id="content">
+
<H3><A name="DeleteRules-DeleteRules"></A>Delete Rules</H3>
<P>One of the columns in the Modeler ObjRelationships panel is "Delete Rule". It tells Cayenne what to do with related objects when a <B>source object</B> of the relationship is deleted. Cayenne will use this delete rule to perform cleanup of other objects after a given object was deleted from the graph. </P>
@@ -23,3 +71,12 @@ Title: 3.0 » Delete Rules
<DIV class="panelMacro"><TABLE class="noteMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="https://cwiki.apache.org/confluence/images/icons/emoticons/warning.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B>Cayenne Delete Rules vs. DB Delete Rules</B><BR>Some databases allow to define delete rules logically similar to the rules described above. Cayenne rules differ from DB rules in that they deal with object graph instead of relational schema. Some changes to the object graph will result in database operations (e.g. resetting FK to NULL as a result of Nullify rule), some others will not (e.g. removing a deleted DataObject from the to-many array as a result of another Nullify rule).</TD></TR></TABLE></DIV>
+
+ <hr>
+ <p id="footer">Copyright © 2001-2012 Apache Software Foundation. Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache Cayenne project logo are trademarks of The Apache Software Foundation. <a href="/privacy-policy.html">Privacy policy</a>.
+</div>
+</div>
+
+</div></div>
+</body>
+</html>
Modified: websites/staging/cayenne/trunk/content/docs/3.0/deleting-objects.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/deleting-objects.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/deleting-objects.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » Deleting Objects
-
- <P>As discussed before, an object must be deleted in the DataContext to trigger a removal of the corresponding row from the database on commit. There are few simple ways to delete individual objects and collections of objects. Quite naturally, a delete operation changes the object state to PersistenceState.DELETED. However there maybe other consequences of such operation for the overall object graph. Such consequences are controlled via <A href="delete-rules.html" title="Delete Rules">Delete Rules</A> configured for object relationships. Properly configuring delete rules will simplify the application code, as you no longer need to track related objects and do the right thing with them. Other delete rule effects are discussed for each DataContext deletion method individually.</P>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang="en">
+<head>
+<title>Apache Cayenne » 3.0 » Deleting Objects</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="Apache Cayenne is a powerful, full-featured, open-source object relational mapping framework created for developers working with relational databases.">
+<link rel="stylesheet" type="text/css" media="screen, projection" href="/css/styles.css">
+<link rel="stylesheet" type="text/css" media="print" href="/css/print.css">
+<link rel="shortcut icon" href="/img/favicon.ico" type="image/ico">
+<script type="text/javascript" src="/js/scripts.js"></script>
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-7036673-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ 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>
+<div id="wrap"><div id="wrap-inner">
+
+<div id="header">
+ <h1><a href="/" title="Return to Apache Cayenne home"><span>The Apache Cayenne Project</span></a></h1>
+ <h2><a href="http://www.apache.org" title="The Apache Software Foundation"><span>The Apache Software Foundation</span></a></h2>
+</div>
+
+<div id="container">
+
+
+<div id="sidebar">
+<ul id="nav">
+ <li><a href="/docs/3.0/index.html">3.0.x Documentation</a>
+ <ul>
+ <li><a href="/docs/3.0/overview.html">Overview</a></li>
+ <li><a href="/docs/3.0/cayenne-guide.html">Cayenne Guide</a></li>
+ <li><a href="/docs/3.0/remote-object-persistence-guide.html">Remote Client Guide</a></li>
+ <li><a href="/docs/3.0/modeler-guide.html">Modeler Guide</a></li>
+ <li><a href="/docs/3.0/api/index.html">JavaDoc</a></li>
+ <li><a href="/index.html">Back...</a>
+ </ul>
+ </li>
+</ul>
+</div>
+
+
+<hr>
+<div id="content">
+ <P>As discussed before, an object must be deleted in the DataContext to trigger a removal of the corresponding row from the database on commit. There are few simple ways to delete individual objects and collections of objects. Quite naturally, a delete operation changes the object state to PersistenceState.DELETED. However there maybe other consequences of such operation for the overall object graph. Such consequences are controlled via <A href="delete-rules.html" title="Delete Rules">Delete Rules</A> configured for object relationships. Properly configuring delete rules will simplify the application code, as you no longer need to track related objects and do the right thing with them. Other delete rule effects are discussed for each DataContext deletion method individually.</P>
<H5><A name="DeletingObjects-Deletingasingleobject"></A>Deleting a single object</H5>
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
@@ -43,3 +91,12 @@ Iterator it = artist.getPaintings().iter
}
</PRE>
</DIV></DIV>
+
+ <hr>
+ <p id="footer">Copyright © 2001-2012 Apache Software Foundation. Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache Cayenne project logo are trademarks of The Apache Software Foundation. <a href="/privacy-policy.html">Privacy policy</a>.
+</div>
+</div>
+
+</div></div>
+</body>
+</html>
Modified: websites/staging/cayenne/trunk/content/docs/3.0/deployment.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/deployment.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/deployment.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » Deployment
-
- <H2><A name="Deployment-Deployment"></A>Deployment</H2>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang="en">
+<head>
+<title>Apache Cayenne » 3.0 » Deployment</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="Apache Cayenne is a powerful, full-featured, open-source object relational mapping framework created for developers working with relational databases.">
+<link rel="stylesheet" type="text/css" media="screen, projection" href="/css/styles.css">
+<link rel="stylesheet" type="text/css" media="print" href="/css/print.css">
+<link rel="shortcut icon" href="/img/favicon.ico" type="image/ico">
+<script type="text/javascript" src="/js/scripts.js"></script>
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-7036673-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ 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>
+<div id="wrap"><div id="wrap-inner">
+
+<div id="header">
+ <h1><a href="/" title="Return to Apache Cayenne home"><span>The Apache Cayenne Project</span></a></h1>
+ <h2><a href="http://www.apache.org" title="The Apache Software Foundation"><span>The Apache Software Foundation</span></a></h2>
+</div>
+
+<div id="container">
+
+
+<div id="sidebar">
+<ul id="nav">
+ <li><a href="/docs/3.0/index.html">3.0.x Documentation</a>
+ <ul>
+ <li><a href="/docs/3.0/overview.html">Overview</a></li>
+ <li><a href="/docs/3.0/cayenne-guide.html">Cayenne Guide</a></li>
+ <li><a href="/docs/3.0/remote-object-persistence-guide.html">Remote Client Guide</a></li>
+ <li><a href="/docs/3.0/modeler-guide.html">Modeler Guide</a></li>
+ <li><a href="/docs/3.0/api/index.html">JavaDoc</a></li>
+ <li><a href="/index.html">Back...</a>
+ </ul>
+ </li>
+</ul>
+</div>
+
+
+<hr>
+<div id="content">
+ <H2><A name="Deployment-Deployment"></A>Deployment</H2>
<P>Cayenne application deployment is about configuring the application so that at runtime it can find a main project file (cayenne.xml) and associated resources, such as DataMap and DataNode XML files.</P>
@@ -28,3 +76,12 @@ DataDomain domain = conf.getDomain();
</OL>
+
+ <hr>
+ <p id="footer">Copyright © 2001-2012 Apache Software Foundation. Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache Cayenne project logo are trademarks of The Apache Software Foundation. <a href="/privacy-policy.html">Privacy policy</a>.
+</div>
+</div>
+
+</div></div>
+</body>
+</html>
Modified: websites/staging/cayenne/trunk/content/docs/3.0/design.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/design.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/design.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » Design
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang="en">
+<head>
+<title>Apache Cayenne » 3.0 » Design</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="Apache Cayenne is a powerful, full-featured, open-source object relational mapping framework created for developers working with relational databases.">
+<link rel="stylesheet" type="text/css" media="screen, projection" href="/css/styles.css">
+<link rel="stylesheet" type="text/css" media="print" href="/css/print.css">
+<link rel="shortcut icon" href="/img/favicon.ico" type="image/ico">
+<script type="text/javascript" src="/js/scripts.js"></script>
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-7036673-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ 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>
+<div id="wrap"><div id="wrap-inner">
- <H2><A name="Design-Design"></A>Design</H2>
+<div id="header">
+ <h1><a href="/" title="Return to Apache Cayenne home"><span>The Apache Cayenne Project</span></a></h1>
+ <h2><a href="http://www.apache.org" title="The Apache Software Foundation"><span>The Apache Software Foundation</span></a></h2>
+</div>
+
+<div id="container">
+
+
+<div id="sidebar">
+<ul id="nav">
+ <li><a href="/docs/3.0/index.html">3.0.x Documentation</a>
+ <ul>
+ <li><a href="/docs/3.0/overview.html">Overview</a></li>
+ <li><a href="/docs/3.0/cayenne-guide.html">Cayenne Guide</a></li>
+ <li><a href="/docs/3.0/remote-object-persistence-guide.html">Remote Client Guide</a></li>
+ <li><a href="/docs/3.0/modeler-guide.html">Modeler Guide</a></li>
+ <li><a href="/docs/3.0/api/index.html">JavaDoc</a></li>
+ <li><a href="/index.html">Back...</a>
+ </ul>
+ </li>
+</ul>
+</div>
+
+
+<hr>
+<div id="content">
+ <H2><A name="Design-Design"></A>Design</H2>
<P>This chapter discusses the architecture of the Cayenne runtime framework. The information below is not strictly required to start using Cayenne, and new users can skip it initially and come back later to gain better understanding of how Cayenne operates under the hood.</P>
<H3><A name="Design-Sections"></A>Sections</H3>
@@ -13,3 +61,12 @@ Title: 3.0 » Design
<LI><A href="primary-key-generation.html" title="Primary Key Generation">Primary Key generation strategies</A></LI>
</OL>
+
+ <hr>
+ <p id="footer">Copyright © 2001-2012 Apache Software Foundation. Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache Cayenne project logo are trademarks of The Apache Software Foundation. <a href="/privacy-policy.html">Privacy policy</a>.
+</div>
+</div>
+
+</div></div>
+</body>
+</html>
Modified: websites/staging/cayenne/trunk/content/docs/3.0/ejbqlquery.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/ejbqlquery.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/ejbqlquery.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » EJBQLQuery
-
- <P><EM>(available since 3.0 in both classic and JPA modes; as of June 2007 only a subset of EJBQL syntax is supported)</EM></P>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang="en">
+<head>
+<title>Apache Cayenne » 3.0 » EJBQLQuery</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="Apache Cayenne is a powerful, full-featured, open-source object relational mapping framework created for developers working with relational databases.">
+<link rel="stylesheet" type="text/css" media="screen, projection" href="/css/styles.css">
+<link rel="stylesheet" type="text/css" media="print" href="/css/print.css">
+<link rel="shortcut icon" href="/img/favicon.ico" type="image/ico">
+<script type="text/javascript" src="/js/scripts.js"></script>
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-7036673-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ 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>
+<div id="wrap"><div id="wrap-inner">
+
+<div id="header">
+ <h1><a href="/" title="Return to Apache Cayenne home"><span>The Apache Cayenne Project</span></a></h1>
+ <h2><a href="http://www.apache.org" title="The Apache Software Foundation"><span>The Apache Software Foundation</span></a></h2>
+</div>
+
+<div id="container">
+
+
+<div id="sidebar">
+<ul id="nav">
+ <li><a href="/docs/3.0/index.html">3.0.x Documentation</a>
+ <ul>
+ <li><a href="/docs/3.0/overview.html">Overview</a></li>
+ <li><a href="/docs/3.0/cayenne-guide.html">Cayenne Guide</a></li>
+ <li><a href="/docs/3.0/remote-object-persistence-guide.html">Remote Client Guide</a></li>
+ <li><a href="/docs/3.0/modeler-guide.html">Modeler Guide</a></li>
+ <li><a href="/docs/3.0/api/index.html">JavaDoc</a></li>
+ <li><a href="/index.html">Back...</a>
+ </ul>
+ </li>
+</ul>
+</div>
+
+
+<hr>
+<div id="content">
+ <P><EM>(available since 3.0 in both classic and JPA modes; as of June 2007 only a subset of EJBQL syntax is supported)</EM></P>
<P>EJBQL is an object query language that is not unlike SQL, only it operates in terms of the Java object model. In fact "EJB" in its name is entirely misleading - the language is applicable in the non-"enterprise" environments just as well. Standard EJBQL syntax is specified in the <A href="../CAYJPA/jpa-guide.html" title="JPA Guide">JPA specification</A>, still Cayenne supports it in a classic mode, and no JPA runtime is required to execute such queries. This chapter deals specifically with classic mode operation. </P>
@@ -59,3 +107,12 @@ Title: 3.0 » EJBQLQuery
<LI><B>Null Handling</B>:</LI>
</UL>
+
+ <hr>
+ <p id="footer">Copyright © 2001-2012 Apache Software Foundation. Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache Cayenne project logo are trademarks of The Apache Software Foundation. <a href="/privacy-policy.html">Privacy policy</a>.
+</div>
+</div>
+
+</div></div>
+</body>
+</html>
Modified: websites/staging/cayenne/trunk/content/docs/3.0/entityresolver.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/entityresolver.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/entityresolver.html Fri Nov 9 07:29:01 2012
@@ -1,5 +1,62 @@
-Title: 3.0 » EntityResolver
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang="en">
+<head>
+<title>Apache Cayenne » 3.0 » EntityResolver</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="Apache Cayenne is a powerful, full-featured, open-source object relational mapping framework created for developers working with relational databases.">
+<link rel="stylesheet" type="text/css" media="screen, projection" href="/css/styles.css">
+<link rel="stylesheet" type="text/css" media="print" href="/css/print.css">
+<link rel="shortcut icon" href="/img/favicon.ico" type="image/ico">
+<script type="text/javascript" src="/js/scripts.js"></script>
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-7036673-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ 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>
+<div id="wrap"><div id="wrap-inner">
- <P>In runtime the mapping metadata is accessed via a <A href="datachannel.html" title="DataChannel">DataChannel</A> in a form of <TT>org.apache.cayenne.map.EntityResolver</TT> (EntityResolver available via ObjectContext is usually obtained from the channel behind the scenes). EntityResolver provides a single namespace for multiple DataMaps. </P>
+<div id="header">
+ <h1><a href="/" title="Return to Apache Cayenne home"><span>The Apache Cayenne Project</span></a></h1>
+ <h2><a href="http://www.apache.org" title="The Apache Software Foundation"><span>The Apache Software Foundation</span></a></h2>
+</div>
+
+<div id="container">
+
+
+<div id="sidebar">
+<ul id="nav">
+ <li><a href="/docs/3.0/index.html">3.0.x Documentation</a>
+ <ul>
+ <li><a href="/docs/3.0/overview.html">Overview</a></li>
+ <li><a href="/docs/3.0/cayenne-guide.html">Cayenne Guide</a></li>
+ <li><a href="/docs/3.0/remote-object-persistence-guide.html">Remote Client Guide</a></li>
+ <li><a href="/docs/3.0/modeler-guide.html">Modeler Guide</a></li>
+ <li><a href="/docs/3.0/api/index.html">JavaDoc</a></li>
+ <li><a href="/index.html">Back...</a>
+ </ul>
+ </li>
+</ul>
+</div>
+
+
+<hr>
+<div id="content">
+ <P>In runtime the mapping metadata is accessed via a <A href="datachannel.html" title="DataChannel">DataChannel</A> in a form of <TT>org.apache.cayenne.map.EntityResolver</TT> (EntityResolver available via ObjectContext is usually obtained from the channel behind the scenes). EntityResolver provides a single namespace for multiple DataMaps. </P>
<P>Another important function of the EntityResolver is providing access to the <TT>org.apache.cayenne.property.ClassDescriptor</TT> instances for each persistent entity. Those a compiled by Cayenne on the fly using EntityResolver's <TT>org.apache.cayenne.property.ClassDescriptorFactory</TT>.</P>
+
+ <hr>
+ <p id="footer">Copyright © 2001-2012 Apache Software Foundation. Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache Cayenne project logo are trademarks of The Apache Software Foundation. <a href="/privacy-policy.html">Privacy policy</a>.
+</div>
+</div>
+
+</div></div>
+</body>
+</html>
Modified: websites/staging/cayenne/trunk/content/docs/3.0/event-package.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/event-package.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/event-package.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » Event Package
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang="en">
+<head>
+<title>Apache Cayenne » 3.0 » Event Package</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="Apache Cayenne is a powerful, full-featured, open-source object relational mapping framework created for developers working with relational databases.">
+<link rel="stylesheet" type="text/css" media="screen, projection" href="/css/styles.css">
+<link rel="stylesheet" type="text/css" media="print" href="/css/print.css">
+<link rel="shortcut icon" href="/img/favicon.ico" type="image/ico">
+<script type="text/javascript" src="/js/scripts.js"></script>
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-7036673-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ 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>
+<div id="wrap"><div id="wrap-inner">
-
+<div id="header">
+ <h1><a href="/" title="Return to Apache Cayenne home"><span>The Apache Cayenne Project</span></a></h1>
+ <h2><a href="http://www.apache.org" title="The Apache Software Foundation"><span>The Apache Software Foundation</span></a></h2>
+</div>
+
+<div id="container">
+
+
+<div id="sidebar">
+<ul id="nav">
+ <li><a href="/docs/3.0/index.html">3.0.x Documentation</a>
+ <ul>
+ <li><a href="/docs/3.0/overview.html">Overview</a></li>
+ <li><a href="/docs/3.0/cayenne-guide.html">Cayenne Guide</a></li>
+ <li><a href="/docs/3.0/remote-object-persistence-guide.html">Remote Client Guide</a></li>
+ <li><a href="/docs/3.0/modeler-guide.html">Modeler Guide</a></li>
+ <li><a href="/docs/3.0/api/index.html">JavaDoc</a></li>
+ <li><a href="/index.html">Back...</a>
+ </ul>
+ </li>
+</ul>
+</div>
+
+
+<hr>
+<div id="content">
+
<P>Cayenne includes a full-featured events mechanism. It allows creation of local and distributed event queues. It is very powerful and generic; it is not tied to Cayenne persistence features in any way and can be used in any application. The most important features are:</P>
<UL>
@@ -14,3 +62,12 @@ Title: 3.0 » Event Package
<DIV class="panelMacro"><TABLE class="tipMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="https://cwiki.apache.org/confluence/images/icons/emoticons/check.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD>The most common error when using EventSubject is not storing a reference to it. This may result in a premature cleanup of a given subject, and automatic unregistering of all listeners. Good practice is to make subject a "public static final" variable of the event sender class if a subject is common for all instances of senders; or make it an ivar of a sender instance if subject is only related to this instance.</TD></TR></TABLE></DIV>
+
+ <hr>
+ <p id="footer">Copyright © 2001-2012 Apache Software Foundation. Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache Cayenne project logo are trademarks of The Apache Software Foundation. <a href="/privacy-policy.html">Privacy policy</a>.
+</div>
+</div>
+
+</div></div>
+</body>
+</html>
Modified: websites/staging/cayenne/trunk/content/docs/3.0/executing-a-stored-procedure.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/executing-a-stored-procedure.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/executing-a-stored-procedure.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » Executing a Stored Procedure
-
- <H3><A name="ExecutingaStoredProcedure-UsingQueryResponsetoProcessComplexResults"></A>Using QueryResponse to Process Complex Results</H3>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang="en">
+<head>
+<title>Apache Cayenne » 3.0 » Executing a Stored Procedure</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="Apache Cayenne is a powerful, full-featured, open-source object relational mapping framework created for developers working with relational databases.">
+<link rel="stylesheet" type="text/css" media="screen, projection" href="/css/styles.css">
+<link rel="stylesheet" type="text/css" media="print" href="/css/print.css">
+<link rel="shortcut icon" href="/img/favicon.ico" type="image/ico">
+<script type="text/javascript" src="/js/scripts.js"></script>
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-7036673-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ 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>
+<div id="wrap"><div id="wrap-inner">
+
+<div id="header">
+ <h1><a href="/" title="Return to Apache Cayenne home"><span>The Apache Cayenne Project</span></a></h1>
+ <h2><a href="http://www.apache.org" title="The Apache Software Foundation"><span>The Apache Software Foundation</span></a></h2>
+</div>
+
+<div id="container">
+
+
+<div id="sidebar">
+<ul id="nav">
+ <li><a href="/docs/3.0/index.html">3.0.x Documentation</a>
+ <ul>
+ <li><a href="/docs/3.0/overview.html">Overview</a></li>
+ <li><a href="/docs/3.0/cayenne-guide.html">Cayenne Guide</a></li>
+ <li><a href="/docs/3.0/remote-object-persistence-guide.html">Remote Client Guide</a></li>
+ <li><a href="/docs/3.0/modeler-guide.html">Modeler Guide</a></li>
+ <li><a href="/docs/3.0/api/index.html">JavaDoc</a></li>
+ <li><a href="/index.html">Back...</a>
+ </ul>
+ </li>
+</ul>
+</div>
+
+
+<hr>
+<div id="content">
+ <H3><A name="ExecutingaStoredProcedure-UsingQueryResponsetoProcessComplexResults"></A>Using QueryResponse to Process Complex Results</H3>
<P>Previous chapter showed how to select a single set of data rows using a ProcedureQuery. In a more general case stored procedures can return multiple sets of data, either as ResultSets or via OUT parameters, execute update/delete/insert queries, etc. To collect the results of execution of such stored procedure, you need to run a query using context's <TT>"performGenericQuery"</TT> method and inspect returned QueryResponse.</P>
@@ -61,3 +109,12 @@ query.addParameter(<SPAN class="code-quo
}
</PRE>
</DIV></DIV>
+
+ <hr>
+ <p id="footer">Copyright © 2001-2012 Apache Software Foundation. Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache Cayenne project logo are trademarks of The Apache Software Foundation. <a href="/privacy-policy.html">Privacy policy</a>.
+</div>
+</div>
+
+</div></div>
+</body>
+</html>
Modified: websites/staging/cayenne/trunk/content/docs/3.0/expression-factory-utilities.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/expression-factory-utilities.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/expression-factory-utilities.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » Expression Factory Utilities
-
- <P>Sometimes there is a need to build an expression by combining other existing expressions. Also quiet often it is desirable to use strongly typed API instead of interpreted string expressions. The following sections describe <A href="http://cayenne.apache.org/doc/api/org/apache/cayenne/exp/ExpressionFactory.html" class="external-link" rel="nofollow">ExpressionFactory</A> and <A href="http://cayenne.apache.org/doc/api/org/apache/cayenne/exp/Expression.html" class="external-link" rel="nofollow">Expression</A> methods that allow to construct expressions step by step via API calls.</P>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang="en">
+<head>
+<title>Apache Cayenne » 3.0 » Expression Factory Utilities</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="Apache Cayenne is a powerful, full-featured, open-source object relational mapping framework created for developers working with relational databases.">
+<link rel="stylesheet" type="text/css" media="screen, projection" href="/css/styles.css">
+<link rel="stylesheet" type="text/css" media="print" href="/css/print.css">
+<link rel="shortcut icon" href="/img/favicon.ico" type="image/ico">
+<script type="text/javascript" src="/js/scripts.js"></script>
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-7036673-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ 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>
+<div id="wrap"><div id="wrap-inner">
+
+<div id="header">
+ <h1><a href="/" title="Return to Apache Cayenne home"><span>The Apache Cayenne Project</span></a></h1>
+ <h2><a href="http://www.apache.org" title="The Apache Software Foundation"><span>The Apache Software Foundation</span></a></h2>
+</div>
+
+<div id="container">
+
+
+<div id="sidebar">
+<ul id="nav">
+ <li><a href="/docs/3.0/index.html">3.0.x Documentation</a>
+ <ul>
+ <li><a href="/docs/3.0/overview.html">Overview</a></li>
+ <li><a href="/docs/3.0/cayenne-guide.html">Cayenne Guide</a></li>
+ <li><a href="/docs/3.0/remote-object-persistence-guide.html">Remote Client Guide</a></li>
+ <li><a href="/docs/3.0/modeler-guide.html">Modeler Guide</a></li>
+ <li><a href="/docs/3.0/api/index.html">JavaDoc</a></li>
+ <li><a href="/index.html">Back...</a>
+ </ul>
+ </li>
+</ul>
+</div>
+
+
+<hr>
+<div id="content">
+ <P>Sometimes there is a need to build an expression by combining other existing expressions. Also quiet often it is desirable to use strongly typed API instead of interpreted string expressions. The following sections describe <A href="http://cayenne.apache.org/doc/api/org/apache/cayenne/exp/ExpressionFactory.html" class="external-link" rel="nofollow">ExpressionFactory</A> and <A href="http://cayenne.apache.org/doc/api/org/apache/cayenne/exp/Expression.html" class="external-link" rel="nofollow">Expression</A> methods that allow to construct expressions step by step via API calls.</P>
<H3><A name="ExpressionFactoryUtilities-Path%2FValueExpressions"></A>Path/Value Expressions</H3>
@@ -106,3 +154,12 @@ Expression qual = ExpressionFactory.matc
<P>"Path" argument to both of these methods can use a split character (a pipe symbol '|') instead of dot to indicate that relationship following a path should be split into a separate set of joins, one per collection value. There can only be one split at most in any given path. Split must always precede a relationship. E.g. <TT>"|exhibits.paintings"</TT>, <TT>"exhibits|paintings"</TT>, etc. Internally Cayenne would generate distinct aliases for each of the split expressions, forcing separate joins.</P>
+
+ <hr>
+ <p id="footer">Copyright © 2001-2012 Apache Software Foundation. Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache Cayenne project logo are trademarks of The Apache Software Foundation. <a href="/privacy-policy.html">Privacy policy</a>.
+</div>
+</div>
+
+</div></div>
+</body>
+</html>
Modified: websites/staging/cayenne/trunk/content/docs/3.0/expressions.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/expressions.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/expressions.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » Expressions
-
- <H2><A name="Expressions-Expressions"></A>Expressions</H2>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang="en">
+<head>
+<title>Apache Cayenne » 3.0 » Expressions</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="Apache Cayenne is a powerful, full-featured, open-source object relational mapping framework created for developers working with relational databases.">
+<link rel="stylesheet" type="text/css" media="screen, projection" href="/css/styles.css">
+<link rel="stylesheet" type="text/css" media="print" href="/css/print.css">
+<link rel="shortcut icon" href="/img/favicon.ico" type="image/ico">
+<script type="text/javascript" src="/js/scripts.js"></script>
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-7036673-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ 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>
+<div id="wrap"><div id="wrap-inner">
+
+<div id="header">
+ <h1><a href="/" title="Return to Apache Cayenne home"><span>The Apache Cayenne Project</span></a></h1>
+ <h2><a href="http://www.apache.org" title="The Apache Software Foundation"><span>The Apache Software Foundation</span></a></h2>
+</div>
+
+<div id="container">
+
+
+<div id="sidebar">
+<ul id="nav">
+ <li><a href="/docs/3.0/index.html">3.0.x Documentation</a>
+ <ul>
+ <li><a href="/docs/3.0/overview.html">Overview</a></li>
+ <li><a href="/docs/3.0/cayenne-guide.html">Cayenne Guide</a></li>
+ <li><a href="/docs/3.0/remote-object-persistence-guide.html">Remote Client Guide</a></li>
+ <li><a href="/docs/3.0/modeler-guide.html">Modeler Guide</a></li>
+ <li><a href="/docs/3.0/api/index.html">JavaDoc</a></li>
+ <li><a href="/index.html">Back...</a>
+ </ul>
+ </li>
+</ul>
+</div>
+
+
+<hr>
+<div id="content">
+ <H2><A name="Expressions-Expressions"></A>Expressions</H2>
<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 <A href="bnf-for-expressionparser.html" title="BNF for ExpressionParser">here</A>.</P>
@@ -17,3 +65,12 @@ Title: 3.0 » Expressions
<LI><A href="bnf-for-expressionparser.html" title="BNF for ExpressionParser">BNF for ExpressionParser</A></LI>
</OL>
+
+ <hr>
+ <p id="footer">Copyright © 2001-2012 Apache Software Foundation. Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache Cayenne project logo are trademarks of The Apache Software Foundation. <a href="/privacy-policy.html">Privacy policy</a>.
+</div>
+</div>
+
+</div></div>
+</body>
+</html>
Modified: websites/staging/cayenne/trunk/content/docs/3.0/extended-types.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/extended-types.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/extended-types.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » Extended Types
-
- <P>JDBC specification defines a set of "standard" database column types (defined in java.sql.Types class) and a very specific mapping of these types to Java Object Types, such as java.lang.String, java.math.BigDecimal, etc. Sometimes there is a need to use a custom Java type not known to JDBC driver. CayenneModeler allows to configure an arbitrary Java class as an <TT>org.apache.cayenne.map.ObjAttribute</TT> type by simply entering a fully-qualified name such class in the type column of an ObjAttribute. However there is more to it than just that. Cayenne needs to know how to instantiate this type from a database "primitive" value, and conversly, how to transform an object of the custom type to a JDBC-compatible object.</P>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang="en">
+<head>
+<title>Apache Cayenne » 3.0 » Extended Types</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="Apache Cayenne is a powerful, full-featured, open-source object relational mapping framework created for developers working with relational databases.">
+<link rel="stylesheet" type="text/css" media="screen, projection" href="/css/styles.css">
+<link rel="stylesheet" type="text/css" media="print" href="/css/print.css">
+<link rel="shortcut icon" href="/img/favicon.ico" type="image/ico">
+<script type="text/javascript" src="/js/scripts.js"></script>
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-7036673-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ 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>
+<div id="wrap"><div id="wrap-inner">
+
+<div id="header">
+ <h1><a href="/" title="Return to Apache Cayenne home"><span>The Apache Cayenne Project</span></a></h1>
+ <h2><a href="http://www.apache.org" title="The Apache Software Foundation"><span>The Apache Software Foundation</span></a></h2>
+</div>
+
+<div id="container">
+
+
+<div id="sidebar">
+<ul id="nav">
+ <li><a href="/docs/3.0/index.html">3.0.x Documentation</a>
+ <ul>
+ <li><a href="/docs/3.0/overview.html">Overview</a></li>
+ <li><a href="/docs/3.0/cayenne-guide.html">Cayenne Guide</a></li>
+ <li><a href="/docs/3.0/remote-object-persistence-guide.html">Remote Client Guide</a></li>
+ <li><a href="/docs/3.0/modeler-guide.html">Modeler Guide</a></li>
+ <li><a href="/docs/3.0/api/index.html">JavaDoc</a></li>
+ <li><a href="/index.html">Back...</a>
+ </ul>
+ </li>
+</ul>
+</div>
+
+
+<hr>
+<div id="content">
+ <P>JDBC specification defines a set of "standard" database column types (defined in java.sql.Types class) and a very specific mapping of these types to Java Object Types, such as java.lang.String, java.math.BigDecimal, etc. Sometimes there is a need to use a custom Java type not known to JDBC driver. CayenneModeler allows to configure an arbitrary Java class as an <TT>org.apache.cayenne.map.ObjAttribute</TT> type by simply entering a fully-qualified name such class in the type column of an ObjAttribute. However there is more to it than just that. Cayenne needs to know how to instantiate this type from a database "primitive" value, and conversly, how to transform an object of the custom type to a JDBC-compatible object.</P>
<H3><A name="ExtendedTypes-SupportingNonStandardTypes"></A>Supporting Non-Standard Types</H3>
@@ -26,3 +74,12 @@ Title: 3.0 » Extended Types
<H3><A name="ExtendedTypes-ROPConsiderations"></A>ROP Considerations</H3>
<P>If you are using Cayenne in a three tier (ROP) environment, serialization of the extended type becomes important. More information can be found <A href="remote-object-persistence-customization.html" title="Remote Object Persistence Customization">here.</A></P>
+
+ <hr>
+ <p id="footer">Copyright © 2001-2012 Apache Software Foundation. Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache Cayenne project logo are trademarks of The Apache Software Foundation. <a href="/privacy-policy.html">Privacy policy</a>.
+</div>
+</div>
+
+</div></div>
+</body>
+</html>
Modified: websites/staging/cayenne/trunk/content/docs/3.0/flattened-relationships.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/flattened-relationships.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/flattened-relationships.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » Flattened Relationships
-
- <P>Flattened relationships are a fancy term for a relationship which involves three or more tables in the database. Lets say you have Artists and Exhibits. They are joined with a many-many join table called Artist_Exhibit, because many Artists could collaborate on one Exhibit and each Artist might be part of many Exhibits. Now you could map these as separate joins and end up with Java code which looks like this:</P>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang="en">
+<head>
+<title>Apache Cayenne » 3.0 » Flattened Relationships</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="Apache Cayenne is a powerful, full-featured, open-source object relational mapping framework created for developers working with relational databases.">
+<link rel="stylesheet" type="text/css" media="screen, projection" href="/css/styles.css">
+<link rel="stylesheet" type="text/css" media="print" href="/css/print.css">
+<link rel="shortcut icon" href="/img/favicon.ico" type="image/ico">
+<script type="text/javascript" src="/js/scripts.js"></script>
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-7036673-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ 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>
+<div id="wrap"><div id="wrap-inner">
+
+<div id="header">
+ <h1><a href="/" title="Return to Apache Cayenne home"><span>The Apache Cayenne Project</span></a></h1>
+ <h2><a href="http://www.apache.org" title="The Apache Software Foundation"><span>The Apache Software Foundation</span></a></h2>
+</div>
+
+<div id="container">
+
+
+<div id="sidebar">
+<ul id="nav">
+ <li><a href="/docs/3.0/index.html">3.0.x Documentation</a>
+ <ul>
+ <li><a href="/docs/3.0/overview.html">Overview</a></li>
+ <li><a href="/docs/3.0/cayenne-guide.html">Cayenne Guide</a></li>
+ <li><a href="/docs/3.0/remote-object-persistence-guide.html">Remote Client Guide</a></li>
+ <li><a href="/docs/3.0/modeler-guide.html">Modeler Guide</a></li>
+ <li><a href="/docs/3.0/api/index.html">JavaDoc</a></li>
+ <li><a href="/index.html">Back...</a>
+ </ul>
+ </li>
+</ul>
+</div>
+
+
+<hr>
+<div id="content">
+ <P>Flattened relationships are a fancy term for a relationship which involves three or more tables in the database. Lets say you have Artists and Exhibits. They are joined with a many-many join table called Artist_Exhibit, because many Artists could collaborate on one Exhibit and each Artist might be part of many Exhibits. Now you could map these as separate joins and end up with Java code which looks like this:</P>
<DIV class="code panel" style="border-width: 1px;"><DIV class="codeContent panelContent">
<PRE class="code-java">
@@ -20,3 +68,12 @@ artist.getExhibits()
<DIV class="panelMacro"><TABLE class="infoMacro"><COLGROUP><COL width="24"><COL></COLGROUP><TR><TD valign="top"><IMG src="https://cwiki.apache.org/confluence/images/icons/emoticons/information.gif" width="16" height="16" align="absmiddle" alt="" border="0"></TD><TD><B>Flattened Relationships Limitations</B><BR>Only many-to-many flattened relatationships with a single join table can be modified. All other types of flattened relationships can be used as "read-only". This is reflected in the DataObject code generated for such relationships - no set/addTo/RemoveFrom methods are created for read-only relationships.</TD></TR></TABLE></DIV>
<P>See this documentation on how to <A href="cayennemodeler-flattened-relationships.html" title="CayenneModeler Flattened Relationships">create flattened relationships in Cayenne Modeler</A></P>
+
+ <hr>
+ <p id="footer">Copyright © 2001-2012 Apache Software Foundation. Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache Cayenne project logo are trademarks of The Apache Software Foundation. <a href="/privacy-policy.html">Privacy policy</a>.
+</div>
+</div>
+
+</div></div>
+</body>
+</html>
Modified: websites/staging/cayenne/trunk/content/docs/3.0/general-navigation.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/general-navigation.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/general-navigation.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » General Navigation
-
- <H3><A name="GeneralNavigation-GeneralNavigation"></A>General Navigation</H3>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang="en">
+<head>
+<title>Apache Cayenne » 3.0 » General Navigation</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="Apache Cayenne is a powerful, full-featured, open-source object relational mapping framework created for developers working with relational databases.">
+<link rel="stylesheet" type="text/css" media="screen, projection" href="/css/styles.css">
+<link rel="stylesheet" type="text/css" media="print" href="/css/print.css">
+<link rel="shortcut icon" href="/img/favicon.ico" type="image/ico">
+<script type="text/javascript" src="/js/scripts.js"></script>
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-7036673-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ 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>
+<div id="wrap"><div id="wrap-inner">
+
+<div id="header">
+ <h1><a href="/" title="Return to Apache Cayenne home"><span>The Apache Cayenne Project</span></a></h1>
+ <h2><a href="http://www.apache.org" title="The Apache Software Foundation"><span>The Apache Software Foundation</span></a></h2>
+</div>
+
+<div id="container">
+
+
+<div id="sidebar">
+<ul id="nav">
+ <li><a href="/docs/3.0/index.html">3.0.x Documentation</a>
+ <ul>
+ <li><a href="/docs/3.0/overview.html">Overview</a></li>
+ <li><a href="/docs/3.0/cayenne-guide.html">Cayenne Guide</a></li>
+ <li><a href="/docs/3.0/remote-object-persistence-guide.html">Remote Client Guide</a></li>
+ <li><a href="/docs/3.0/modeler-guide.html">Modeler Guide</a></li>
+ <li><a href="/docs/3.0/api/index.html">JavaDoc</a></li>
+ <li><a href="/index.html">Back...</a>
+ </ul>
+ </li>
+</ul>
+</div>
+
+
+<hr>
+<div id="content">
+ <H3><A name="GeneralNavigation-GeneralNavigation"></A>General Navigation</H3>
<P>CayenneModeler supports executing commands via its main menu, a button toolbar and contextual menus that open on right-click. All of the toolbar buttons have corresponding items in the menu that perform the exact same operation (plus there are operations that are available via the menu only). If an item or a button action can not be performed in a given context an item is visually disabled.</P>
@@ -52,3 +100,12 @@ Title: 3.0 » General Navigation
<H5><A name="GeneralNavigation-Query%3A%21iconquery.gif%21"></A>Query: <SPAN class="image-wrap" style=""><IMG src="general-navigation.data/icon-query.gif" style="border: 0px solid black"></SPAN></H5>
<P>Cayenne allows to store queries in the DataMap. There are 4 types of Cayenne queries that can be created in the Modeler - object select query, raw SQL query, procedure query and EJBQL query.</P>
+
+ <hr>
+ <p id="footer">Copyright © 2001-2012 Apache Software Foundation. Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache Cayenne project logo are trademarks of The Apache Software Foundation. <a href="/privacy-policy.html">Privacy policy</a>.
+</div>
+</div>
+
+</div></div>
+</body>
+</html>
Modified: websites/staging/cayenne/trunk/content/docs/3.0/general-preferences.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/general-preferences.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/general-preferences.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,63 @@
-Title: 3.0 » General Preferences
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang="en">
+<head>
+<title>Apache Cayenne » 3.0 » General Preferences</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="Apache Cayenne is a powerful, full-featured, open-source object relational mapping framework created for developers working with relational databases.">
+<link rel="stylesheet" type="text/css" media="screen, projection" href="/css/styles.css">
+<link rel="stylesheet" type="text/css" media="print" href="/css/print.css">
+<link rel="shortcut icon" href="/img/favicon.ico" type="image/ico">
+<script type="text/javascript" src="/js/scripts.js"></script>
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-7036673-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ 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>
+<div id="wrap"><div id="wrap-inner">
-
+<div id="header">
+ <h1><a href="/" title="Return to Apache Cayenne home"><span>The Apache Cayenne Project</span></a></h1>
+ <h2><a href="http://www.apache.org" title="The Apache Software Foundation"><span>The Apache Software Foundation</span></a></h2>
+</div>
+
+<div id="container">
+
+
+<div id="sidebar">
+<ul id="nav">
+ <li><a href="/docs/3.0/index.html">3.0.x Documentation</a>
+ <ul>
+ <li><a href="/docs/3.0/overview.html">Overview</a></li>
+ <li><a href="/docs/3.0/cayenne-guide.html">Cayenne Guide</a></li>
+ <li><a href="/docs/3.0/remote-object-persistence-guide.html">Remote Client Guide</a></li>
+ <li><a href="/docs/3.0/modeler-guide.html">Modeler Guide</a></li>
+ <li><a href="/docs/3.0/api/index.html">JavaDoc</a></li>
+ <li><a href="/index.html">Back...</a>
+ </ul>
+ </li>
+</ul>
+</div>
+
+
+<hr>
+<div id="content">
+
<H3><A name="GeneralPreferences-GeneralPreferences"></A>General Preferences</H3>
<P>"General Preferences" panel currently supports configuration of a single parameter - "Preferences Save Interval". This parameter determines how often should the Modeler commit preference values that it collects automatically during normal operation (e.g. main window or panel sizes, etc.). Don't set this to a small value as this may sometimes degrade Modeler performance. </P>
+
+ <hr>
+ <p id="footer">Copyright © 2001-2012 Apache Software Foundation. Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache Cayenne project logo are trademarks of The Apache Software Foundation. <a href="/privacy-policy.html">Privacy policy</a>.
+</div>
+</div>
+
+</div></div>
+</body>
+</html>
Modified: websites/staging/cayenne/trunk/content/docs/3.0/generate-database-schema.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/generate-database-schema.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/generate-database-schema.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » Generate Database Schema
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html lang="en">
+<head>
+<title>Apache Cayenne » 3.0 » Generate Database Schema</title>
+<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
+<meta name="description" content="Apache Cayenne is a powerful, full-featured, open-source object relational mapping framework created for developers working with relational databases.">
+<link rel="stylesheet" type="text/css" media="screen, projection" href="/css/styles.css">
+<link rel="stylesheet" type="text/css" media="print" href="/css/print.css">
+<link rel="shortcut icon" href="/img/favicon.ico" type="image/ico">
+<script type="text/javascript" src="/js/scripts.js"></script>
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-7036673-1']);
+ _gaq.push(['_trackPageview']);
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ 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>
+<div id="wrap"><div id="wrap-inner">
-
+<div id="header">
+ <h1><a href="/" title="Return to Apache Cayenne home"><span>The Apache Cayenne Project</span></a></h1>
+ <h2><a href="http://www.apache.org" title="The Apache Software Foundation"><span>The Apache Software Foundation</span></a></h2>
+</div>
+
+<div id="container">
+
+
+<div id="sidebar">
+<ul id="nav">
+ <li><a href="/docs/3.0/index.html">3.0.x Documentation</a>
+ <ul>
+ <li><a href="/docs/3.0/overview.html">Overview</a></li>
+ <li><a href="/docs/3.0/cayenne-guide.html">Cayenne Guide</a></li>
+ <li><a href="/docs/3.0/remote-object-persistence-guide.html">Remote Client Guide</a></li>
+ <li><a href="/docs/3.0/modeler-guide.html">Modeler Guide</a></li>
+ <li><a href="/docs/3.0/api/index.html">JavaDoc</a></li>
+ <li><a href="/index.html">Back...</a>
+ </ul>
+ </li>
+</ul>
+</div>
+
+
+<hr>
+<div id="content">
+
<H3><A name="GenerateDatabaseSchema-GenerateDatabaseSchema"></A>Generate Database Schema</H3>
<P>To be done...</P>
@@ -10,3 +58,12 @@ Title: 3.0 » Generate Database Sch
<P><SPAN class="image-wrap" style=""><IMG src="generate-database-schema.data/generate-options.jpg" style="border: 0px solid black"></SPAN></P>
<P><SPAN class="image-wrap" style=""><IMG src="generate-database-schema.data/generate-options-tables.jpg" style="border: 0px solid black"></SPAN></P>
+
+ <hr>
+ <p id="footer">Copyright © 2001-2012 Apache Software Foundation. Apache Cayenne, Cayenne, Apache, the Apache feather logo, and the Apache Cayenne project logo are trademarks of The Apache Software Foundation. <a href="/privacy-policy.html">Privacy policy</a>.
+</div>
+</div>
+
+</div></div>
+</body>
+</html>