You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tuscany.apache.org by ri...@apache.org on 2006/10/04 15:35:17 UTC

svn commit: r452882 - in /incubator/tuscany/site: site-author/java_das_overview.xml site-publish/java_das_overview.html

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 &lt;local tuscany dir&gt; <br/>
 		cd &lt;local tuscany dir&gt; <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 &lt;local tuscany dir&gt; <br />
 		cd &lt;local tuscany dir&gt; <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: tuscany-commits-unsubscribe@ws.apache.org
For additional commands, e-mail: tuscany-commits-help@ws.apache.org