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/09/11 22:48:00 UTC

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

Author: rineholt
Date: Mon Sep 11 13:47:59 2006
New Revision: 442346

URL: http://svn.apache.org/viewvc?view=rev&rev=442346
Log:
TUSCANY-702
http://issues.apache.org/jira/browse/TUSCANY-702

Modified:
    incubator/tuscany/site/site-author/das_index.xml
    incubator/tuscany/site/site-author/java_das_overview.xml
    incubator/tuscany/site/site-publish/das_index.html
    incubator/tuscany/site/site-publish/java_das_overview.html

Modified: incubator/tuscany/site/site-author/das_index.xml
URL: http://svn.apache.org/viewvc/incubator/tuscany/site/site-author/das_index.xml?view=diff&rev=442346&r1=442345&r2=442346
==============================================================================
--- incubator/tuscany/site/site-author/das_index.xml (original)
+++ incubator/tuscany/site/site-author/das_index.xml Mon Sep 11 13:47:59 2006
@@ -8,10 +8,21 @@
     <body>
 
         <section name="Data Access Service - Overview">
-			<p>RDB DAS provides a generic data access service that provides
+			<p>RDB DAS provides robust a generic data access service that provides
 			transformation capability between SDO data graphs and relational databases and
 			vise versa. </p>
 			
+			<p>By using RDB DAS, applications developers avoid the details and complications 
+			of working directly with a relational database and also the complex transformation 
+			between relational rows/columns and Data Object types/properties.
+			</p>
+			
+			<p>RDB DAS works with SDO to improve your data access performance.The RDB DAS 
+			processes the SDO change summary and produces efficient update statements 
+			that only write to columns that have actually been modified.			
+			</p>
+			
+			
 			<p>The following diagram illustrates these two capabilities in
 			a typical client interaction.The client
 			starts by reading a graph of data specified by some query.The client then makes modifications to the
@@ -20,45 +31,50 @@
 			
 			<img src ="images/sdo_das_sm.jpg" alt="DAS Capabilities" align="middle" border="0" height="407" width="600"/>
 			
-			<p>The following diagram illustrates the high level object diagram for DAS</p>
-			
-			<img src ="images/das_class_diagram.jpg" alt="DAS High level class diagram" align="middle" border="0" height="561" width="710"/>
-			
 			<p>To further explore the benefits of DAS please refer to white
 			paper &quot;DAS White Paper: The Data Access Service&quot; on the <a
 			href="documentation.html">Documentation
 			page</a>.</p>
         </section>
 
-	    <section name="General DAS Documentation">
-	    	<p>
-				Below, there is a list of various links to documents that help to explain various aspects of the
-				Tuscany DAS subproject and the programming model that it provides.  More general documentation 
-				which applies to the Tuscany project as a whole can be found on the 
-				<a href="documentation.hmtl">
-				Tuscany Documentation page</a>.
-		   </p>
-           <p>
-			<table class="bodyTable">
-	            <tr class="b">
-	                    <td>
-	                       <span style="font-weight: bold;">Title</span>
-	                    </td>
-	                    <td>
-	                       <span style="font-weight: bold;">Description</span>
-	                    </td>
-	            </tr>
-	            <tr class="b">
-	                    <td>
-	                        <a href='RDB_DAS_white_paper_v-0.1.3.pdf' target='_blank'>DAS White Paper: The Data Access Service</a>
-	                    </td>
-	                    <td>
-	                        How to access relational data in terms of Service Data Objects (not yet on the website - to be provided)
-	                    </td>
-	            </tr>
-            </table>	    
-	        </p>
-	    </section>
+       <section name="General DAS Documentation">
+	               <p>Below, there is a list of various links to documents that help to explain various aspects of the
+		       Tuscany DAS subproject and the programming model that it provides.  More general documentation 
+		       which applies to the Tuscany project as a whole can be found on the
+		       <a href="documentation.html">Tuscany Documentation page</a>.
+		      </p>
+		      
+                      <p>
+		      <table class="bodyTable">
+			 <tr class="b">
+			    <td>
+			       <span style="font-weight: bold;">Title</span>
+			    </td>
+			    <td>
+			       <span style="font-weight: bold;">Description</span>
+			    </td>
+			 </tr>
+
+			 <tr class="b">
+			    <td>
+			       <a href='RDB_DAS_white_paper_v-0.1.3.pdf' target='_blank'>DAS White Paper: The Data Access Service</a>
+			    </td>
+			    <td>
+			       How to access relational data in terms of Service Data Objects
+			    </td>
+			 </tr>
+
+			 <tr class="b">
+			    <td>
+			       <a class="external" rel="nofollow" href='http://java.sys-con.com/read/260053.htm'>JDJ DAS Article</a>
+			    </td>
+			    <td>
+			       How to access relational data in terms of Service Data Objects
+			    </td>
+			 </tr>	            
+		      </table>	    
+                      </p>
+    </section>
 
     </body>
 </document>

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=442346&r1=442345&r2=442346
==============================================================================
--- incubator/tuscany/site/site-author/java_das_overview.xml (original)
+++ incubator/tuscany/site/site-author/java_das_overview.xml Mon Sep 11 13:47:59 2006
@@ -5,20 +5,187 @@
        <bannertitle>Welcome to Tuscany</bannertitle>
     </properties>
     <body>
