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 2010/03/29 09:38:42 UTC
svn commit: r928621 - in
/cayenne/main/branches/STABLE-3.0/docs/doc/src/main/resources/doc/Documentation:
Cayenne Guide/Queries/SQLTemplate Query/SQLTemplate Result Mapping/
Overview/Guide to 3.0 Features/ Remote Object Persistence Guide/Remote
Object ...
Author: aadamchik
Date: Mon Mar 29 07:38:42 2010
New Revision: 928621
URL: http://svn.apache.org/viewvc?rev=928621&view=rev
Log:
documentation update
Modified:
cayenne/main/branches/STABLE-3.0/docs/doc/src/main/resources/doc/Documentation/Cayenne Guide/Queries/SQLTemplate Query/SQLTemplate Result Mapping/index.html
cayenne/main/branches/STABLE-3.0/docs/doc/src/main/resources/doc/Documentation/Overview/Guide to 3.0 Features/index.html
cayenne/main/branches/STABLE-3.0/docs/doc/src/main/resources/doc/Documentation/Remote Object Persistence Guide/Remote Object Persistence Tutorial/Remote Object Persistence Tutorial Prerequisites/index.html
Modified: cayenne/main/branches/STABLE-3.0/docs/doc/src/main/resources/doc/Documentation/Cayenne Guide/Queries/SQLTemplate Query/SQLTemplate Result Mapping/index.html
URL: http://svn.apache.org/viewvc/cayenne/main/branches/STABLE-3.0/docs/doc/src/main/resources/doc/Documentation/Cayenne%20Guide/Queries/SQLTemplate%20Query/SQLTemplate%20Result%20Mapping/index.html?rev=928621&r1=928620&r2=928621&view=diff
==============================================================================
--- cayenne/main/branches/STABLE-3.0/docs/doc/src/main/resources/doc/Documentation/Cayenne Guide/Queries/SQLTemplate Query/SQLTemplate Result Mapping/index.html (original)
+++ cayenne/main/branches/STABLE-3.0/docs/doc/src/main/resources/doc/Documentation/Cayenne Guide/Queries/SQLTemplate Query/SQLTemplate Result Mapping/index.html Mon Mar 29 07:38:42 2010
@@ -83,7 +83,7 @@
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">SQLTemplate query = <span class="code-keyword">new</span> SQLTemplate(Artist.class, <span class="code-quote">"SELECT * FROM ARTIST"</span>);
-<span class="code-comment">// *** Force DataRows
+<span class="code-comment">// Force DataRows
</span>query.setFetchingDataRows(<span class="code-keyword">true</span>);
<span class="code-comment">// List of DataRow
@@ -92,15 +92,15 @@
<h3><a name="SQLTemplateResultMapping-ScalarResults"></a>Scalar Results</h3>
-<p>To select a list of scalar values, you will need to use a SQLResultSetMapping class to tell Cayenne how to deal with it:</p>
+<p>To select a list of scalar values, you will need to use a <tt>SQLResult</tt> class to tell Cayenne how to deal with it:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">SQLTemplate query = <span class="code-keyword">new</span> SQLTemplate(Painting.class, <span class="code-quote">"SELECT ESTIMATED_PRICE P FROM PAINTING"</span>);
<span class="code-comment">// *** let Cayenne know that result is a scalar
-</span>SQLResultSetMapping rsMap = <span class="code-keyword">new</span> SQLResultSetMapping();
-rsMap.addColumnResult(<span class="code-quote">"P"</span>);
-query.setResultSetMapping(rsMap);
+</span>SQLResult resultDescriptor = <span class="code-keyword">new</span> SQLResult();
+resultDescriptor.addColumnResult(<span class="code-quote">"P"</span>);
+query.setResult(resultDescriptor);
<span class="code-comment">// List of <span class="code-object">Number</span>'s
</span>List prices = context.performQuery(query);</pre>
@@ -112,9 +112,9 @@ query.setResultSetMapping(rsMap);
<pre class="code-java">SQLTemplate query = <span class="code-keyword">new</span> SQLTemplate(Painting.class, <span class="code-quote">"SELECT SUM(ESTIMATED_PRICE) S FROM PAINTING"</span>);
<span class="code-comment">// *** let Cayenne know that result is a scalar
-</span>SQLResultSetMapping rsMap = <span class="code-keyword">new</span> SQLResultSetMapping();
-rsMap.addColumnResult(<span class="code-quote">"S"</span>);
-query.setResultSetMapping(rsMap);
+</span>SQLResult resultDescriptor = <span class="code-keyword">new</span> SQLResult();
+resultDescriptor.addColumnResult(<span class="code-quote">"S"</span>);
+query.setResult(resultDescriptor);
<span class="code-comment">// List of <span class="code-object">Number</span>'s
</span><span class="code-object">Number</span> assetsValue = (<span class="code-object">Number</span>) DataObjectUtils.objectForQuery(context, query)</pre>
@@ -122,7 +122,7 @@ query.setResultSetMapping(rsMap);
<h3><a name="SQLTemplateResultMapping-MixedResults"></a>Mixed Results</h3>
-<p>SQLResultSetMapping can be used to fetch a mix of objects and scalars. In this case the result will be <tt>Object[]</tt> that contains scalars and objects in the order they were configured in SQLResultSetMapping:</p>
+<p><tt>SQLResult</tt> can be used to fetch a mix of objects and scalars. In this case the result will be <tt>Object[]</tt> that contains scalars and objects in the order they were configured in SQLResultSetMapping:</p>
<div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent">
<pre class="code-java">SQLTemplate query = <span class="code-keyword">new</span> SQLTemplate(Artist.class, <span class="code-quote">"SELECT t0.ARTIST_ID, t0.NAME, t0.DATE_OF_BIRTH, COUNT(t1.PAINTING_ID) C "</span> +
@@ -135,10 +135,10 @@ artistResult.addDbField(Artist.ARTIST_ID
artistResult.addObjectField(Artist.NAME_PROPERTY, <span class="code-quote">"NAME"</span>);
artistResult.addObjectField(Artist.DATE_OF_BIRTH_PROPERTY, <span class="code-quote">"DATE_OF_BIRTH"</span>);
-SQLResultSetMapping rsMap = <span class="code-keyword">new</span> SQLResultSetMapping();
-rsMap.addEntityResult(artistResult);
-rsMap.addColumnResult(<span class="code-quote">"C"</span>);
-query.setResultSetMapping(rsMap);
+SQLResult resultDescriptor = <span class="code-keyword">new</span> SQLResult();
+resultDescriptor.addEntityResult(artistResult);
+resultDescriptor.addColumnResult(<span class="code-quote">"C"</span>);
+query.setResult(resultDescriptor);
<span class="code-comment">// List of <span class="code-object">Object</span>[]
</span><span class="code-object">Number</span> assetsValue = (<span class="code-object">Number</span>) DataObjectUtils.objectForQuery(context, query)</pre>
Modified: cayenne/main/branches/STABLE-3.0/docs/doc/src/main/resources/doc/Documentation/Overview/Guide to 3.0 Features/index.html
URL: http://svn.apache.org/viewvc/cayenne/main/branches/STABLE-3.0/docs/doc/src/main/resources/doc/Documentation/Overview/Guide%20to%203.0%20Features/index.html?rev=928621&r1=928620&r2=928621&view=diff
==============================================================================
--- cayenne/main/branches/STABLE-3.0/docs/doc/src/main/resources/doc/Documentation/Overview/Guide to 3.0 Features/index.html (original)
+++ cayenne/main/branches/STABLE-3.0/docs/doc/src/main/resources/doc/Documentation/Overview/Guide to 3.0 Features/index.html Mon Mar 29 07:38:42 2010
@@ -119,7 +119,7 @@
<ul>
<li><a href="../../../Documentation/Cayenne Guide/Queries/SQLTemplate Query/Advanced SQLTemplate/index.html" title="Advanced SQLTemplate">Significantly simplified</a> the process for fetching DataObjects (vs. DataRows) via a SQLTemplate query with <tt>'setColumnNamesCapitalization'</tt> method.</li>
- <li>Added support for <a href="../../../Documentation/Cayenne Guide/Queries/SQLTemplate Query/SQLTemplate Result Mapping/index.html" title="SQLTemplate Result Mapping">fetching scalar and mixed scalar/object results</a> using <tt>SQLResultSetMapping</tt>.</li>
+ <li>Added support for <a href="../../../Documentation/Cayenne Guide/Queries/SQLTemplate Query/SQLTemplate Result Mapping/index.html" title="SQLTemplate Result Mapping">fetching scalar and mixed scalar/object results</a> using <tt>SQLResult</tt>.</li>
</ul>
Modified: cayenne/main/branches/STABLE-3.0/docs/doc/src/main/resources/doc/Documentation/Remote Object Persistence Guide/Remote Object Persistence Tutorial/Remote Object Persistence Tutorial Prerequisites/index.html
URL: http://svn.apache.org/viewvc/cayenne/main/branches/STABLE-3.0/docs/doc/src/main/resources/doc/Documentation/Remote%20Object%20Persistence%20Guide/Remote%20Object%20Persistence%20Tutorial/Remote%20Object%20Persistence%20Tutorial%20Prerequisites/index.html?rev=928621&r1=928620&r2=928621&view=diff
==============================================================================
--- cayenne/main/branches/STABLE-3.0/docs/doc/src/main/resources/doc/Documentation/Remote Object Persistence Guide/Remote Object Persistence Tutorial/Remote Object Persistence Tutorial Prerequisites/index.html (original)
+++ cayenne/main/branches/STABLE-3.0/docs/doc/src/main/resources/doc/Documentation/Remote Object Persistence Guide/Remote Object Persistence Tutorial/Remote Object Persistence Tutorial Prerequisites/index.html Mon Mar 29 07:38:42 2010
@@ -55,7 +55,7 @@
<div id="ConfluenceContent"><p>This tutorial starts where the <a href="../../../../Documentation/Cayenne Guide/Tutorial/index.html" title="Tutorial">Cayenne Tutorial</a> left off. If you have gone through the previous tutorial, and have the "tutorial" project open in Eclipse, you can go directly to the <a href="../../../../Documentation/Remote Object Persistence Guide/Remote Object Persistence Tutorial/Remote Object Persistence Tutorial Client Project/index.html" title="Remote Object Persistence Tutorial Client Project">next step</a>. If not, here are the compressed instructions to prepare you for work with ROP:</p>
<ul>
- <li><a href="/confluence/pages/createpage.action?spaceKey=CAYDOC30&title=Step%201%20-%20Eclipse%20Setup&linkCreation=true&fromPageId=5966303" class="createlink">Step 1 - Eclipse Setup</a></li>
+ <li><a href="../../../../Documentation/Cayenne Guide/Tutorial/Tutorial Setup/index.html" title="Tutorial Setup">Step 1 - Eclipse Setup</a></li>
<li><a href="../../../../Documentation/Cayenne Guide/Tutorial/Tutorial Starting Project/index.html" title="Tutorial Starting Project">Step 2 - Create a project</a></li>
<li><a href="../../../../Documentation/Cayenne Guide/Tutorial/Tutorial Object Relational Mapping/index.html" title="Tutorial Object Relational Mapping">Step 3 - Create Cayenne OR Mapping</a></li>
<li><a href="../../../../Documentation/Cayenne Guide/Tutorial/Tutorial Java Classes/index.html" title="Tutorial Java Classes">Step 4 - Create Java Classes</a></li>