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>