-        <section name="Tuscany DAS - Java">
- <p>(TBD) Desciption of the Tuscany DAS implementation </p>
-  <br/>
-			<div align="center">
-              <img src ="./images/DAS-Java.png" alt="DAS Overview" usemap="#tuscany_overview" border="0" />
-			 </div>
-			  
-              <map name="tuscany_overview">
-                <area shape="rect" coords="1,74,108,290" href="das_index.html" target=""/>
-                <area shape="rect" coords="111,74,206,287" href="sdo_index.html" target=""/>
-                <area shape="rect" coords="208,33,620,335" href="sca_index.html" target=""/>
-                <area shape="rect" coords="620,32,859,333" href="tools_index.html" target=""/>
-              </map>
- 
-    </section>
+    
+   <section name="Tuscany DAS - Java">
+      <div align="center">
+         <img src ="./images/DAS-Java.png" alt="DAS Overview" usemap="#tuscany_overview" border="0" />
+      </div>
+
+      <p>This document proves a high-level overview of the Java DAS (Data Access Services) subproject of the Apache Tuscany incubator project.</p>
+   </section>
+
+
+   <section name="DAS Java Getting Started">
+      <p>To get started with Java DAS, follow the <a href="downloads.html">downloads</a> link and pick up either a binary or source distribution.
+      If you are working from a source distribution, you can follow the <a href="java-projects.html">general instructions</a> for building the whole of the Tuscany java projects,
+      or you can follow the intructions within the <A href="java_das_overview.html"> DAS Java overview </A> to build and explore just DAS java.
+      </p>
+
+      <h3>General DAS Documentation</h3>
+      <table class="bodyTable">
+         <tr class="b">
+            <td>
+               <span style="font-weight: bold;">Title</span>
+            </td>
+            <td>
+               <span style="font-weight: bold;">Description</span>
+            </td>
+         </tr>
+         
+         <tr class="b">
+            <td>
+               <a href='RDB_DAS_white_paper_v-0.1.3.pdf' target='_blank'>DAS White Paper: The Data Access Service</a>
+            </td>
+            <td>
+               How to access relational data in terms of Service Data Objects
+            </td>
+         </tr>
+         
+         <tr class="b">
+            <td>
+               <a class="external" rel="nofollow" href='http://java.sys-con.com/read/260053.htm'>JDJ DAS Article</a>
+            </td>
+            <td>
+               How to access relational data in terms of Service Data Objects
+            </td>
+         </tr>	            
+      </table>	    
+   </section>
+
+
+   <section name="DAS Java Overview">
+
+      <p>Currently, the project's code base includes an implementation of a DAS RDB (relational database) with following key features :</p>
+      
+      <h3>DAS M1 release - Key features</h3>
+
+      <ul>
+         <li><p>RDB CRUD operations in terms of SDO DataObjects</p></li>
+         <li><p>Optimistic concurrency control</p></li>
+         <li><p>Generated database IDs</p></li>
+         <li><p>Stored procedures</p></li>
+         <li><p>Paging API</p></li>
+         <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>.
+      </p>	
+
+
+      <h3>DAS Project Structure</h3>
+
+      <p>The DAS RDB project is divided into three parts:</p>
+      <ol type="1">
+	<li><p><strong>das.rdb</strong> contains the DAS interfaces and  the RDB (Relational Database) runtime implementation.</p></li>
+	<li><p><strong>samples.das</strong> provides sample applications based on DAS.</p></li>
+	<li><p><strong>distribution.das</strong> provides DAS binaries distribution with required dependencies.</p></li>
+	<li><p><strong>distribution.das-samples</strong> provides DAS samples distribution as a ready-to-deploy war file.</p></li>
+      </ol>
+
+      
+      <h3>DAS high level class diagram</h3>
+
+      <img src ="images/das_class_diagram.jpg" alt="DAS High level class diagram" align="middle" border="0" height="561" width="710"/>
+
+   </section>
+   
+   <section name="Build Environment Setup">
+
+      <h3>Tuscany Build Environment Setup</h3>
+
+      <p>DAS is a subproject of the Tuscany project. If you check out and
+      build the whole Tuscany Java project, you will have also built the DAS
+      subproject. If you want to work with the DAS project, without the rest
+      of Tuscany, skip to the next section.</p>
+      
+      <p>To build the whole Tuscany project follow <a class="external" rel="nofollow" href="java-projects.html">these instructions</a>.</p>
+
+
+
+      <h3>DAS Java Build Environment Setup</h3>
+
+      <p>If you want to work with the DAS project alone, without the rest of Tuscany, proceed with the following steps.</p>
+      <ol type="1">
+         <li><p>Set up your environment using the <a class="external" rel="nofollow" href="java-projects.html"> instructions for building the whole of Tuscany</a>,
+	     <strong>but</strong> only download and install Java 5, Maven and Svn</p></li>
+
+	<li><p>Make sure 'mvn' and 'svn' commands are in your PATH environment variable.</p></li>
+
+	<li><p>Check out the DAS open source projects from Apache.</p></li>
+
+	<ul>
+		<li style="list-style-type: none;">
+		<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/>
+		cd java <br/>
+		svn up das <br/>
+		</p>
+		</li>
+	</ul>
+	</ol>
+
+	<ol start="4" type="1">
+		<li><p>Run "mvn" under &lt;local tuscany dir&gt;/java directory to install
+		POM files from the root project to the local repository</p></li>
+	</ol>
+	<ul>
+		<li style="list-style-type: none;">
+		<p>Commands:</p>
+		<ul>
+			<li style="list-style-type: none;">
+			<p>cd &lt;local tuscany dir&gt;/java <br/>
+			mvn -N <br/>
+			cd das <br/>
+			mvn -N (alternatively, run without the -N option - see Note below) <br/>
+			</p>
+			</li>
+		</ul>
+		</li>
+	</ul>
+	
+	<ul>
+		<li style="list-style-type: none;">
+		<p><strong>Notes:</strong></p>
+		<ol type="1">
+			<li><p>If the mvn command completed successfully, you will see BUILD
+			SUCCESSFUL in the output and tuscany-das-rdb-1.0-SNAPSHOP.jar is created under
+			&lt;local tuscany dir&gt;/java/das/rdb/target directory.</p></li>
+			
+			<li><p>External resources are at times unavailable. It may be necessary to
+			run "mvn" again at a later time.</p></li>
+
+			<li><p>If you are taking time to reply to firewall prompts, this can cause
+			some requests to time out. Set up the firewall to permit the action without prompting.</p></li>
+		</ol>
+		</li>
+	</ul>
+	
+	
+	<H3 >Dependency Jars</H3>
+	
+	<p> The DAS.RDB project has a dependency on SDO and requires the following SDO runtime jars to build</p>
+	
+	<ul>
+	   <li><p>sdo-api-r2.0.1-1.0-SNAPSHOT.jar - SDO 2.0 Interfaces</p></li>
+	   <li><p>tuscany-sdo-impl-1.0-SNAPSHOT.jar - SDO 2.0 implementation</p></li>
+	</ul>
+	
+	
+	<p>The SDO.IMPL project have dependencies on the following EMF (Eclipse Modeling
+	Framework - www.eclipse.org/emf) runtime jars to build:</p>
+	<ul>
+		<li><p>emf-common-2.2.0-SNAPSHOT.jar - some common framework utility and base classes</p></li>
+		<li><p>emf-ecore-2.2.0-SNAPSHOT.jar - the EMF core runtime implementation classes (the Ecore metamodel)</p></li>
+		<li><p>emf-ecore-change-2.2.0-SNAPSHOT.jar - the EMF change recorder and framework</p></li>
+		<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>
+	
+   </section>
+
+
   </body>
 </document>

