You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cayenne.apache.org by aa...@apache.org on 2009/05/17 15:54:22 UTC
svn commit: r775651 - in /cayenne/main/trunk/docs/doc/src/main/resources: ./
doc/Documentation/Cayenne Guide/Quick Start/Tutorial Webapp/
doc/Documentation/Overview/Guide to 3.0 Features/
Author: aadamchik
Date: Sun May 17 13:54:22 2009
New Revision: 775651
URL: http://svn.apache.org/viewvc?rev=775651&view=rev
Log:
CAY-1151 Update web app tutorial - JettyLauncher plugin does not work with Eclipse Ganymede release or newer
(also added notes on M6 new features
Removed:
cayenne/main/trunk/docs/doc/src/main/resources/doc/Documentation/Cayenne Guide/Quick Start/Tutorial Webapp/jetty-run.jpg
Modified:
cayenne/main/trunk/docs/doc/src/main/resources/RELEASE-NOTES.txt
cayenne/main/trunk/docs/doc/src/main/resources/doc/Documentation/Cayenne Guide/Quick Start/Tutorial Webapp/index.html
cayenne/main/trunk/docs/doc/src/main/resources/doc/Documentation/Overview/Guide to 3.0 Features/index.html
Modified: cayenne/main/trunk/docs/doc/src/main/resources/RELEASE-NOTES.txt
URL: http://svn.apache.org/viewvc/cayenne/main/trunk/docs/doc/src/main/resources/RELEASE-NOTES.txt?rev=775651&r1=775650&r2=775651&view=diff
==============================================================================
--- cayenne/main/trunk/docs/doc/src/main/resources/RELEASE-NOTES.txt (original)
+++ cayenne/main/trunk/docs/doc/src/main/resources/RELEASE-NOTES.txt Sun May 17 13:54:22 2009
@@ -25,6 +25,7 @@
CAY-1146 Move User properties API to ObjectContext & BaseContext
CAY-1147 Remove id reading functionality from ResultIterator
CAY-1150 Generated DataMap classes should contain public constants for all query names
+CAY-1151 Update web app tutorial - JettyLauncher plugin does not work with Eclipse Ganymede release or newer
CAY-1153 MySQL : Enable views during reverse engineering
CAY-1154 Rename .access.reveng package to .map.naming
CAY-1156 Modeler search improvement
Modified: cayenne/main/trunk/docs/doc/src/main/resources/doc/Documentation/Cayenne Guide/Quick Start/Tutorial Webapp/index.html
URL: http://svn.apache.org/viewvc/cayenne/main/trunk/docs/doc/src/main/resources/doc/Documentation/Cayenne%20Guide/Quick%20Start/Tutorial%20Webapp/index.html?rev=775651&r1=775650&r2=775651&view=diff
==============================================================================
--- cayenne/main/trunk/docs/doc/src/main/resources/doc/Documentation/Cayenne Guide/Quick Start/Tutorial Webapp/index.html (original)
+++ cayenne/main/trunk/docs/doc/src/main/resources/doc/Documentation/Cayenne Guide/Quick Start/Tutorial Webapp/index.html Sun May 17 13:54:22 2009
@@ -61,7 +61,7 @@
<li><a href="../../../../Documentation/Cayenne Guide/Customization/index.html">Customization</a></li>
</ul>
</div>
-<div id="ConfluenceContent"><p>Now we'll convert the tutorial that we created to a web application. The web part of it is done in JSP and is intentionally primitive from the UI perspective, to concentrate on Cayenne integration aspect. There may be some specifics depending on the web framework used (JSP, Struts, JSF, Click, WebWork, Tapestry, etc.), still the procedure outlined here is quite universal as it relies on the J2EE servlet specification.</p>
+<div id="ConfluenceContent"><p>Now we'll convert the tutorial that we created to a web application. The web part of it is done in JSP, which is the least common denominator of the Java web technologies, and is intentionally simplistic from the UI perspective, to concentrate on Cayenne integration aspect, rather than the interface. Other web frameworks may have some specifics, still the procedure outlined here is quite universal as it is based on the Java servlet specification.</p>
<p>A typical Cayenne web application works like this:</p>
@@ -74,11 +74,10 @@
<p>For detailed discussion of web application deployment, check <a href="../../../../Documentation/Cayenne Guide/Deployment/Web Applications/index.html" title="Web Applications">this page</a>.</p>
-<p>To run the web application from Eclipse, we will use <span class="nobr"><a href="http://jettylauncher.sourceforge.net/" title="Visit page outside Confluence" rel="nofollow">JettyLauncher plugin<sup><img class="rendericon" src="../../../../images/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span>. If you are using something else (e.g. a Tomcat plugin) it should probably work as well.</p>
+<p>To run the web application from Eclipse, we will use <span class="nobr"><a href="http://code.google.com/p/run-jetty-run/" title="Visit page outside Confluence" rel="nofollow">run-jetty-run plugin<sup><img class="rendericon" src="../../../../images/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span>. If you prefer another way to start web applications (e.g. via Eclipse WTP), it should work as well.</p>
<ul>
- <li><span class="nobr"><a href="http://jetty.mortbay.org" title="Visit page outside Confluence" rel="nofollow">Download<sup><img class="rendericon" src="../../../../images/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span> and unpack Jetty web container (tested version is 5.1.3).</li>
- <li><span class="nobr"><a href="http://sourceforge.net/project/showfiles.php?group_id=118870" title="Visit page outside Confluence" rel="nofollow">Download<sup><img class="rendericon" src="../../../../images/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span> and unpack JettyLauncher to a local directory. Install it in Eclipse (<tt>"Help > Find and Install"</tt>).</li>
+ <li>Install <tt>run-jetty-run</tt> plugin via Eclipse "Software Updates" function, following <span class="nobr"><a href="http://code.google.com/p/run-jetty-run/wiki/GettingStarted" title="Visit page outside Confluence" rel="nofollow">instructions on run-jetty-run website<sup><img class="rendericon" src="../../../../images/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span>.</li>
</ul>
@@ -235,13 +234,11 @@
</div></div>
<ul>
- <li>Run the application. Go to "Run > Run..." menu, select "Jetty Web", right click and select "New"</li>
- <li>Make sure project is "cayenne-tutorial", webapp root is "webapp" and Jetty home points to a directory where you unpacked Jetty:</li>
+ <li>Run the application. Go to "Run > Run..." menu, select "Jetty Webapp", right click and select "New"</li>
+ <li>Make sure project is "cayenne-tutorial", webapp dir is "webapp".</li>
</ul>
-<p><img src="jetty-run.jpg" align="absmiddle" border="0" /></p>
-
<ul>
<li>Click "Apply" and "Run".</li>
<li>You will see some Cayenne logs, indicating that the filter was loaded and Cayenne is successfully runing in web app.</li>
Modified: cayenne/main/trunk/docs/doc/src/main/resources/doc/Documentation/Overview/Guide to 3.0 Features/index.html
URL: http://svn.apache.org/viewvc/cayenne/main/trunk/docs/doc/src/main/resources/doc/Documentation/Overview/Guide%20to%203.0%20Features/index.html?rev=775651&r1=775650&r2=775651&view=diff
==============================================================================
--- cayenne/main/trunk/docs/doc/src/main/resources/doc/Documentation/Overview/Guide to 3.0 Features/index.html (original)
+++ cayenne/main/trunk/docs/doc/src/main/resources/doc/Documentation/Overview/Guide to 3.0 Features/index.html Sun May 17 13:54:22 2009
@@ -71,13 +71,17 @@
<p>Stopped supporting <tt>DerivedDbEntity</tt> - its functionality (aggregate queries) is achieved via EJBQL and other means.</p>
+<h3><a name="Guideto3.0Features-DataMapDTDReplacedwithSchema"></a>DataMap DTD Replaced with Schema</h3>
+
+<p>A schema is now available <span class="nobr"><a href="http://cayenne.apache.org/schema/3.0/modelMap.html" title="Visit page outside Confluence" rel="nofollow">here<sup><img class="rendericon" src="../../../images/linkext7.gif" height="7" width="7" align="absmiddle" alt="" border="0"/></sup></a></span> for the DataMap XML format.</p>
+
<h3><a name="Guideto3.0Features-Embeddables"></a>Embeddables</h3>
-<p><em>(as of M4 there's no Modeler support)</em></p>
+<p><em>(as of M6 there's no Modeler support)</em></p>
<p>Added a new mapping artifact - Embeddable, that allows to map composite objects to a single table. </p>
<h3><a name="Guideto3.0Features-FlattenedAttributes"></a>Flattened Attributes</h3>
-<p><em>(as of M4 there's no Modeler support)</em></p>
+<p><em>(as of M6 there's no Modeler support)</em></p>
<p>Just like with "flattened" relationships, now there is a way to map an ObjAttribute that spans one or more DbRelationships and is mapped to a column of a joined table.</p>
@@ -187,13 +191,8 @@
<h3><a name="Guideto3.0Features-POJOPersistence"></a>POJO Persistence</h3>
-<p><em>(status: preview)</em></p>
-
-<ul>
- <li>Implemented class enhancer to enhance POJO's into org.apache.cayenne.Persistent</li>
-</ul>
-
+<p><em>(status: experimental. Unlikely to be production ready in 3.0)</em></p>
<h2><a name="Guideto3.0Features-RemoteObjectPersistence"></a>Remote Object Persistence</h2>
@@ -227,6 +226,9 @@
<li>Reopen Last Project on Startup</li>
<li>Added progress/log view</li>
<li>Added SQL syntax highlighting.</li>
+ <li>Added EJBQL Query mapping capabilities, with synatx highlighting.</li>
+ <li>Added support for quoting of SQL Identifiers</li>
+ <li>The Modeler can be <a href="../../../Documentation/Cayenne Guide/Maven2 Plugins/maven2-modeler/index.html" title="maven2-modeler">started from Maven</a></li>
</ul>
@@ -259,12 +261,22 @@
<pre class="code-java">org.apache.log4j.PropertyConfigurator.configure(<span class="code-quote">"cayenne-log.properties"</span>);</pre>
</div></div>
+<h3><a name="Guideto3.0Features-OptionalQuotingofSQLIdentifiers"></a>Optional Quoting of SQL Identifiers</h3>
+
+<p>Cayenne now supports optional quoting of SQL identifiers in the generated SQL. This has been a very popular request in the past. Identifier quoting can be turned on per DataMap in the Modeler (look for "Quote SQL Identifiers" checkbox). This will allow to map column names that contain spaces, non-ascii characters, reserved words, etc., i.e. the schemas that could not be mapped with Cayenne before.</p>
+
+<h3><a name="Guideto3.0Features-AbilitytoDetectMissing%2FPartialSchemaandAutoGenerateSchemainRuntime"></a>Ability to Detect Missing/Partial Schema and Auto Generate Schema in Runtime</h3>
+
+<p><em>(status: as of M6 column consistency checks)</em></p>
+
+<p>DataNode has a new attribute in the Modeler - "Schema Update Strategy". This allows to specify runtime behavior in regards to schema consistency checking. The default behavior is "do nothing" (<tt>org.apache.cayenne.access.dbsync.SkipSchemaUpdateStrategy</tt>). Alternatively Cayenne can create the schema if none is found or throw an exception if schema inconsistencies are detected.</p>
<h2><a name="Guideto3.0Features-Tools"></a>Tools</h2>
<ul>
<li>Switched <tt>"cgen"</tt> to "version 1.2" of the template as a default version</li>
<li>Support for classpath in <tt>"cdbgen"</tt>.</li>
+ <li>The Modeler can be <a href="../../../Documentation/Cayenne Guide/Maven2 Plugins/maven2-modeler/index.html" title="maven2-modeler">started from Maven</a>, that can potentially help in aligning the Modeler version with the project runtime Cayenne version.</li>
</ul>
</div>
</div>