You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@tuscany.apache.org by kw...@apache.org on 2006/05/17 00:39:33 UTC

svn commit: r407095 - /incubator/tuscany/java/samples/das/companyweb/readme.htm

Author: kwilliams
Date: Tue May 16 15:39:28 2006
New Revision: 407095

URL: http://svn.apache.org/viewcvs?rev=407095&view=rev
Log:
Corrections to readme.htm

Modified:
    incubator/tuscany/java/samples/das/companyweb/readme.htm

Modified: incubator/tuscany/java/samples/das/companyweb/readme.htm
URL: http://svn.apache.org/viewcvs/incubator/tuscany/java/samples/das/companyweb/readme.htm?rev=407095&r1=407094&r2=407095&view=diff
==============================================================================
--- incubator/tuscany/java/samples/das/companyweb/readme.htm (original)
+++ incubator/tuscany/java/samples/das/companyweb/readme.htm Tue May 16 15:39:28 2006
@@ -1,19 +1,5 @@
-<html xmlns:o="urn:schemas-microsoft-com:office:office"
-<!--
-  Copyright (c) 2005 The Apache Software Foundation or its licensors, as applicable.
-
-  Licensed under the Apache License, Version 2.0 (the "License");
-  you may not use this file except in compliance with the License.
-  You may obtain a copy of the License at
-
-     http://www.apache.org/licenses/LICENSE-2.0
-
-  Unless required by applicable law or agreed to in writing, software
-  distributed under the License is distributed on an "AS IS" BASIS,
-  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-  See the License for the specific language governing permissions and
-  limitations under the License.
- -->
+<html xmlns:v="urn:schemas-microsoft-com:vml"
+xmlns:o="urn:schemas-microsoft-com:office:office"
 xmlns:w="urn:schemas-microsoft-com:office:word"
 xmlns:st1="urn:schemas-microsoft-com:office:smarttags"
 xmlns="http://www.w3.org/TR/REC-html40">
@@ -26,26 +12,26 @@
 <link rel=File-List href="readme_files/filelist.xml">
 <title>Tuscany RDB DAS Sample</title>
 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
- name="place"/>
+ name="City"/>
 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
  name="State"/>
 <o:SmartTagType namespaceuri="urn:schemas-microsoft-com:office:smarttags"
- name="City"/>
+ name="place"/>
 <!--[if gte mso 9]><xml>
  <o:DocumentProperties>
   <o:Author>IBM_USER</o:Author>
   <o:LastAuthor>IBM_USER</o:LastAuthor>
   <o:Revision>4</o:Revision>
-  <o:TotalTime>441</o:TotalTime>
-  <o:Created>2006-03-24T16:33:00Z</o:Created>
-  <o:LastSaved>2006-03-24T16:33:00Z</o:LastSaved>
+  <o:TotalTime>454</o:TotalTime>
+  <o:Created>2006-05-16T22:37:00Z</o:Created>
+  <o:LastSaved>2006-05-16T22:37:00Z</o:LastSaved>
   <o:Pages>1</o:Pages>
-  <o:Words>1012</o:Words>
-  <o:Characters>5770</o:Characters>
+  <o:Words>1028</o:Words>
+  <o:Characters>5862</o:Characters>
   <o:Company>IBM</o:Company>
   <o:Lines>48</o:Lines>
   <o:Paragraphs>13</o:Paragraphs>
-  <o:CharactersWithSpaces>6769</o:CharactersWithSpaces>
+  <o:CharactersWithSpaces>6877</o:CharactersWithSpaces>
   <o:Version>10.6735</o:Version>
  </o:DocumentProperties>
 </xml><![endif]--><!--[if gte mso 9]><xml>
@@ -224,6 +210,11 @@
 	mso-level-tab-stop:1.0in;
 	mso-level-number-position:left;
 	text-indent:-.25in;}
+@list l5:level3
+	{mso-level-number-format:roman-lower;
+	mso-level-tab-stop:1.5in;
+	mso-level-number-position:right;
+	text-indent:-9.0pt;}
 @list l6
 	{mso-list-id:1727725721;
 	mso-list-type:hybrid;
@@ -295,7 +286,12 @@
 	font-size:10.0pt;
 	font-family:"Times New Roman";}
 </style>