Modified: incubator/tuscany/site/site-publish/das_index.html
URL: http://svn.apache.org/viewvc/incubator/tuscany/site/site-publish/das_index.html?view=diff&rev=442346&r1=442345&r2=442346
==============================================================================
--- incubator/tuscany/site/site-publish/das_index.html (original)
+++ incubator/tuscany/site/site-publish/das_index.html Mon Sep 11 13:47:59 2006
@@ -268,17 +268,23 @@
 			<td background="images/WhiteL.png" width="15"></td>
 			<td width="100%">
 				<div id="content">
-                                            <p>RDB DAS provides a generic data access service that provides
+                                            <p>RDB DAS provides robust a generic data access service that provides
 			transformation capability between SDO data graphs and relational databases and
 			vise versa. </p>
+                                            <p>By using RDB DAS, applications developers avoid the details and complications 
+			of working directly with a relational database and also the complex transformation 
+			between relational rows/columns and Data Object types/properties.
+			</p>
+                                            <p>RDB DAS works with SDO to improve your data access performance.The RDB DAS 
+			processes the SDO change summary and produces efficient update statements 
+			that only write to columns that have actually been modified.			
+			</p>
                                             <p>The following diagram illustrates these two capabilities in
 			a typical client interaction.The client
 			starts by reading a graph of data specified by some query.The client then makes modifications to the
 			graph, possibly by adding elements, and then requests the DAS to push the
 			changes back to the database.</p>
                                             <img src="images/sdo_das_sm.jpg" alt="DAS Capabilities" align="middle" border="0" height="407" width="600" />
