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 [23/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/understanding-transactions.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/understanding-transactions.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/understanding-transactions.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » Understanding Transactions
+<!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 » Understanding Transactions</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>
- <P>Cayenne has its own simple transaction API centered around <TT>org.apache.cayenne.access.Transaction</TT> class. Its goal is to ensure consistency of the DataContext database operations. It works either as a standalone mechanism, or in conjunction with another transaction framework, such as JTA or Spring. To switch between the two modes of operation, use "Container-Managed Transactions" checkbox in the DataDomain editing panel in CayenneModeler:</P>
+<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 has its own simple transaction API centered around <TT>org.apache.cayenne.access.Transaction</TT> class. Its goal is to ensure consistency of the DataContext database operations. It works either as a standalone mechanism, or in conjunction with another transaction framework, such as JTA or Spring. To switch between the two modes of operation, use "Container-Managed Transactions" checkbox in the DataDomain editing panel in CayenneModeler:</P>
<P><SPAN class="image-wrap" style=""><IMG src="understanding-transactions.data/transactions-types.png" style="border: 0px solid black"></SPAN></P>
@@ -137,3 +185,12 @@ Transaction tx = domain.createTransactio
}
</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/upgrade.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/upgrade.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/upgrade.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » Upgrade
-
- <H3><A name="Upgrade-GeneralUpgradeRecommendations"></A>General Upgrade Recommendations</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 » Upgrade</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="Upgrade-GeneralUpgradeRecommendations"></A>General Upgrade Recommendations</H3>
<UL>
<LI>Consult <TT>UPGRADE.txt</TT> and <TT>RELEASE-NOTES.txt</TT> files in the release you just downloaded for the most up to date instructions.</LI>
@@ -200,3 +248,12 @@ Title: 3.0 » Upgrade
<LI>ObjectStore no longer stores database snapshots of object. As a result a method "retainSnapshot(DataObject object)" is removed, as its meaningful deprecation is not possible.</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/using-jndi.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/using-jndi.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/using-jndi.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » Using JNDI
-
- <P>Cayenne can be setup to obtain a DataSource via JNDI, instead of using its own connection pool. To do that Cayenne DataNodes must be configured to use <TT>JNDIDataSourceFactory</TT>. This can be done in the modeler as shown on the pictures below.</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 » Using JNDI</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 can be setup to obtain a DataSource via JNDI, instead of using its own connection pool. To do that Cayenne DataNodes must be configured to use <TT>JNDIDataSourceFactory</TT>. This can be done in the modeler as shown on the pictures below.</P>
<P>1. Select JNDIDataSourceFactory:<BR>
<SPAN class="image-wrap" style=""><IMG src="using-jndi.data/jndi-step1.jpg" style="border: 0px solid black"></SPAN></P>
@@ -59,3 +107,12 @@ Title: 3.0 » Using JNDI
</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/using-orderings.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/using-orderings.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/using-orderings.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » Using Orderings
-
- <P>To sort SelectQuery results, Orderings are used. Orderings use path expressions discussed in the previous section to identify the attributes that must be used in sorting. Orderings also use a SortOrder to identify how the ordering should be performed.</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 » Using Orderings</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>To sort SelectQuery results, Orderings are used. Orderings use path expressions discussed in the previous section to identify the attributes that must be used in sorting. Orderings also use a SortOrder to identify how the ordering should be performed.</P>
<P>There are 4 SortOrder options:</P>
@@ -66,3 +114,12 @@ orderings.add(<SPAN class="code-keyword"
</SPAN>Ordering.orderList(list, orderings);
</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/web-applications.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.0/web-applications.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.0/web-applications.html Fri Nov 9 07:29:01 2012
@@ -1,6 +1,54 @@
-Title: 3.0 » Web Applications
-
- <H3><A name="WebApplications-PuttingCayenneFilesinWebApplicationCLASSPATH"></A>Putting Cayenne Files in Web Application CLASSPATH</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 » Web Applications</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="WebApplications-PuttingCayenneFilesinWebApplicationCLASSPATH"></A>Putting Cayenne Files in Web Application CLASSPATH</H3>
<P>When deploying an application in a web container it is possible to follow the procedure for the standalone applications, i.e. put all XML files in the application CLASSPATH (e.g. in "mywebapp/WEB-INF/classes/", but DON'T put it in container shared locations!). Session DataContext can be obtained via ServletUtil:</P>
@@ -74,3 +122,12 @@ WEB-INF/lib/...</PRE>
<P>ServletUtil and WebApplicationContextFilter would both provide an ObjectContext shared between the requests in the same user session (session-scoped context). This is the default behavior. However, depending on the application needs, you may choose to use application-scoped context (usually for read-only parts of the application, and combined with caching), or per-request context (to avoid race conditions on long-running operations). In those cases you won't be able to use ServletUtil and WebApplicationContextFilter, but you can easily write your own correctly scoped replacements, or set it up via an IoC container, such as Spring.</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.1/index.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/3.1/index.html (original)
+++ websites/staging/cayenne/trunk/content/docs/3.1/index.html Fri Nov 9 07:29:01 2012
@@ -98,11 +98,11 @@
<div id="content">
<h2 id="documentation-for-cayenne-31">Documentation for Cayenne 3.1</h2>
<ul>
-<li><a href="/doc/3.1/cayenne-guide/index.html">Cayenne Guide</a></li>
-<li><a href="/doc/3.1/tutorial/index.html">Tutorial</a></li>
-<li><a href="/doc/3.1/tutorial-rop/index.html">ROP Tutorial</a></li>
-<li><a href="/doc/3.1/upgrade-guide/index.html">Upgrade Guide</a></li>
-<li><a href="/doc/3.1/api/index.html">JavaDoc</a></li>
+<li><a href="cayenne-guide/index.html">Cayenne Guide</a></li>
+<li><a href="tutorial/index.html">Tutorial</a></li>
+<li><a href="tutorial-rop/index.html">ROP Tutorial</a></li>
+<li><a href="upgrade-guide/index.html">Upgrade Guide</a></li>
+<li><a href="api/index.html">JavaDoc</a></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>.
Modified: websites/staging/cayenne/trunk/content/docs/index.html
==============================================================================
--- websites/staging/cayenne/trunk/content/docs/index.html (original)
+++ websites/staging/cayenne/trunk/content/docs/index.html Fri Nov 9 07:29:01 2012
@@ -100,11 +100,11 @@
<p>Documentation, the JavaDoc API, examples and articles can all be found
here.</p>
<ul>
-<li><a href="/doc/3.1/tutorial/index.html">Getting Started (3.1)</a></li>
-<li><a href="/doc/3.1/index.html">Version 3.1 (beta)</a></li>
-<li><a href="/doc/3.0/index.html">Version 3.0 (stable)</a></li>
-<li><a href="/doc/2.0/index.html">Version 2.0 (legacy)</a></li>
-<li><a href="/doc/1.2/index.html">Version 1.2 (legacy)</a></li>
+<li><a href="/docs/3.1/tutorial/index.html">Getting Started (3.1)</a></li>
+<li><a href="/docs/3.1/index.html">Version 3.1 (beta)</a></li>
+<li><a href="/docs/3.0/index.html">Version 3.0 (stable)</a></li>
+<li><a href="/docs/2.0/index.html">Version 2.0 (legacy)</a></li>
+<li><a href="/docs/1.2/index.html">Version 1.2 (legacy)</a></li>
</ul>
<h2 id="external-documentation">External Documentation</h2>
<p>This section lists documentation and reference materials that are