-<![endif]-->
+<![endif]--><!--[if gte mso 9]><xml>
+ <o:shapedefaults v:ext="edit" spidmax="2050"/>
+</xml><![endif]--><!--[if gte mso 9]><xml>
+ <o:shapelayout v:ext="edit">
+  <o:idmap v:ext="edit" data="1"/>
+ </o:shapelayout></xml><![endif]-->
 </head>
 
 <body lang=EN-US link=blue vlink=purple style='tab-interval:.5in'>
@@ -364,9 +360,11 @@
 9.0pt'>Kevin Williams<o:p></o:p></span></p>
 
 <p class=MsoNormal align=right style='text-align:right'><span style='font-size:
-9.0pt'>V-0.1<o:p></o:p></span></p>
+9.0pt'>V-0.2<o:p></o:p></span></p>
+
+<h1>Tuscany RDB DAS Sample (companyweb)</h1>
 
-<h1><st1:State><st1:place>Tuscany</st1:place></st1:State> RDB DAS Sample</h1>
+<p class=MsoNormal><o:p>&nbsp;</o:p></p>
 
 <p class=MsoNormal><o:p>&nbsp;</o:p></p>
 
@@ -403,6 +401,17 @@
 database.<span style='mso-spacerun:yes'>  </span>Access to the database is via
 a DataSource.</p>
 
+<p class=MsoNormal><o:p>&nbsp;</o:p></p>
+
+<p class=MsoNormal>This sample application is deployed (along with the canned
+test database) to an instance of Tomcat as part of our automated sample testing.<span
+style='mso-spacerun:yes'>  </span>This means you can run the
+java/testing/tomcat build (see java/testing/tomcat/<span class=GramE>readme.htm
+)</span><span style='mso-spacerun:yes'>  </span>and then just test the
+application by pointing your browser.<span style='mso-spacerun:yes'> 
+</span>Alternatively, you can deploy the sample to your own Tomcat installation
+by following the instructions below.</p>
+
 <h1>Set Up</h1>
 
 <ol style='margin-top:0in' start=1 type=1>
@@ -421,11 +430,11 @@
      the following files (details in appendix) to {<span class=SpellE>Tomcat_Home</span>}/common/lib:</li>
  <ol style='margin-top:0in' start=1 type=a>
   <li class=MsoNormal style='mso-list:l5 level2 lfo2;tab-stops:list 1.0in'><span
-      class=SpellE>tuscany-das-rdb-SNAPSHOT.jar</span></li>
+      class=SpellE>tuscany-das-rdb-xxx.jar</span></li>
   <li class=MsoNormal style='mso-list:l5 level2 lfo2;tab-stops:list 1.0in'><span
-      class=SpellE>sdo-api-SNAPSHOT.jar</span></li>
+      class=SpellE>sdo-api-xxx.jar</span></li>
   <li class=MsoNormal style='mso-list:l5 level2 lfo2;tab-stops:list 1.0in'><span
-      class=SpellE>tuscany-sdo-impl-SNAPSHOT.jar</span></li>
+      class=SpellE>tuscany-sdo-impl-xxx.jar</span></li>
   <li class=MsoNormal style='mso-list:l5 level2 lfo2;tab-stops:list 1.0in'><span
       class=SpellE>xsd</span>{latest version}.jar</li>
   <li class=MsoNormal style='mso-list:l5 level2 lfo2;tab-stops:list 1.0in'><span
@@ -440,20 +449,12 @@
       class=SpellE>derby.jar</span></li>
  </ol>
  <li class=MsoNormal style='mso-list:l5 level1 lfo2;tab-stops:list .5in'>Add
-     the following files (details in appendix) to {<span class=SpellE>Tomcat_Home</span>}/work</li>
+     the following files (details in appendix) to {<span class=SpellE>Tomcat_Home</span>}/<span
+     class=SpellE>webapps</span></li>
  <ol style='margin-top:0in' start=1 type=a>
-  <li class=MsoNormal style='mso-list:l5 level2 lfo2;tab-stops:list 1.0in'><span
-      class=SpellE>companyWeb-SNAPSHOT.war</span></li>
-  <li class=MsoNormal style='mso-list:l5 level2 lfo2;tab-stops:list 1.0in'><span
-      class=SpellE>CompanyAppGbl.xml</span></li>
+  <li class=MsoNormal style='mso-list:l5 level2 lfo2;tab-stops:list 1.0in'>sample-<span
+      class=SpellE>companyweb-xxx.war</span></li>
  </ol>