-                                            <p>The following diagram illustrates the high level object diagram for DAS</p>
-                                            <img src="images/das_class_diagram.jpg" alt="DAS High level class diagram" align="middle" border="0" height="561" width="710" />
                                             <p>To further explore the benefits of DAS please refer to white
 			paper "DAS White Paper: The Data Access Service" on the <a href="documentation.html">Documentation
 			page</a>.</p>
@@ -308,33 +314,41 @@
 			<td background="images/WhiteL.png" width="15"></td>
 			<td width="100%">
 				<div id="content">
+                                            <p>Below, there is a list of various links to documents that help to explain various aspects of the
+		       Tuscany DAS subproject and the programming model that it provides.  More general documentation 
+		       which applies to the Tuscany project as a whole can be found on the
+		       <a href="documentation.html">Tuscany Documentation page</a>.
+		      </p>
                                             <p>
-				Below, there is a list of various links to documents that help to explain various aspects of the
-				Tuscany DAS subproject and the programming model that it provides.  More general documentation 
-				which applies to the Tuscany project as a whole can be found on the 
-				<a href="documentation.hmtl">
-				Tuscany Documentation page</a>.
-		   </p>
-                                            <p>
-			<table class="bodyTable">
-	            <tr class="b">
-	                    <td>
-	                       <span style="font-weight: bold;">Title</span>
-	                    </td>
-	                    <td>
-	                       <span style="font-weight: bold;">Description</span>
-	                    </td>
-	            </tr>
-	            <tr class="b">
-	                    <td>
-	                        <a href="RDB_DAS_white_paper_v-0.1.3.pdf" target="_blank">DAS White Paper: The Data Access Service</a>
-	                    </td>
-	                    <td>
-	                        How to access relational data in terms of Service Data Objects (not yet on the website - to be provided)
-	                    </td>
-	            </tr>
-            </table>	    
-	        </p>
+		      <table class="bodyTable">
+			 <tr class="b">
+			    <td>
+			       <span style="font-weight: bold;">Title</span>
+			    </td>
+			    <td>
+			       <span style="font-weight: bold;">Description</span>
+			    </td>
+			 </tr>
+
+			 <tr class="b">
+			    <td>
+			       <a href="RDB_DAS_white_paper_v-0.1.3.pdf" target="_blank">DAS White Paper: The Data Access Service</a>
+			    </td>
+			    <td>
+			       How to access relational data in terms of Service Data Objects
+			    </td>
+			 </tr>
+
+			 <tr class="b">
+			    <td>
+			       <a class="external" rel="nofollow" href="http://java.sys-con.com/read/260053.htm">JDJ DAS Article</a>
+			    </td>
+			    <td>
+			       How to access relational data in terms of Service Data Objects
+			    </td>
+			 </tr>	            
+		      </table>	    
+                      </p>
                     				</div>
 			</td>
 			<td background="images/WhiteR.png" width="14"></td>

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=442346&r1=442345&r2=442346
==============================================================================
--- incubator/tuscany/site/site-publish/java_das_overview.html (original)
+++ incubator/tuscany/site/site-publish/java_das_overview.html Mon Sep 11 13:47:59 2006
@@ -266,17 +266,221 @@
 			<td background="images/WhiteL.png" width="15"></td>
 			<td width="100%">
 				<div id="content">
