Author: rineholt
Date: Wed Oct 4 06:35:16 2006
New Revision: 452882
URL: http://svn.apache.org/viewvc?view=rev&rev=452882
Log:
TUSCANY-778
http://issues.apache.org/jira/browse/TUSCANY-778
Modified:
incubator/tuscany/site/site-author/java_das_overview.xml
incubator/tuscany/site/site-publish/java_das_overview.html
Modified: incubator/tuscany/site/site-author/java_das_overview.xml
URL:
http://svn.apache.org/viewvc/incubator/tuscany/site/site-author/java_das_overview.xml?view=diff&rev=452882&r1=452881&r2=452882
==============================================================================
--- incubator/tuscany/site/site-author/java_das_overview.xml (original)
+++ incubator/tuscany/site/site-author/java_das_overview.xml Wed Oct 4
06:35:16 2006
@@ -66,7 +66,32 @@
<li><p>Partial row updates</p></li>
</ul>
- <p>The Tuscany wiki also contains an area for <a class="external"
rel="nofollow"
href="http://wiki.apache.org/ws/Tuscany/TuscanyJava/DAS_Java_Overview";>raw
thoughts and current plans on DAS subproject</a>.
+ <h3>DAS M2 release - Key features</h3>
+ <ul>
+ <li>DAS Core features</li>
+ <ul>
+ <li><p>MySQL support</p></li>
+ <li><p>Static Data Objects</p></li>
+ <li><p>Dynamic root for static graphs</p></li>
+ <li><p>"Unique" attribute on relationships</p></li>
+ <li><p>Explicit ResultSet shape definition</p></li>
+ <li><p>Improved logging</p></li>
+ <li><p>Programmatic Configuration</p></li>
+ <li><p>Helper for empty SDO Graph</p></li>
+ <li><p>Convention over configuration</p></li>
+ <ul>
+ <li><p>Column named "ID" is the PK</p></li>
+ <li><p>Column named "xxx_ID" is the FK to table "xxx"</p></li>
+ </ul>
+ </ul>
+ <li>DAS Samples</li>
+ <ul>
+ <li><p>Tomcat integration and automated DAS samples testing
(htmlUnit)</p></li>
+ <li><p>DAS Samples now have all dependencies and source code inside
the sample war</p></li>
+ </ul>
+ </ul>
+
+ <p>You can also look at our <a class="external" rel="nofollow"
href="http://wiki.apache.org/ws/Tuscany/TuscanyJava/DAS_Java_Overview";>Tuscany
DAS Wiki</a> for more updated and live information. .
</p>
@@ -116,7 +141,7 @@
<p>Commands:</p>
<p>md <local tuscany dir> <br/>
cd <local tuscany dir> <br/>
- svn co -N <a rel="nofollow"
href="https://svn.apache.org/repos/asf/incubator/tuscany/java";>https://svn.apache.org/repos/asf/incubator/tuscany/java</a>
<br/>
+ svn co <a rel="nofollow"
href="https://svn.apache.org/repos/asf/incubator/tuscany/java";>https://svn.apache.org/repos/asf/incubator/tuscany/java</a>
<br/>
cd java <br/>
svn up das <br/>
</p>
@@ -181,6 +206,133 @@
<li><p>xsd-2.2.0-SNAPSHOT.jar - the XML Schema model</p></li>
</ul>
+ </section>
+
+
+ <section name="Running DAS Samples">
+ <p>DAS provide sample a CompanyWeb scenario where it exposes some of the
DAS Features integrated in a J2EE webapp.</p>
+ <p>Follow the steps below to be able to run the samples in a J2EE
webserver (in our case Apache Tomcat)</p>
+
+ <p><strong>From the source repository</strong></p>
+
+ <ul>
+ <li><p>checkout DAS Sample from SVN repository:</p></li>
+ <ul>
+ <li><p>md 'local tuscany dir'</p></li>
+ <li><p>cd 'local tuscany dir'</p></li>
+ <li><p>svn co
https://svn.apache.org/repos/asf/incubator/tuscany/java/das das</p></li>
+ </ul>
+ <li><p>use maven to build the CompanyWeb war file:</p></li>
+ <ul>
+ <li><p>cd das\samples</p></li>
+ <li><p>mvn</p></li>
+ </ul>
+ <li><p>use maven to deploy the CompanyWeb war file to Tomcat</p></li>
+ <ul>
+ <li><p>mvn tomcat:deploy</p></li>
+ </ul>
+ </ul>
+
+ <p><strong>From a DAS Sample distribution (starting with
M2)</strong>:</p>
+
+ <ul>
+ <li><p>Download a das-sample distribution from
http://incubator.apache.org/tuscany/downloads.html</p></li>
+ <li><p>Extract the companyweb war file</p></li>
+ <li><p>Follow regular deployment procedures to deploy the war
file</p></li>
+ </ul>
+ </section>
+
+ <section name="Running Tuscany DAS Unit Tests">
+ <p>DAS is currently providing two sets of unit tests</p>
+ <ul>
+ <li><p>JUnit tests for the core DAS code</p></li>
+ <li><p>HTMLUnit tests integrated with Tomcat for DAS CompanyWeb
sample application</p></li>
+ </ul>
+ <p>Below we are going to describe how you can exercise these two sets of
tests, and we recommend you running them after contributing code/patches for
DAS
+ to validate that your new changes are not introducing any
regressions.</p>
+
+ <p><strong>Running DAS tests as part of the build</strong></p>
+ <ul>
+ <li><p>cd 'local tuscany dir'/java/das</p></li>
+ <li><p>mvn test</p></li>
+
+ <p>
+ -------------------------------------------------------<br/>
+ T E S T S<br/>
+ -------------------------------------------------------<br/>
+ Running
org.apache.tuscany.das.rdb.test.suites.AllTestsDerby<br/>
+ Setting up for Derby run<br/>
+ Ending Derby run<br/>
+ Tests run: 137, Failures: 0, Errors: 0, Skipped: 0, Time
elapsed: 33.468 sec<br/>
+ <br/>
+ Results :<br/>
+ <br/>
+ Tests run: 137, Failures: 0, Errors: 0, Skipped: 0<br/>
+ <br/>
+ [INFO]
------------------------------------------------------------------------<br/>
+ [INFO] BUILD SUCCESSFUL<br/>
+ [INFO]
------------------------------------------------------------------------<br/>
+ [INFO] Total time: 57 seconds<br/>
+ [INFO] Finished at: Tue Oct 03 12:06:13 PDT 2006<br/>
+ [INFO] Final Memory: 5M/10M<br/>
+ [INFO]
------------------------------------------------------------------------<br/>
+ <br/>
+ </p>
+ </ul>
+
+ <p><strong>Running DAS CompanyWeb tests in tomcat</strong></p>
+ <ul>
+ <li><p>Download tomcat distribution into your local filesystem :
http://tomcat.apache.org/</p></li>
+ <li><p>Create a build.properties in your root directory (e.g.
C:\Documents and Settings\lresende in Win2K systems) with the following
contents</p></li>
+ <ul>
+ <li><p>tuscany.acceptance.tomcat.zipped='directory where tomcat
was downloaded'\\apache-tomcat-5.5.17-tuscany.zip</p></li>
+ </ul>
+ <li><p>checkout DAS Sample from SVN repository:</p></li>
+ <ul>
+ <li><p>md 'local tuscany dir'</p></li>
+ <li><p>cd 'local tuscany dir'</p></li>
+ <li><p>svn co
https://svn.apache.org/repos/asf/incubator/tuscany/java/das das</p></li>
+ </ul>
+ <li><p>use maven run the DAS CompanyWeb tests in Tomcat:</p></li>
+ <ul>
+ <li><p>cd das/samples/testing/tomcat</p></li>
+ <li><p>mvn</p></li>
+ <p>
+ -------------------------------------------------------<br/>
+ T E S T S<br/>
+ -------------------------------------------------------<br/>
+ Running org.apache.tuscany.test.das.DasTestCase<br/>
+ Running:HomePage SUCCESS!!!<br/>
+ Running:AllCompanies SUCCESS!!!<br/>
+ Running:AllCompaniesDepartments SUCCESS!!!<br/>
+ Running:AddDepartmentToFirstCompany SUCCESS!!!<br/>
+ Running:ChangeCompanyDepartmentNames SUCCESS!!!<br/>
+ Running:DeleteCompanyOneDepartments SUCCESS!!!<br/>
+ Tests run: 6, Failures: 0, Errors: 0, Skipped: 0, Time elapsed:
14.911 sec<br/>
+ <br/>
+ Results :<br/>
+ <br/>
+ Tests run: 6, Failures: 0, Errors: 0, Skipped: 0<br/>
+ <br/>
+ [INFO]<br/>
+ [INFO]<br/>
+ [INFO]
------------------------------------------------------------------------<br/>
+ [INFO] Reactor Summary:<br/>
+ [INFO]
------------------------------------------------------------------------<br/>
+ [INFO] Tuscany Testing in Tomcat .............................
SUCCESS [0.251s]<br/>
+ [INFO] Tuscany Testing DAS Sample - Companyweb ...............
SUCCESS [1:17.791s]<br/>
+ [INFO]
------------------------------------------------------------------------<br/>
+ [INFO]
------------------------------------------------------------------------<br/>
+ [INFO] BUILD SUCCESSFUL<br/>
+ [INFO]
------------------------------------------------------------------------<br/>
+ [INFO] Total time: 1 minute 18 seconds<br/>
+ [INFO] Finished at: Tue Oct 03 12:25:48 PDT 2006<br/>
+ [INFO] Final Memory: 7M/15M<br/>
+ [INFO]
------------------------------------------------------------------------<br/>
+ </p>
+ <li><p><strong>Note: Due to a current limitation, you must run mvn
clean before you can run the tests a second time</strong></p></li>
+ </ul>
+ </ul>
</section>
Modified: incubator/tuscany/site/site-publish/java_das_overview.html
URL:
http://svn.apache.org/viewvc/incubator/tuscany/site/site-publish/java_das_overview.html?view=diff&rev=452882&r1=452881&r2=452882
==============================================================================
--- incubator/tuscany/site/site-publish/java_das_overview.html (original)
+++ incubator/tuscany/site/site-publish/java_das_overview.html Wed Oct 4
06:35:16 2006
@@ -378,7 +378,31 @@
<li><p>1..1 and 1..n relationships</p></li>
<li><p>Partial row updates</p></li>
</ul>
- <p>The Tuscany wiki also contains
an area for <a class="external" rel="nofollow"
href="http://wiki.apache.org/ws/Tuscany/TuscanyJava/DAS_Java_Overview";>raw
thoughts and current plans on DAS subproject</a>.
+ <h3>DAS M2 release - Key
features</h3>
+ <ul>
+ <li>DAS Core features</li>
+ <ul>
+ <li><p>MySQL support</p></li>
+ <li><p>Static Data Objects</p></li>
+ <li><p>Dynamic root for static graphs</p></li>
+ <li><p>"Unique" attribute on relationships</p></li>
+ <li><p>Explicit ResultSet shape definition</p></li>
+ <li><p>Improved logging</p></li>
+ <li><p>Programmatic Configuration</p></li>
+ <li><p>Helper for empty SDO Graph</p></li>
+ <li><p>Convention over configuration</p></li>
+ <ul>
+ <li><p>Column named "ID" is the PK</p></li>
+ <li><p>Column named "xxx_ID" is the FK to table "xxx"</p></li>
+ </ul>
+ </ul>
+ <li>DAS Samples</li>
+ <ul>
+ <li><p>Tomcat integration and automated DAS samples testing
(htmlUnit)</p></li>
+ <li><p>DAS Samples now have all dependencies and source code inside
the sample war</p></li>
+ </ul>
+ </ul>
+ <p>You can also look at our <a
class="external" rel="nofollow"
href="http://wiki.apache.org/ws/Tuscany/TuscanyJava/DAS_Java_Overview";>Tuscany
DAS Wiki</a> for more updated and live information. .
</p>
<h3>DAS Project Structure</h3>
<p>The DAS RDB project is divided
into three parts:</p>
@@ -437,7 +461,7 @@
<p>Commands:</p>
<p>md <local tuscany dir> <br />
cd <local tuscany dir> <br />
- svn co -N <a rel="nofollow"
href="https://svn.apache.org/repos/asf/incubator/tuscany/java";>https://svn.apache.org/repos/asf/incubator/tuscany/java</a>
<br />
+ svn co <a rel="nofollow"
href="https://svn.apache.org/repos/asf/incubator/tuscany/java";>https://svn.apache.org/repos/asf/incubator/tuscany/java</a>
<br />
cd java <br />
svn up das <br />
</p>
@@ -493,6 +517,172 @@
<li><p>emf-ecore-xmi-2.2.0-SNAPSHOT.jar - EMF's default XML
(and XMI) serializer and loader</p></li>
<li><p>xsd-2.2.0-SNAPSHOT.jar - the XML Schema model</p></li>
</ul>
+ </div>
+ </td>
+ <td background="images/WhiteR.png" width="14"></td>
+ </tr>
+
+ <tr>
+ <td background="images/WhiteBL.png" width="15"
height="14"></td>
+ <td background="images/WhiteB.png" ></td>
+ <td background="images/WhiteBR.png" width="14"></td>
+ </tr>
+
+ </table>
+ <table class="content"
border="0" width="90%" cellspacing="0" cellpadding="0" align="center">
+ <tr class="title" height="17" background="images/TitleC.png">
+ <td align="left">
+ <img src="images/TitleL.png" width="15"
height="17" alt=""></td>
+ <td align="center" height="17" id="title"
background="images/TitleC.png">
+ <a href="#">Running DAS Samples</a>
+ </td>
+ <td align="right">
+ <img src="images/TitleR.png" width="14"
height="17" alt=""></td>
+ </tr>
+ <tr>
+ <td background="images/WhiteL.png" width="15"></td>
+ <td width="100%">
+ <div id="content">
+ <p>DAS provide sample a CompanyWeb
scenario where it exposes some of the DAS Features integrated in a J2EE
webapp.</p>
+ <p>Follow the steps below to be
able to run the samples in a J2EE webserver (in our case Apache Tomcat)</p>
+ <p><strong>From the source
repository</strong></p>
+ <ul>
+ <li><p>checkout DAS Sample from SVN repository:</p></li>
+ <ul>
+ <li><p>md 'local tuscany dir'</p></li>
+ <li><p>cd 'local tuscany dir'</p></li>
+ <li><p>svn co
https://svn.apache.org/repos/asf/incubator/tuscany/java/das das</p></li>
+ </ul>
+ <li><p>use maven to build the CompanyWeb war file:</p></li>
+ <ul>
+ <li><p>cd das\samples</p></li>
+ <li><p>mvn</p></li>
+ </ul>
+ <li><p>use maven to deploy the CompanyWeb war file to Tomcat</p></li>
+ <ul>
+ <li><p>mvn tomcat:deploy</p></li>
+ </ul>
+ </ul>
+ <p><strong>From a DAS Sample
distribution (starting with M2)</strong>:</p>
+ <ul>
+ <li><p>Download a das-sample distribution from
http://incubator.apache.org/tuscany/downloads.html</p></li>
+ <li><p>Extract the companyweb war file</p></li>
+ <li><p>Follow regular deployment procedures to deploy the war
file</p></li>
+ </ul>
+ </div>
+ </td>
+ <td background="images/WhiteR.png" width="14"></td>
+ </tr>
+
+ <tr>
+ <td background="images/WhiteBL.png" width="15"
height="14"></td>
+ <td background="images/WhiteB.png" ></td>
+ <td background="images/WhiteBR.png" width="14"></td>
+ </tr>
+
+ </table>
+ <table class="content"
border="0" width="90%" cellspacing="0" cellpadding="0" align="center">
+ <tr class="title" height="17" background="images/TitleC.png">
+ <td align="left">
+ <img src="images/TitleL.png" width="15"
height="17" alt=""></td>
+ <td align="center" height="17" id="title"
background="images/TitleC.png">
+ <a href="#">Running Tuscany DAS Unit
Tests</a>
+ </td>
+ <td align="right">
+ <img src="images/TitleR.png" width="14"
height="17" alt=""></td>
+ </tr>
+ <tr>
+ <td background="images/WhiteL.png" width="15"></td>
+ <td width="100%">
+ <div id="content">
+ <p>DAS is currently providing two
sets of unit tests</p>
+ <ul>
+ <li><p>JUnit tests for the core DAS code</p></li>
+ <li><p>HTMLUnit tests integrated with Tomcat for DAS CompanyWeb
sample application</p></li>
+ </ul>
+ <p>Below we are going to describe
how you can exercise these two sets of tests, and we recommend you running them
after contributing code/patches for DAS
+ to validate that your new changes are not introducing any
regressions.</p>
+ <p><strong>Running DAS tests as
part of the build</strong></p>
+ <ul>
+ <li><p>cd 'local tuscany dir'/java/das</p></li>
+ <li><p>mvn test</p></li>
+
+ <p>
+ -------------------------------------------------------<br />
+ T E S T S<br />
+ -------------------------------------------------------<br />
+ Running org.apache.tuscany.das.rdb.test.suites.AllTestsDerby<br
/>
+ Setting up for Derby run<br />
+ Ending Derby run<br />
+ Tests run: 137, Failures: 0, Errors: 0, Skipped: 0, Time
elapsed: 33.468 sec<br />
+ <br />
+ Results :<br />
+ <br />
+ Tests run: 137, Failures: 0, Errors: 0, Skipped: 0<br />
+ <br />
+ [INFO]
------------------------------------------------------------------------<br />
+ [INFO] BUILD SUCCESSFUL<br />
+ [INFO]
------------------------------------------------------------------------<br />
+ [INFO] Total time: 57 seconds<br />
+ [INFO] Finished at: Tue Oct 03 12:06:13 PDT 2006<br />
+ [INFO] Final Memory: 5M/10M<br />
+ [INFO]
------------------------------------------------------------------------<br />
+ <br />
+ </p>
+ </ul>
+ <p><strong>Running DAS CompanyWeb
tests in tomcat</strong></p>
+ <ul>
+ <li><p>Download tomcat distribution into your local filesystem :
http://tomcat.apache.org/</p></li>
+ <li><p>Create a build.properties in your root directory (e.g.
C:\Documents and Settings\lresende in Win2K systems) with the following
contents</p></li>
+ <ul>
+ <li><p>tuscany.acceptance.tomcat.zipped='directory where tomcat
was downloaded'\\apache-tomcat-5.5.17-tuscany.zip</p></li>
+ </ul>
+ <li><p>checkout DAS Sample from SVN repository:</p></li>
+ <ul>
+ <li><p>md 'local tuscany dir'</p></li>
+ <li><p>cd 'local tuscany dir'</p></li>
+ <li><p>svn co
https://svn.apache.org/repos/asf/incubator/tuscany/java/das das</p></li>
+ </ul>
+ <li><p>use maven run the DAS CompanyWeb tests in Tomcat:</p></li>
+ <ul>
+ <li><p>cd das/samples/testing/tomcat</p></li>
+ <li><p>mvn</p></li>
+ <p>
+ -------------------------------------------------------<br />
+ T E S T S<br />
+ -------------------------------------------------------<br />
+ Running org.apache.tuscany.test.das.DasTestCase<br />
+ Running:HomePage SUCCESS!!!<br />
+ Running:AllCompanies SUCCESS!!!<br />
+ Running:AllCompaniesDepartments SUCCESS!!!<br />
+ Running:AddDepartmentToFirstCompany SUCCESS!!!<br />
+ Running:ChangeCompanyDepartmentNames SUCCESS!!!<br />
+ Running:DeleteCompanyOneDepartments SUCCESS!!!<br />
+ Tests run: 6, Failures: 0, Errors: 0, Skipped: 0, Time elapsed:
14.911 sec<br />
+ <br />
+ Results :<br />
+ <br />
+ Tests run: 6, Failures: 0, Errors: 0, Skipped: 0<br />
+ <br />
+ [INFO]<br />
+ [INFO]<br />
+ [INFO]
------------------------------------------------------------------------<br />
+ [INFO] Reactor Summary:<br />
+ [INFO]
------------------------------------------------------------------------<br />
+ [INFO] Tuscany Testing in Tomcat .............................
SUCCESS [0.251s]<br />
+ [INFO] Tuscany Testing DAS Sample - Companyweb ...............
SUCCESS [1:17.791s]<br />
+ [INFO]
------------------------------------------------------------------------<br />
+ [INFO]
------------------------------------------------------------------------<br />
+ [INFO] BUILD SUCCESSFUL<br />
+ [INFO]
------------------------------------------------------------------------<br />
+ [INFO] Total time: 1 minute 18 seconds<br />
+ [INFO] Finished at: Tue Oct 03 12:25:48 PDT 2006<br />
+ [INFO] Final Memory: 7M/15M<br />
+ [INFO]
------------------------------------------------------------------------<br />
+ </p>
+ <li><p><strong>Note: Due to a current limitation, you must run mvn
clean before you can run the tests a second time</strong></p></li>
+ </ul>
+ </ul>
</div>
</td>
<td background="images/WhiteR.png" width="14"></td>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