-</ol>
-
-<p class=MsoNormal style='margin-left:.5in'><span style='font-size:11.0pt'>Note:
-If you are starting Tomcat from the command line rather than as a service then you
-can place these files in any local directory.<o:p></o:p></span></p>
-
-<ol style='margin-top:0in' start=6 type=1>
  <li class=MsoNormal style='mso-list:l5 level1 lfo2;tab-stops:list .5in'>Install
      the canned <st1:City><st1:place>Derby</st1:place></st1:City> database to
      Tomcat: </li>
@@ -500,50 +501,49 @@
 class=SpellE><span class=GramE>driverClassName</span></span>=&quot;<span
 class=SpellE>org.apache.derby.jdbc.EmbeddedDriver</span>&quot;<o:p></o:p></span></pre><pre><span
 style='font-size:9.0pt'><span style='mso-spacerun:yes'>              </span><span
-class=SpellE><span class=GramE>url</span></span>=&quot;<span class=SpellE>jdbc:derby:Databases/dastest</span>&quot;/&gt;<o:p></o:p></span></pre><pre><span
-style='mso-tab-count:3'>                       </span></pre>
+class=SpellE><span class=GramE>url</span></span>=&quot;<span class=SpellE>jdbc:derby:Databases/dastest</span>&quot;/&gt;<o:p></o:p></span></pre>
 
-<ol style='margin-top:0in' start=8 type=1>
- <li class=MsoNormal style='mso-list:l5 level1 lfo2;tab-stops:list .5in'><span
-     style='mso-spacerun:yes'>  </span>Start tomcat and </li>
- <ol style='margin-top:0in' start=1 type=a>
-  <li class=MsoNormal style='mso-list:l5 level2 lfo2;tab-stops:list 1.0in'>go
-      to the manager console <a href="http://localhost:8080/manager/html">http://localhost:8080/manager/html</a></li>
-  <li class=MsoNormal style='mso-list:l5 level2 lfo2;tab-stops:list 1.0in'>Scroll
-      down to the “deploy” section and enter the following:</li>
- </ol>
-</ol>
+<p class=MsoNormal style='margin-left:.5in'><span
+style='mso-spacerun:yes'> </span>NOTE: If you are NOT starting Tomcat as a
+service then you will need to provide the absolute path in the above <span
+class=SpellE><span class=GramE>url</span></span>.<span
+style='mso-spacerun:yes'>  </span>Fore example:</p>
 
 <p class=MsoNormal style='margin-left:.5in'><o:p>&nbsp;</o:p></p>
 
-<pre style='margin-left:1.0in'><span style='font-size:9.0pt'>Context Path (optional):<span style='mso-spacerun:yes'>   </span><span
-style='mso-tab-count:1'>   </span>/<span class=SpellE>CompanyApp</span><o:p></o:p></span></pre><pre
-style='margin-left:1.0in'><span style='font-size:9.0pt'>XML Configuration <span
-class=GramE>file</span> URL:<span style='mso-tab-count:1'>   </span>work/<span
-class=SpellE>CompanyAppGbl.xml</span><o:p></o:p></span></pre><pre
-style='margin-left:1.0in'><span style='font-size:9.0pt'>WAR or Directory URL:<span style='mso-spacerun:yes'>   </span><span
-style='mso-tab-count:1'>      </span><span class=SpellE>work/CompanyWeb-SNAPSHOT.war</span><o:p></o:p></span></pre><pre
-style='margin-left:1.0in'><span style='font-size:9.0pt'><o:p>&nbsp;</o:p></span></pre><pre
-style='margin-left:1.0in'><span style='font-size:9.0pt'>Note: If you are starting Tomcat from the command line rather than as a service then specify the full path of the xml and war files from step #5<o:p></o:p></span></pre><pre><o:p>&nbsp;</o:p></pre>
+<pre><span style='mso-spacerun:yes'>         </span><span class=SpellE>url</span>=&quot;jdbc:derby:c:\apache-tomcat-5.5.17\Databases/dastest&quot;/&gt;<span
+style='font-size:9.0pt'><o:p></o:p></span></pre>
+
+<p class=MsoNormal style='margin-left:.5in'><span
+style='mso-spacerun:yes'> </span></p>
 
 <ol style='margin-top:0in' start=8 type=1>