-                                            <p>(TBD) Desciption of the Tuscany DAS implementation </p>
-                                            <br />
                                             <div align="center">
-              <img src="./images/DAS-Java.png" alt="DAS Overview" usemap="#tuscany_overview" border="0" />
-			 </div>
-                                            <map name="tuscany_overview">
-                <area shape="rect" coords="1,74,108,290" href="das_index.html" target="" />
-                <area shape="rect" coords="111,74,206,287" href="sdo_index.html" target="" />
-                <area shape="rect" coords="208,33,620,335" href="sca_index.html" target="" />
-                <area shape="rect" coords="620,32,859,333" href="tools_index.html" target="" />
-              </map>
+         <img src="./images/DAS-Java.png" alt="DAS Overview" usemap="#tuscany_overview" border="0" />
+      </div>
+                                            <p>This document proves a high-level overview of the Java DAS (Data Access Services) subproject of the Apache Tuscany incubator project.</p>
+                    				</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">
+				     <a href="#">DAS Java Getting Started</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>To get started with Java DAS, follow the <a href="downloads.html">downloads</a> link and pick up either a binary or source distribution.
+      If you are working from a source distribution, you can follow the <a href="java-projects.html">general instructions</a> for building the whole of the Tuscany java projects,
+      or you can follow the intructions within the <A href="java_das_overview.html"> DAS Java overview </A> to build and explore just DAS java.
+      </p>
+                                            <h3>General DAS Documentation</h3>
+                                            <table class="bodyTable">
+         <tr class="b">
+            <td>
+               <span style="font-weight: bold;">Title</span>
+            </td>
+            <td>
+               <span style="font-weight: bold;">Description</span>
+            </td>
+         </tr>
+         
+         <tr class="b">
+            <td>
+               <a href="RDB_DAS_white_paper_v-0.1.3.pdf" target="_blank">DAS White Paper: The Data Access Service</a>
+            </td>
+            <td>
+               How to access relational data in terms of Service Data Objects
+            </td>
+         </tr>
+         
+         <tr class="b">
+            <td>
+               <a class="external" rel="nofollow" href="http://java.sys-con.com/read/260053.htm">JDJ DAS Article</a>
+            </td>
+            <td>
+               How to access relational data in terms of Service Data Objects
+            </td>
+         </tr>	            
+      </table>
+                    				</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">
+				     <a href="#">DAS Java Overview</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>Currently, the project's code base includes an implementation of a DAS RDB (relational database) with following key features :</p>
+                                            <h3>DAS M1 release - Key features</h3>
+                                            <ul>
+         <li><p>RDB CRUD operations in terms of SDO DataObjects</p></li>
+         <li><p>Optimistic concurrency control</p></li>
+         <li><p>Generated database IDs</p></li>
+         <li><p>Stored procedures</p></li>
+         <li><p>Paging API</p></li>
+         <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>.
+      </p>
+                                            <h3>DAS Project Structure</h3>
+                                            <p>The DAS RDB project is divided into three parts:</p>
+                                            <ol type="1">
+	<li><p><strong>das.rdb</strong> contains the DAS interfaces and  the RDB (Relational Database) runtime implementation.</p></li>
+	<li><p><strong>samples.das</strong> provides sample applications based on DAS.</p></li>
+	<li><p><strong>distribution.das</strong> provides DAS binaries distribution with required dependencies.</p></li>
+	<li><p><strong>distribution.das-samples</strong> provides DAS samples distribution as a ready-to-deploy war file.</p></li>
+      </ol>
+                                            <h3>DAS high level class diagram</h3>
+                                            <img src="images/das_class_diagram.jpg" alt="DAS High level class diagram" align="middle" border="0" height="561" width="710" />
+                    				</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">
+				     <a href="#">Build Environment Setup</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">
+                                            <h3>Tuscany Build Environment Setup</h3>
+                                            <p>DAS is a subproject of the Tuscany project. If you check out and
+      build the whole Tuscany Java project, you will have also built the DAS
+      subproject. If you want to work with the DAS project, without the rest
+      of Tuscany, skip to the next section.</p>
+                                            <p>To build the whole Tuscany project follow <a class="external" rel="nofollow" href="java-projects.html">these instructions</a>.</p>
+                                            <h3>DAS Java Build Environment Setup</h3>
+                                            <p>If you want to work with the DAS project alone, without the rest of Tuscany, proceed with the following steps.</p>
+                                            <ol type="1">
+         <li><p>Set up your environment using the <a class="external" rel="nofollow" href="java-projects.html"> instructions for building the whole of Tuscany</a>,
+	     <strong>but</strong> only download and install Java 5, Maven and Svn</p></li>
+
+	<li><p>Make sure 'mvn' and 'svn' commands are in your PATH environment variable.</p></li>
+
+	<li><p>Check out the DAS open source projects from Apache.</p></li>
+
+	<ul>
+		<li style="list-style-type: none;">
+		<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 />
+		cd java <br />
+		svn up das <br />
+		</p>
+		</li>
+	</ul>
+	</ol>
+                                            <ol start="4" type="1">
+		<li><p>Run "mvn" under &lt;local tuscany dir&gt;/java directory to install
+		POM files from the root project to the local repository</p></li>
+	</ol>
+                                            <ul>
+		<li style="list-style-type: none;">
+		<p>Commands:</p>
+		<ul>
+			<li style="list-style-type: none;">
+			<p>cd &lt;local tuscany dir&gt;/java <br />
+			mvn -N <br />
+			cd das <br />
+			mvn -N (alternatively, run without the -N option - see Note below) <br />
+			</p>
+			</li>
+		</ul>
+		</li>
+	</ul>
+                                            <ul>
+		<li style="list-style-type: none;">
+		<p><strong>Notes:</strong></p>
+		<ol type="1">
+			<li><p>If the mvn command completed successfully, you will see BUILD
+			SUCCESSFUL in the output and tuscany-das-rdb-1.0-SNAPSHOP.jar is created under
+			&lt;local tuscany dir&gt;/java/das/rdb/target directory.</p></li>
+			
+			<li><p>External resources are at times unavailable. It may be necessary to
+			run "mvn" again at a later time.</p></li>
+
+			<li><p>If you are taking time to reply to firewall prompts, this can cause
+			some requests to time out. Set up the firewall to permit the action without prompting.</p></li>
+		</ol>
+		</li>
+	</ul>
+                                            <H3>Dependency Jars</H3>
+                                            <p> The DAS.RDB project has a dependency on SDO and requires the following SDO runtime jars to build</p>
+                                            <ul>
+	   <li><p>sdo-api-r2.0.1-1.0-SNAPSHOT.jar - SDO 2.0 Interfaces</p></li>
+	   <li><p>tuscany-sdo-impl-1.0-SNAPSHOT.jar - SDO 2.0 implementation</p></li>
+	</ul>
+                                            <p>The SDO.IMPL project have dependencies on the following EMF (Eclipse Modeling
+	Framework - www.eclipse.org/emf) runtime jars to build:</p>
+                                            <ul>
+		<li><p>emf-common-2.2.0-SNAPSHOT.jar - some common framework utility and base classes</p></li>
+		<li><p>emf-ecore-2.2.0-SNAPSHOT.jar - the EMF core runtime implementation classes (the Ecore metamodel)</p></li>
+		<li><p>emf-ecore-change-2.2.0-SNAPSHOT.jar - the EMF change recorder and framework</p></li>
+		<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>



---------------------------------------------------------------------
To unsubscribe, e-mail: tuscany-commits-unsubscribe@ws.apache.org
For additional commands, e-mail: tuscany-commits-help@ws.apache.org