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/10/31 20:57:55 UTC
svn commit: r836771 [2/14] - in /websites/staging/cayenne/trunk/content: ./
doc12/ doc12/grammar/ doc20/ doc30/
Modified: websites/staging/cayenne/trunk/content/doc12/configuring-caching-behavior.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/configuring-caching-behavior.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/configuring-caching-behavior.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<P>Cayenne supports local and distributed caching of fetched data. The design of the caching feature is discussed in the User Guide. When a new DataDomain is created, it uses default caching settings - data is cached within JVM, but no remote synchronization is performed. User can change these settings depending on the target application deployment strategy.</P>
@@ -45,8 +57,11 @@
<P>The conclusion is that using JMS is probably most appropriate when deploying within J2EE containers that alreay support this service, while JavaGroups can be used in almost any environment.</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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/configuring-deployment-settings.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/configuring-deployment-settings.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/configuring-deployment-settings.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<P>Cayenne project deployment settings, aside from <A href="create-datanode.html" title="Create DataNode">DataNode</A> configuration discussed elsewhere, are done using DataDomain panel. This chapter describes various supported settings.</P>
@@ -21,8 +33,11 @@
<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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/configuring-logging.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/configuring-logging.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/configuring-logging.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<P>Cayenne logging is based on Log4J package from Jakarta Apache Project. This is the most powerful and flexible logging framework available in Java. Log4J configuration is normally done using a property file. Later in this chapter we explain how Cayenne loads configuration files and how to customize this process. Format of the entries in this file is described in the Log4j documentation. Here is a sample configuration file contents:</P>
@@ -79,8 +91,11 @@ log4j.logger.org.objectstyle.cayenne.uti
<P>Finally, if your application already uses Log4J and implements its own logic to configure logging, it would be undesirable for Cayenne to use its default behavior and override any application settings. Also it is convenient to use a single logging configuration file per application. Cayenne detects if Log4J has already been started and will stop any attempts to configure logging. This means that Log4J services must be configured prior to any calls to Cayenne. </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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/configuring-object-validation.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/configuring-object-validation.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/configuring-object-validation.html Wed Oct 31 19:57:39 2012
@@ -11,14 +11,29 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<P><BR>
<BR>
Each DataDomain can be configured to enable or disable DataObject pre-commit validation by (un)checking "Child DataContexts Validate Objects" checkbox. By default validation is enabled for all newly created DataDomains. More information on DataObject validation is provided in the <A href="dataobject-validation.html" title="DataObject Validation">user guide</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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/configuring-transactional-behavior.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/configuring-transactional-behavior.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/configuring-transactional-behavior.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<P>Each DataDomain can be configured to explicitly commit/rollback its transactions or to rely on deployment container to do that. This is done by checking or unchecking "Container-Managed Transactions" checkbox. </P>
@@ -19,8 +31,11 @@
<P>By default "Container-Managed Transactions" is unchecked, letting Cayenne to handle its transactions. Check this checkbox when using Cayenne under container-managed transactions control, i.e. within EJB environment.</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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/converting-an-existing-business-framework.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/converting-an-existing-business-framework.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/converting-an-existing-business-framework.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<H3><A name="ConvertinganExistingBusinessFramework-ConvertinganExistingBusinessFramework"></A>Converting an Existing Business Framework</H3>
@@ -44,8 +56,11 @@
<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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/create-datanode.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/create-datanode.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/create-datanode.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<H3><A name="CreateDataNode-CreateDataNode"></A>Create DataNode</H3>
@@ -31,8 +43,11 @@
<P><B>Configure DataSource Information (Driver factory only).</B> Depending on the type of DataSource Factory selected, bottom right area of the screen will change to show a form appropriate for a selected type of DataSource. It allows to enter JDBC information for DriverDataSourceFactory or JNDI name for JNDI. If custom DataSource Factory was selected, an optional string parameter can be entered (it can be anything that a custom DataSource factory understands).</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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/create-new-project.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/create-new-project.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/create-new-project.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<H3><A name="CreateNewProject-CreateNewProject"></A>Create New Project</H3>
@@ -28,8 +40,11 @@
<P>When you click on "UntitledDomain", this opens an editor for this domain and also activates two new actions: "<TT>Create DataNode</TT>" and "<TT>Create DataMap</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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/customizing-configuration.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/customizing-configuration.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/customizing-configuration.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<P>A user can create her own subclass of Configuration and use it instead of the classes provided by Cayenne. Custom subclasses are usually created to load configuration files from non-standard locations, to automatically configure Cayenne during certain events that happen in deployment containers, etc. Cayenne provides a few implementations of Configuration discussed later in this chapter.</P>
@@ -72,8 +84,11 @@ Configuration.initializeSharedConfigurat
<P>The difference between the String and File arguments is that the latter are checked for existence. Both variants can be absolute or relative, and are evaluated in the order in which they are added to the Configuration.</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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/customizing-queries.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/customizing-queries.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/customizing-queries.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<P>Any object that implements <TT>org.objectstyle.cayenne.query.Query</TT> interface can be executed with a DataContext. </P>
@@ -103,8 +115,11 @@ Map row = (Map) context.performQuery(que
<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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/customizing.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/customizing.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/customizing.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<P>Here we will discuss a few Cayenne customization techniques:</P>
@@ -23,8 +35,11 @@
<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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/data-rows.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/data-rows.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/data-rows.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<P>DataObjects creation and registering with DataContext is an expensive operation. There are cases when only a few objects are really used, but the application still has to fetch a lot of objects. For instance when a user performs a search, result may contain thousands of records, but user will only check 2-3 of them. Cayenne allows programmers to explicitly disable objects creation for such cases. Results will be returned in the form of java.util.Map's. In Cayenne such maps are called <TT>DataRows</TT>.</P>
@@ -56,8 +68,11 @@ List artistRows = ctxt.performQuery(q);
</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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/datachannel.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/datachannel.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/datachannel.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<P><TT>"org.objectstyle.cayenne.DataChannel"</TT> is an abstraction of Cayenne persistence stack. It is very simple - it defines only 4 methods, two for actually performing persistent operations, one to access metadata, and one - to access EventManager:</P>
@@ -39,8 +51,11 @@
<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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/datacontext.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/datacontext.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/datacontext.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<P>In most applications <A href="http://objectstyle.org/cayenne/api/cayenne/org/objectstyle/cayenne/access/DataContext.html" class="external-link" rel="nofollow">DataContext</A> is the main user access point to all Cayenne functionality. It provides query execution facilities as well as object state management functions. Applications rarely directly deal with access or mapping objects beyond DataContext.</P>
@@ -21,8 +33,11 @@
<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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/datacontextdelegate.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/datacontextdelegate.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/datacontextdelegate.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<P>DataContext supports runtime customization via a DataContextDelegate interface. A user can assign a custom delegate instance to a DataContext by calling DataContext.setDelegate(..). Delegate is optional, and if it is not set, DataContext would go on with its default behavior. If a delegate is set, DataContext consults with it at some critical points in the normal flow execution. A delegate can modify the flow, abort an operation, modify objects participating in an operation, or perform any other tasks it deems necessary.</P>
@@ -36,8 +48,11 @@
<P>These methods are called by the ObjectStore whenever it performs an update of its state triggered by external events. Default ObjectStore behavior is to merge all changes to the existing objects, and change deleted objects state to TRANSIENT, removing them from the store. Delegate has an option to abort standard processing by returning "false" from "should*" methods.</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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/datacontextfactory.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/datacontextfactory.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/datacontextfactory.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<P>To customize how the DataContext is built, an <EM>optional</EM> DataContextFactory can be registered with DataDomain in the Modeler. The class name you enter must implement <TT>org.objectstyle.cayenne.access.DataContextFactory</TT> interface. If a factory is entered, Cayenne will use it in <A href="obtaining-datacontext.html" title="Obtaining DataContext">all places</A> where the DataContext is created. A single factory instance is reused for the life of the DataDomain.</P>
@@ -19,8 +31,11 @@
<P><SPAN class="image-wrap" style=""><IMG src="datacontextfactory.data/datacontextfactory.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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/datanode.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/datanode.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/datanode.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<P>DataNode is a Cayenne "driver" for a single physical data source, such as a relational database. In fact currently DataNode only handles JDBC sources (so maybe it should be renamed to JdbcDataNode?). </P>
@@ -19,8 +31,11 @@
<P>DataNode doesn't do much work on its own, instead delegating most tasks to <TT>"org.objectstyle.cayenne.action.SQLAction"</TT> instances returned by <A href="dbadapter.html" title="DbAdapter">DbAdapter</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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/dataobject-state-management.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/dataobject-state-management.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/dataobject-state-management.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<P>Arguably the second most important function of DataContext (first is performing queries) is keeping track of changes made to the registered DataObjects. "Registered" is a keyword here - registering an object with DataContext is what gives this object its persistent qualities.</P>
@@ -141,8 +153,11 @@ DataContext context; <SPAN class="code-c
<P>This will restore the persistence state and the values of all registered objects to the values that objects had when they were fetched or the last commitChanges was executed. This effectively restores previously committed state of the object graph. Note that any NEW objects are unregistered from the context.</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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/dataobject-validation.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/dataobject-validation.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/dataobject-validation.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<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, 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>
@@ -67,8 +79,11 @@
<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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/dataobjects-example.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/dataobjects-example.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/dataobjects-example.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<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>
@@ -76,8 +88,11 @@ List realExpensiveArt = ctxt.performQuer
</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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/dataobjects.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/dataobjects.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/dataobjects.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<P><A href="http://cayenne.apache.org/doc12/api/cayenne/org/objectstyle/cayenne/DataObject.html" class="external-link" rel="nofollow">DataObjects</A> (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>
@@ -22,8 +34,11 @@
<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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/dataobjectutils.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/dataobjectutils.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/dataobjectutils.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<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>
@@ -39,8 +51,11 @@ DataContext context = ...;
</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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/datasource.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/datasource.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/datasource.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<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.objectstyle.cayenne.conf.DriverDataSourceFactory</TT> in the Modeler, you are choosing to use Cayenne DataSource. </P>
@@ -20,8 +32,11 @@
<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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/dataview-concepts.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/dataview-concepts.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/dataview-concepts.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<H3><A name="DataViewConcepts-DataViewHierarchy"></A>DataView Hierarchy</H3>
@@ -62,8 +74,11 @@
<P>One more useful feature is a centralized EventDispatcher within the DataView class. It is used by the fields to fire the events whenever their values are changed. Thus the ObjAttribute/ObjRelationship modifications can be easily propagated to all the listening components. </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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/dataviews-in-action.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/dataviews-in-action.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/dataviews-in-action.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<P>Here we illustrate the discussion of DataViews with configuration samples and code snippets. Cayenne project DTD file supports references to data view configuration files. This information is loaded into the Cayenne Configuration instance along with the DataDomain, DataNode, and DataMap entries. Since the DataView functionality is optional and would not be very useful in some deployment scenarios (server-side applications) the DataView configiuration itself is not loaded at the time of initialization. Neither DataView instances are created by the configuration process. A DataView can be created in a Swing application with the code similar to the following:</P>
@@ -68,8 +80,11 @@ featureTable.setModel(tableModel);
<P>In fact, there is many more cool things you could do with DataViews to build your Cayenne enabled Swing rich client faster and cleaner, and separate the GUI related stuff from your domain logic defining the clear declarative rules telling the framework how to interprete, render, and edit the ObjEntities and DataObjects your application relies upon. </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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/dataviews.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/dataviews.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/dataviews.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<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>In the future versions of Cayenne DataViews will be split in a standalone package. Unless we find volunteers, this package won't be supported very well.</TD></TR></TABLE></DIV>
@@ -26,8 +38,11 @@
<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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/dbadapter.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/dbadapter.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/dbadapter.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<H3><A name="DbAdapter-PortabilityAcrossDatabases"></A>Portability Across Databases</H3>
@@ -36,8 +48,11 @@
<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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/delete-rules.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/delete-rules.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/delete-rules.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<H3><A name="DeleteRules-DeleteRules"></A>Delete Rules</H3>
@@ -38,8 +50,11 @@
<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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/deleting-objects.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/deleting-objects.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/deleting-objects.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<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. Quiet naturally delete operation changes 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>
@@ -56,8 +68,11 @@ Iterator it = artist.getPaintings().iter
</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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/deployment-with-ant.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/deployment-with-ant.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/deployment-with-ant.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<P>There is a number of cases when it is highly desirable to automate changing of Cayenne configuration files, including cayenne.xml and driver information files:</P>
@@ -25,8 +37,11 @@
<P>Cayenne provides an Ant task called cdeploy that takes care of such things. More information on cdeploy is available <A href="cdeploy.html" title="cdeploy">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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/deployment.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/deployment.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/deployment.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<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>
@@ -30,8 +42,11 @@ DataDomain domain = conf.getDomain();
<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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/design.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/design.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/design.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<P>This chapter discusses the architecture of the core Cayenne framework. It only deals with the runtime operation of the object-relational persistence layer. <A href="modeler-guide.html" title="Modeler Guide">Mapping procedures</A> and <A href="remote-object-persistence-guide.html" title="Remote Object Persistence Guide">remote object persistence</A> are discussed elsewhere. The information below is not strictly required to start using Cayenne, so new users can skip it initially and come back later to gain better understanding of how Cayenne operates under the hood.</P>
@@ -30,8 +42,11 @@
<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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/documentation.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/documentation.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/documentation.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<H2><A name="Documentation-CayenneDocumentationv.1.2%28STABLE%29"></A>Cayenne Documentation - v. 1.2 (STABLE)</H2>
<UL>
@@ -22,8 +34,11 @@
<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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/dvmodeler-gui-tool.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/dvmodeler-gui-tool.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/dvmodeler-gui-tool.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<P>DVModeler is a Java GUI tool to work with DataViews configuration included in Cayenne projects. Steps needed to start DVModeler are similar to that of CayenneModeler. Main class is <TT>org.objectstyle.cayenne.dataview.dvmodeler.Main</TT>. For convenience Cayenne distribution provides run scripts to start DVModeler on Windows and UNIX platforms. To take advantage of these scripts, user must set CAYENNE_HOME (optional) and JAVA_HOME environment variables as described in <A href="installation.html" title="Installation">Installation</A>.</P>
@@ -30,8 +42,11 @@
</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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/entityresolver.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/entityresolver.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/entityresolver.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<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.objectstyle.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>
@@ -19,8 +31,11 @@
<P>Another important function of the EntityResolver is providing access to the <TT>org.objectstyle.cayenne.property.ClassDescriptor</TT> instances for each persistent entity. Those a compiled by Cayenne on the fly using EntityResolver's <TT>org.objectstyle.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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/event-package.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/event-package.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/event-package.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<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>
@@ -29,8 +41,11 @@
<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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/executing-a-stored-procedure.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/executing-a-stored-procedure.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/executing-a-stored-procedure.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<H3><A name="ExecutingaStoredProcedure-UsingQueryResponsetoProcessComplexResults"></A>Using QueryResponse to Process Complex Results</H3>
@@ -76,8 +88,11 @@ query.addParam(<SPAN class="code-quote">
</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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/expression-factory-utilities.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/expression-factory-utilities.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/expression-factory-utilities.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<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://objectstyle.org/cayenne/api/cayenne/org/objectstyle/cayenne/exp/ExpressionFactory.html" class="external-link" rel="nofollow">ExpressionFactory</A> and <A href="http://objectstyle.org/cayenne/api/cayenne/org/objectstyle/cayenne/exp/Expression.html" class="external-link" rel="nofollow">Expression</A> methods that allow to construct expressions step by step via API calls.</P>
@@ -109,8 +121,11 @@ SelectQuery select = <SPAN class="code-k
<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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/expressions.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/expressions.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/expressions.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<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="http://objectstyle.org/cayenne/grammar/ExpressionParser.html" class="external-link" rel="nofollow">here</A>.</P>
@@ -20,8 +32,11 @@
<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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/extended-types.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/extended-types.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/extended-types.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<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 <A href="http://objectstyle.org/cayenne/api/cayenne/org/objectstyle/cayenne/map/ObjAttribute.html" class="external-link" rel="nofollow">ObjAttribute</A> 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>
@@ -37,8 +49,11 @@ DataNode node = domain.getNode(<SPAN cla
<P>As shown in the example above, ExtendedTypes are stored by <A href="http://objectstyle.org/cayenne/api/cayenne/org/objectstyle/cayenne/dba/DbAdapter.html" class="external-link" rel="nofollow">DbAdapter</A>. In fact DbAdapters often install their own extended types to address incompatibilities, incompletness and differences between JDBC drivers in handling "standard" JDBC types. For instance some drivers support reading large character columns (CLOB) as java.sql.Clob, but some other - as "character stream", etc. Adapters provided with Cayenne override <TT>configureExtendedTypes()</TT> method to install their own types, possibly substituting Cayenne defaults. Custom DbAdapters can use the same technique.</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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/flattened-relationships.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/flattened-relationships.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/flattened-relationships.html Wed Oct 31 19:57:39 2012
@@ -11,15 +11,30 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<P>Flattened relationships represent relationship between two types of DataObjects that is not direct in the underlying relational storage. Instead it is mapped across one or more "join" tables. Still from the application point of view there is no diffrence in working with flattened relationships compared to the "normal" ones. Cayenne internally figures out how to build the needed query joins to retrieve related objects. On adding or removing an object to/from a flattened relationship via a corresponding "addTo..." / "removeFrom..." method an appropriate join record is created or removed.</P>
<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>Currently 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>
<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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
Modified: websites/staging/cayenne/trunk/content/doc12/general-navigation.html
==============================================================================
--- websites/staging/cayenne/trunk/content/doc12/general-navigation.html (original)
+++ websites/staging/cayenne/trunk/content/doc12/general-navigation.html Wed Oct 31 19:57:39 2012
@@ -11,7 +11,19 @@
<script type="text/javascript" src="/js/scripts.js"></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">
+
+
+
+<hr>
+<div id="content">
<H3><A name="GeneralNavigation-GeneralNavigation"></A>General Navigation</H3>
@@ -66,8 +78,11 @@
<P>Cayenne allows to store queries in the DataMap. There are three types of Cayenne queries that can be created in the Modeler - object select query, raw SQL query, and procedure 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.
+ <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
+</div>
+</div>
+</div></div>
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));