- <ol style='margin-top:0in' start=3 type=a>
-  <li class=MsoNormal style='mso-list:l5 level2 lfo2;tab-stops:list 1.0in'>Hit
-      the “deploy” button</li>
- </ol>
+ <li class=MsoNormal style='mso-list:l5 level1 lfo2;tab-stops:list .5in'>Start
+     tomcat and either:</li>
 </ol>
 
-<p class=MsoNormal style='margin-left:.5in'><o:p>&nbsp;</o:p></p>
+<p class=MsoNormal style='margin-left:1.0in'><span class=GramE>go</span> to the
+manager console <a href="http://localhost:8080/manager/html">http://localhost:8080/manager/html</a>
+and select the application named “<span style='font-size:10.0pt'>Tuscany DAS
+sample Company WEB”</span><o:p></o:p></p>
 
-<ol style='margin-top:0in' start=9 type=1>
- <li class=MsoNormal style='mso-list:l5 level1 lfo2;tab-stops:list .5in'>Get to
-     the sample application by clicking the named application in the “path”
-     column of the application section of the manager console.<span
-     style='mso-spacerun:yes'>  </span>Alternatively, you can point your
-     browser to http://localhost:8080/CompanyApp/<o:p></o:p></li>
-</ol>
+<p class=MsoNormal style='margin-left:.5in'><span class=GramE>or</span>:</p>
 
-<p class=MsoNormal><o:p>&nbsp;</o:p></p>
+<p class=MsoNormal style='margin-left:1.0in'><span class=GramE>point</span>
+your browser to :</p>
+
+<p class=MsoNormal style='margin-left:1.5in'><a
+href="http://localhost:8080/sample-companyweb-%7bversion%20name%7d/">http://localhost:8080/sample-companyweb-{version
+name}/</a></p>
+
+<p class=MsoNormal style='margin-left:1.0in'><o:p>&nbsp;</o:p></p>
+
+<p class=MsoNormal style='margin-left:1.0in'>NOTE: for the M1 version of <st1:State><st1:place>Tuscany</st1:place></st1:State>
+sample the <span class=SpellE><span class=GramE>url</span></span> is:</p>
+
+<p class=MsoNormal style='margin-left:1.5in'>http://localhost:8080/sample-companyweb-incubating-M1/<o:p></o:p></p>
+
+<p class=MsoNormal><sub><o:p>&nbsp;</o:p></sub></p>
 
 <h1>Sample Architecture</h1>
 
@@ -581,8 +581,7 @@
 <p class=MsoNormal>The <span class=SpellE><b style='mso-bidi-font-weight:normal'>Company.jsp</b></span>
 responds to client interaction by invoking services of the <span class=SpellE>CompanyClient</span>.<span
 style='mso-spacerun:yes'>  </span>It receives data from the <span class=SpellE>CompanyClient</span>
-as SDO data graphs and manipulates <span class=SpellE>SDOs</span> directly to
-display data.</p>
+as SDO data graphs and manipulates SDOs directly to display data.</p>
 
 <p class=MsoNormal><o:p>&nbsp;</o:p></p>
 
@@ -626,15 +625,15 @@
 
 <ul style='margin-top:0in' type=disc>
  <li class=MsoNormal style='mso-list:l7 level1 lfo4;tab-stops:list .5in'><span
-     class=SpellE><span style='font-size:10.0pt'>tuscany-das-rdb-SNAPSHOT.jar</span></span><span
+     class=SpellE><span style='font-size:10.0pt'>tuscany-das-rdb-xxx.jar</span></span><span
      style='font-size:10.0pt'> – {build directory root}/java/<span
      class=SpellE>das/rdb/target</span><o:p></o:p></span></li>
  <li class=MsoNormal style='mso-list:l7 level1 lfo4;tab-stops:list .5in'><span
-     class=SpellE><span style='font-size:10.0pt'>sdo-api-SNAPSHOT.jar</span></span><span
+     class=SpellE><span style='font-size:10.0pt'>sdo-api-xxx.jar</span></span><span
      style='font-size:10.0pt'> – {build directory root}/java/spec/<span
      class=SpellE>sdo</span>/target<o:p></o:p></span></li>
  <li class=MsoNormal style='mso-list:l7 level1 lfo4;tab-stops:list .5in'><span
-     class=SpellE><span style='font-size:10.0pt'>tuscany-sdo-impl-SNAPSHOT.jar</span></span><span
+     class=SpellE><span style='font-size:10.0pt'>tuscany-sdo-impl-xxx.jar</span></span><span
      style='font-size:10.0pt'> – {build directory root}//java/<span
      class=SpellE>sdo/impl/target</span><o:p></o:p></span></li>
  <li class=MsoNormal style='mso-list:l7 level1 lfo4;tab-stops:list .5in'><span
@@ -647,7 +646,8 @@
      {user}/.m2/repository/org/eclipse/emf/ecore<o:p></o:p></span></li>
  <li class=MsoNormal style='mso-list:l7 level1 lfo4;tab-stops:list .5in'><span
      class=SpellE><span style='font-size:10.0pt'>ecore</span></span><span
-     style='font-size:10.0pt'>-change-{latest version}.jar – {user}/.m2/repository/org/eclipse/emf/ecore-change<o:p></o:p></span></li>
+     style='font-size:10.0pt'>-change-{latest version}.jar –
+     {user}/.m2/repository/org/eclipse/emf/ecore-change<o:p></o:p></span></li>
  <li class=MsoNormal style='mso-list:l7 level1 lfo4;tab-stops:list .5in'><span
      class=SpellE><span style='font-size:10.0pt'>ecore-xmi</span></span><span
      style='font-size:10.0pt'>-{latest version}.jar <span
@@ -673,16 +673,8 @@
 
 <ul style='margin-top:0in' type=disc>
  <li class=MsoNormal style='mso-list:l9 level1 lfo10;tab-stops:list .5in'><span
-     class=SpellE><span style='font-size:10.0pt'>companyWeb-SNAPSHOT.war</span></span><span
-     style='font-size:10.0pt'> - {build directory root}/java/samples/<span
-     class=SpellE>das/companyweb/target</span><o:p></o:p></span></li>
-</ul>
-
-<ul style='margin-top:0in' type=disc>
- <li class=MsoNormal style='mso-list:l6 level1 lfo9;tab-stops:list .5in'><span
-     class=SpellE><span style='font-size:10.0pt'>CompanyAppGbl.xml</span></span><span
-     style='font-size:10.0pt'> - {build directory root}/java/samples/<span
-     class=SpellE>das/companyweb</span><o:p></o:p></span></li>
+     style='font-size:10.0pt'>sample-<span class=SpellE>companyweb-xxx.war</span>
+     - {build directory root}/java/samples/<span class=SpellE>das/companyweb/target</span><o:p></o:p></span></li>
 </ul>
 
 <p class=MsoNormal><o:p>&nbsp;</o:p></p>
@@ -691,10 +683,10 @@
 
 <ul style='margin-top:0in' type=disc>
  <li class=MsoNormal style='mso-list:l0 level1 lfo5;tab-stops:list .5in'><span
-     style='font-size:10.0pt'>{<span class=GramE>user</span>} refers the directory
-     where Maven2 is installed on your machine.<span style='mso-spacerun:yes'> 
-     </span>On my machine, “{user}” is “C:\Documents and
-     Settings\Administrator”<o:p></o:p></span></li>
+     style='font-size:10.0pt'>{<span class=GramE>user</span>} refers the
+     directory where Maven2 is installed on your machine.<span
+     style='mso-spacerun:yes'>  </span>On my machine, “{user}” is “C:\Documents
+     and Settings\Administrator”<o:p></o:p></span></li>
  <li class=MsoNormal style='mso-list:l0 level1 lfo5;tab-stops:list .5in'><span
      style='font-size:10.0pt'>{<span class=SpellE>Tomcat_Home</span>} refers to
      the directory that Tomcat is installed on your machine.<span
@@ -705,7 +697,7 @@
      the tag associated with the latest version available in the maven2
      repository.<span style='mso-spacerun:yes'>  </span>For example the version
      of <span class=SpellE>ecore</span>-{latest version}.jar that I used for
-     testing this sample is “ecore-2.2.0-I200602160000.jar”<o:p></o:p></span></li>
+     testing this sample is “ecore-2.2.0-RC4.jar”<o:p></o:p></span></li>
  <li class=MsoNormal style='mso-list:l0 level1 lfo5;tab-stops:list .5in'><span
      style='font-size:10.0pt'>{build directory root} refers to the target
      directory for the <span class=SpellE>tuscany</span>/java source you are