Author: rineholt
Date: Thu May 4 11:46:37 2006
New Revision: 399815
URL: http://svn.apache.org/viewcvs?rev=399815&view=rev
Log:
fix readmes to resolve links
http://issues.apache.org/jira/browse/TUSCANY-286
Added:
incubator/tuscany/java/sampleSetup.htm
- copied, changed from r399686, incubator/tuscany/java/samples/readme.htm
incubator/tuscany/java/sca/samples/helloworld/readme.htm
incubator/tuscany/java/sca/samples/helloworldweb/readme.htm
incubator/tuscany/java/sca/samples/helloworldws/readme.htm
incubator/tuscany/java/sca/samples/helloworldwsclient/readme.htm
incubator/tuscany/java/sca/samples/readme.htm
Modified:
incubator/tuscany/java/samples/readme.htm
Copied: incubator/tuscany/java/sampleSetup.htm (from r399686,
incubator/tuscany/java/samples/readme.htm)
URL:
http://svn.apache.org/viewcvs/incubator/tuscany/java/sampleSetup.htm?p2=incubator/tuscany/java/sampleSetup.htm&p1=incubator/tuscany/java/samples/readme.htm&r1=399686&r2=399815&rev=399815&view=diff
==============================================================================
--- incubator/tuscany/java/samples/readme.htm (original)
+++ incubator/tuscany/java/sampleSetup.htm Thu May 4 11:46:37 2006
@@ -1,103 +1,397 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<html><head><!-- Copyright (c) 2005 The Apache Software Foundation or its
licensors,
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<!-- 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.
-->
-<meta content="text/html; charset=iso-8859-1" http-equiv="Content-Type"> <meta
content="text/css" http-equiv="Content-Style-Type"><title>Tuscany
Samples</title><!-- LINK rel="stylesheet" href="ait.css" type="text/css" -->
-<style type="text/css" media="all">
+
+
+
+ <meta content="text/html; charset=iso-8859-1" http-equiv="Content-Type">
+
+
+
+ <meta content="text/css" http-equiv="Content-Style-Type">
+
+
+
+
+
+
+ <title>Tuscany Sample Setup</title>
+<!-- LINK rel="stylesheet" href="ait.css" type="text/css" -->
+ <style type="text/css" media="all">
@import url("../../css/maven-base.css");
@import url("../../css/maven-theme.css");
@import url("../../css/site.css");
-</style><link rel="stylesheet" href="./css/print.css" type="text/css"
media="print"></head>
-<body><h2>Tuscany Samples</h2><br><br><h3>Getting
-Tuscany</h3>Obtain Subversion <a target="_blank"
href="http://subversion.tigris.org/";>Subversion</a><br><ul><li>md
-tuscany</li><li>cd tuscany</li>
-<li>svn co http://svn.apache.org/repos/asf/incubator/tuscany/java</li>
-</ul><h3> Build
-Tuscany </h3>Obtain <a target="_blank"
href="http://maven.apache.org/";>Maven 2.0.2</a><br><ul><li>cd
-java</li><li>mvn</li></ul><h3>Setup</h3><h4><a name="J2SE_setup"></a>J2SE
-setup</h4>Tuscany applications can be run in a J2SE 5.0
+ </style>
+
+ <link rel="stylesheet" href="./css/print.css" type="text/css" media="print">
+</head>
+
+
+<body>
+
+
+<h2>Tuscany Sample Setup</h2>
+
+
+<br>
+
+
+<br>
+
+
+<h3>Getting
+Tuscany</h3>
+
+
+Obtain Subversion <a target="_blank"
href="http://subversion.tigris.org/";>Subversion</a><br>
+
+
+<ul>
+
+
+ <li>md
+tuscany</li>
+
+
+ <li>cd tuscany</li>
+
+
+ <li>svn co
+http://svn.apache.org/repos/asf/incubator/tuscany/java</li>
+
+
+</ul>
+
+
+<h3> Build
+Tuscany </h3>
+
+
+Obtain <a target="_blank" href="http://maven.apache.org/";>Maven
+2.0.2</a><br>
+
+
+<ul>
+
+
+ <li>cd
+java</li>
+
+
+ <li>mvn</li>
+
+
+</ul>
+
+
+<h3>Setup</h3>
+
+
+<h4><a name="J2SE_setup"></a>J2SE
+setup</h4>
+
+
+Tuscany applications can be run in a J2SE 5.0
environment. Before you
can run Tuscany applications in that environment, the Tuscany runtime
JAR files and the JAR files they depend on must be added to your J2SE
-classpath.<br>Samples not requiring invoking web
+classpath.<br>
+
+
+Samples not requiring invoking web
services
-need at least the following jars in their classpath<br><a
name="#J2SEJARSNWS"></a><br><table style="text-align: left; width: 100%;"
border="1" cellpadding="2" cellspacing="2"><tbody><tr><td><pre
style="margin-left:
40px;">axis-wsdl4j-1.2.jar<br>common-2.2.0-SNAPSHOT.jar<br>ecore-2.2.0-SNAPSHOT.jar<br>ecore-change-2.2.0-SNAPSHOT.jar<br>ecore-xmi-2.2.0-SNAPSHOT.jar<br>sca-api-SNAPSHOT.jar<br>sdo-api-SNAPSHOT.jar<br>stax-api-1.0.jar<br>tuscany-common-SNAPSHOT.jar<br>tuscany-container-java-SNAPSHOT.jar<br>tuscany-core-SNAPSHOT.jar<br>tuscany-model-SNAPSHOT.jar<br>tuscany-sdo-impl-SNAPSHOT.jar<br>xsd-2.2.0-SNAPSHOT.jar</pre></td></tr></tbody></table><span
style="font-style: italic;">There is an <a
href="http://ant.apache.org/bindownload.cgi"; target="_blank">ant</a>
+need at least the following jars in their classpath<br>
+
+
+<a name="#J2SEJARSNWS"></a><br>
+
+
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2"
cellspacing="2">
+
+
+ <tbody>
+
+
+ <tr>
+
+
+ <td>
+
+ <pre style="margin-left:
40px;">axis-wsdl4j-1.2.jar<br>common-2.2.0-SNAPSHOT.jar<br>ecore-2.2.0-SNAPSHOT.jar<br>ecore-change-2.2.0-SNAPSHOT.jar<br>ecore-xmi-2.2.0-SNAPSHOT.jar<br>sca-api-SNAPSHOT.jar<br>sdo-api-SNAPSHOT.jar<br>stax-api-1.0.jar<br>tuscany-common-SNAPSHOT.jar<br>tuscany-container-java-SNAPSHOT.jar<br>tuscany-core-SNAPSHOT.jar<br>tuscany-model-SNAPSHOT.jar<br>tuscany-sdo-impl-SNAPSHOT.jar<br>xsd-2.2.0-SNAPSHOT.jar</pre>
+
+
+ </td>
+
+
+ </tr>
+
+
+
+ </tbody>
+</table>
+
+
+<span style="font-style: italic;">There is an <a
href="http://ant.apache.org/bindownload.cgi"; target="_blank">ant</a>
script in java\testing\tomcat\build.xml that will produce in
tuscany\java\testing\tomcat\target\j2se all the jars above once you
-have completed the full maven build at the root. Run "<span
style="font-weight: bold;">ant j2se</span>" Use in java -Djava.ext.dirs
to point to this directory to include all these jars.</span><br><br>If
+have completed the full maven build at the root. Run "<span
style="font-weight: bold;">ant j2se</span>"
+ Use in java -Djava.ext.dirs to point to this directory to
+include all these jars.</span><br>
+
+
+<br>
+
+
+If
you're planning to use SCA Web Service bindings from your Tuscany
-application, add the following JAR files to your classpath:<br><table
style="text-align: left; width: 100%;" border="1" cellpadding="2"
cellspacing="2"><tbody><tr><td><pre style="margin-left:
40px;">asm-2.2.jar<br>axiom-api-0.95.jar<br>axiom-impl-0.95.jar<br>axis-wsdl4j-1.2.jar<br>axis2-kernel-0.95.jar<br>common-2.2.0-SNAPSHOT.jar<br>commons-codec-1.3.jar<br>commons-httpclient-3.0.jar<br>commons-logging-1.0.4.jar<br>ecore-2.2.0-SNAPSHOT.jar<br>ecore-change-2.2.0-SNAPSHOT.jar<br>ecore-xmi-2.2.0-SNAPSHOT.jar<br>log4j-1.2.12.jar<br>policy-1.0.jar<br>sca-api-SNAPSHOT.jar<br>sdo-api-SNAPSHOT.jar<br>stax-api-1.0.jar<br>tuscany-binding-axis2-SNAPSHOT.jar<br>tuscany-common-SNAPSHOT.jar<br>tuscany-container-java-SNAPSHOT.jar<br>tuscany-core-SNAPSHOT.jar<br>tuscany-model-SNAPSHOT.jar<br>tuscany-sdo-impl-SNAPSHOT.jar<br>wstx-asl-2.8.2.jar<br>XmlSchema-1.0.jar<br>xsd-2.2.0-SNAPSHOT.jar</pre></td></tr></tbody></table><span
style="font-style: italic;">There is an <a href="http://ant.apach
e.org/bindownload.cgi" target="_blank">ant</a>
+application, add the following JAR files to your classpath:<br>
+
+
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2"
cellspacing="2">
+
+
+ <tbody>
+
+
+ <tr>
+
+
+ <td>
+
+ <pre style="margin-left:
40px;">asm-2.2.jar<br>axiom-api-0.95.jar<br>axiom-impl-0.95.jar<br>axis-wsdl4j-1.2.jar<br>axis2-kernel-0.95.jar<br>common-2.2.0-SNAPSHOT.jar<br>commons-codec-1.3.jar<br>commons-httpclient-3.0.jar<br>commons-logging-1.0.4.jar<br>ecore-2.2.0-SNAPSHOT.jar<br>ecore-change-2.2.0-SNAPSHOT.jar<br>ecore-xmi-2.2.0-SNAPSHOT.jar<br>log4j-1.2.12.jar<br>policy-1.0.jar<br>sca-api-SNAPSHOT.jar<br>sdo-api-SNAPSHOT.jar<br>stax-api-1.0.jar<br>tuscany-binding-axis2-SNAPSHOT.jar<br>tuscany-common-SNAPSHOT.jar<br>tuscany-container-java-SNAPSHOT.jar<br>tuscany-core-SNAPSHOT.jar<br>tuscany-model-SNAPSHOT.jar<br>tuscany-sdo-impl-SNAPSHOT.jar<br>wstx-asl-2.8.2.jar<br>XmlSchema-1.0.jar<br>xsd-2.2.0-SNAPSHOT.jar</pre>
+
+
+ </td>
+
+
+ </tr>
+
+
+
+ </tbody>
+</table>
+
+
+<span style="font-style: italic;">There is an <a
href="http://ant.apache.org/bindownload.cgi"; target="_blank">ant</a>
script in java\testing\tomcat\build.xml that will produce in
tuscany\java\testing\tomcat\target\j2sews all the jars above once you
-have completed the full maven build at the root. Run "<span
style="font-weight: bold;">ant j2sews</span> Use in java -Djava.ext.dirs
to point to this directory to include all these jars.</span><h4><a
name="Tomcat_Setup"></a>Tomcat
+have completed the full maven build at the root. Run "<span
style="font-weight: bold;">ant j2sews</span>
+ Use in java -Djava.ext.dirs to point to this directory to
+include all these jars.</span>
+<h4><a name="Tomcat_Setup"></a>Tomcat
Setup</h4>
+
+
<p>The setup and configuration of the
Tomcat web server is a little more complex. If you are not
interested in the details the easiest means of configuring
-this environment is by running "ant" in <span style="font-style:
italic;">java\testing\tomcat </span>that will configure a server that is
-ready to run the samples and deploy your own SCA applications..</p><p>For
+this environment is by running "ant" in <span style="font-style:
italic;">java\testing\tomcat </span>that
+will configure a server that is
+ready to run the samples and deploy your own SCA applications..</p>
+
+
+<p>For
any other SCA application that is run in a Tomcat environment,
package it as a standard J2EE war file and deploy it as
usual. For
Tomcat this is simply done by copying them to its webapps
-directory. </p><p>The
+directory. </p>
+
+
+<p>The
details:</p>
-<ul compact="compact"><li>Unzip
-Tomcat to acceptance\target\apache-tomcat-5.5.15 </li><li>Add
+
+
+<ul compact="compact">
+
+
+ <li>Unzip
+Tomcat to acceptance\target\apache-tomcat-5.5.15 </li>
+
+
+ <li>Add
org.apache.Tuscany.tomcat.lifecycle.listener.TomcatServerLifecycleListener
to conf\server.xml<br>
-<table style="width: 100%; text-align: left; margin-left: auto; margin-right:
auto;" border="1" cellpadding="2" cellspacing="2"><tbody><tr><td
style="background-color: rgb(204, 204, 204);"><code>Chage
+
+
+
+ <table style="width: 100%; text-align: left; margin-left: auto;
margin-right: auto;" border="1" cellpadding="2" cellspacing="2">
+
+
+ <tbody>
+
+
+ <tr>
+
+
+ <td style="background-color: rgb(204, 204, 204);"><code>Change
the Host element to add </code><span style="font-weight:
bold;">className="org.apache.tuscany.tomcat.TuscanyHost"</span>
-attribute like this<code>:<br>
+attribute like this<code>:<br>
+
+
+
<Host <span style="color: rgb(255, 0,
0);">className="org.apache.tuscany.tomcat.TuscanyHost"
-</span>name="localhost" appBase="webapps" unpackWARs="true"
+ </span>name="localhost" appBase="webapps"
+unpackWARs="true"
autoDeploy="true" xmlValidation="false"
-xmlNamespaceAware="false"><br><br></code></td></tr></tbody>
-</table><p>The following jars need to be placed in tomcats
-common/lib directory</p><table style="text-align: left; width: 100%;"
border="1" cellpadding="2"
cellspacing="2"><tbody><tr><td><pre>common-2.2.0-snapshot.jar<br>ecore-2.2.0-snapshot.jar<br>ecore-change-2.2.0-snapshot.jar<br>ecore-xmi-2.2.0-snapshot.jar<br>sca-api-snapshot.jar<br>sdo-api-snapshot.jar<br>tuscany-das-rdb-snapshot.jar<br>tuscany-sdo-impl-snapshot.jar<br>xsd-2.2.0-snapshot.jar<br>jsonrpc-snapshot.jar
<span style="font-style: italic;"><span style="font-weight: bold;">Optional if
you want javascript components</span></span><br>derby-10.1.2.1.jar <span
style="font-style: italic;"><span style="font-weight: bold;">Optional if you
want database support</span></span></pre></td></tr></tbody></table>
-</li><li><p>The
-following jars need to go into the server/lib</p><table style="text-align:
left; width: 100%;" border="1" cellpadding="2"
cellspacing="2"><tbody><tr><td><pre>asm-2.2.jar<br>axiom-api-0.95.jar<br>axiom-impl-0.95.jar<br>axis-wsdl4j-1.2.jar<br>axis2-kernel-0.95.jar<br>commons-codec-1.3.jar<br>commons-httpclient-3.0.jar<br>log4j-1.2.12.jar<br>policy-1.0.jar<br>stax-api-1.0.jar<br>tuscany-binding-axis2-snapshot.jar<br>tuscany-binding-jsonrpc-snapshot.jar<br>tuscany-common-snapshot.jar<br>tuscany-container-java-snapshot.jar<br>tuscany-core-snapshot.jar<br>tuscany-model-snapshot.jar<br>tuscany-tomcat-snapshot.jar<br>wstx-asl-2.8.2.jar<br>xmlschema-1.0.jar</pre></td></tr></tbody></table><br></li><li>For
+xmlNamespaceAware="false"><br>
+
+
+ <br>
+
+
+ </code></td>
+
+
+ </tr>
+
+
+
+ </tbody>
+
+ </table>
+
+
+
+ <p>The following jars need to be placed in tomcats
+common/lib directory</p>
+
+
+
+ <table style="text-align: left; width: 100%;" border="1" cellpadding="2"
cellspacing="2">
+
+
+ <tbody>
+
+
+ <tr>
+
+
+ <td>
+
+
<pre>common-2.2.0-snapshot.jar<br>ecore-2.2.0-snapshot.jar<br>ecore-change-2.2.0-snapshot.jar<br>ecore-xmi-2.2.0-snapshot.jar<br>sca-api-snapshot.jar<br>sdo-api-snapshot.jar<br>tuscany-das-rdb-snapshot.jar<br>tuscany-sdo-impl-snapshot.jar<br>xsd-2.2.0-snapshot.jar<br>jsonrpc-snapshot.jar
<span style="font-style: italic;"><span style="font-weight: bold;">Optional if
you want javascript components</span></span><br>derby-10.1.2.1.jar <span
style="font-style: italic;"><span style="font-weight: bold;">Optional if you
want database support</span></span></pre>
+
+
+ </td>
+
+
+ </tr>
+
+
+
+ </tbody>
+
+ </table>
+
+
+ </li>
+
+
+ <li>
+
+ <p>The
+following jars need to go into the server/lib</p>
+
+
+
+ <table style="text-align: left; width: 100%;" border="1" cellpadding="2"
cellspacing="2">
+
+
+ <tbody>
+
+
+ <tr>
+
+
+ <td>
+
+
<pre>asm-2.2.jar<br>axiom-api-0.95.jar<br>axiom-impl-0.95.jar<br>axis-wsdl4j-1.2.jar<br>axis2-kernel-0.95.jar<br>commons-codec-1.3.jar<br>commons-httpclient-3.0.jar<br>log4j-1.2.12.jar<br>policy-1.0.jar<br>stax-api-1.0.jar<br>tuscany-binding-axis2-snapshot.jar<br>tuscany-binding-jsonrpc-snapshot.jar<br>tuscany-common-snapshot.jar<br>tuscany-container-java-snapshot.jar<br>tuscany-core-snapshot.jar<br>tuscany-model-snapshot.jar<br>tuscany-tomcat-snapshot.jar<br>wstx-asl-2.8.2.jar<br>xmlschema-1.0.jar</pre>
+
+
+ </td>
+
+
+ </tr>
+
+
+
+ </tbody>
+
+ </table>
+
+
+ <br>
+
+
+ </li>
+
+
+ <li>For
the samples copy their war files to Tomcat's webapps
-directory.</li></ul>
-<h3>Sample Summary</h3>
-<table style="text-align: left; width: 100%;" border="0" cellpadding="2"
cellspacing="2"><caption style="text-decoration: underline;">Tuscany
-samples summary</caption><tbody>
-<tr><td style="vertical-align: top; white-space: nowrap;"><a
href="helloworld/helloworld/readme.htm"
target="_blank">helloworld</a></td><td>Shows
-using the Tuscany SCA runtime in a J2SE environment loading a
-component.<br><br></td></tr>
-<tr><td style="vertical-align: top; white-space: nowrap;"><a
href="helloworld/helloworldaxis2/readme.htm"
target="_blank">helloworldaxis</a> </td><td>This sample
-is not an SCA application. The purpose for it's inclusion
-in the samples is to demonstrate the interoperability of
- Tuscany's web service binding with another SOAP
-implementation.<br><br></td></tr>
-<tr><td style="vertical-align: top; white-space: nowrap;"><a
href="helloworld/helloworldaxissvc/readme.htm"
target="_blank">helloworldaxissvc</a> </td><td>This
-sample generates the war for the Axis implemented hello world sample.
- It is not an SCA application.<br> </td></tr>
-<tr><td style="vertical-align: top; white-space: nowrap;"><a
href="helloworld/helloworldmc/readme.htm="
target="_blank">helloworldmc</a> </td><td>This
-sample shows in a J2SE environment the wiring of multiple components
-and customizing components.<br><br></td></tr>
-<tr><td style="vertical-align: top; white-space: nowrap;"><a
href="helloworld/helloworldweb/readme.htm"
target="_blank">helloworldweb</a> </td><td>This
-sample shows in a J2EE environment using SCA components to handle HTML
-forms.<br><br></td></tr>
-<tr><td style="vertical-align: top; white-space: nowrap;"><a
href="helloworld/customers/readme.htm"
target="_blank">customers</a> </td><td>This
-sample is a variation on 'HelloWorldWeb' and employs the Relational
-Database Data Access Service to read customer records from a Derby
-database.
-<br><br></td></tr><tr><td style="vertical-align: top; white-space: nowrap;"><a
href="helloworld/helloworldws/readme.htm"
target="_blank">helloworldws</a> </td><td>Sample
-shows using the Tuscany SCA runtime in a Tomcat environment
-providing a
-web service <br><br></td></tr>
-<tr><td style="vertical-align: top; white-space: nowrap;"><a
href="helloworld/helloworldwsclient/readme.htm"
target="_blank">helloworldwsclient</a> </td><td>Sample
-shows using the Tuscany SCA runtime in a J2SE environment using a
-web service <br><br></td></tr>
-<tr><td style="vertical-align: top; white-space:
nowrap;">bigbank.account </td><td>Sample
-contains an implementation of the bigbank.account module; see "Building
-Your First Application" document.
- <br><br></td></tr>
-<tr><td style="vertical-align: top; white-space:
nowrap;">bigbank.webclient </td><td>Sample
-contains an implementation of the bigbank.webclient module; see
-"Building Your First Application" document.
- <br><br></td></tr>
-</tbody></table><br></body></html>
\ No newline at end of file
+directory.</li>
+
+
+</ul>
+
+
+<h3>Samples </h3>
+
+
+<table style="text-align: left; width: 100%;" border="0" cellpadding="2"
cellspacing="2">
+
+
+ <caption style="text-decoration: underline;">Tuscany
+samples and applications</caption><tbody>
+
+
+ <tr>
+
+
+ <td style="vertical-align: top; white-space: nowrap;"><a
href="sca/samples/readme.htm"><span style="text-decoration:
underline;"></span></a><a href="sca/samples/readme.htm">SCA technology
samples</a> </td>
+
+
+ <td>Shows
+simple samples that emphasizes how to to use SCA technology.<br>
+
+
+ </td>
+
+
+ </tr>
+
+
+ <tr>
+
+
+ <td style="vertical-align: top; white-space: nowrap;"><a
href="samples/readme.htm">Sample
+applications</a></td>
+
+
+ <td>Sample business applications that show the value of SCA
+and SDO.<br>
+
+
+ <br>
+
+
+ </td>
+
+
+ </tr>
+
+
+
+ </tbody>
+</table>
+
+
+<br>
+
+
+</body>
+</html>
Modified: incubator/tuscany/java/samples/readme.htm
URL:
http://svn.apache.org/viewcvs/incubator/tuscany/java/samples/readme.htm?rev=399815&r1=399814&r2=399815&view=diff
==============================================================================
--- incubator/tuscany/java/samples/readme.htm (original)
+++ incubator/tuscany/java/samples/readme.htm Thu May 4 11:46:37 2006
@@ -1,103 +1,63 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-<html><head><!-- Copyright (c) 2005 The Apache Software Foundation or its
licensors,
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<!-- 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.
-->
-<meta content="text/html; charset=iso-8859-1" http-equiv="Content-Type"> <meta
content="text/css" http-equiv="Content-Style-Type"><title>Tuscany
Samples</title><!-- LINK rel="stylesheet" href="ait.css" type="text/css" -->
-<style type="text/css" media="all">
+ <meta content="text/html; charset=iso-8859-1" http-equiv="Content-Type">
+
+ <meta content="text/css" http-equiv="Content-Style-Type">
+ <title>Tuscany Samples</title>
+<!-- LINK rel="stylesheet" href="ait.css" type="text/css" -->
+ <style type="text/css" media="all">
@import url("../../css/maven-base.css");
@import url("../../css/maven-theme.css");
@import url("../../css/site.css");
-</style><link rel="stylesheet" href="./css/print.css" type="text/css"
media="print"></head>
-<body><h2>Tuscany Samples</h2><br><br><h3>Getting
-Tuscany</h3>Obtain Subversion <a target="_blank"
href="http://subversion.tigris.org/";>Subversion</a><br><ul><li>md
-tuscany</li><li>cd tuscany</li>
-<li>svn co http://svn.apache.org/repos/asf/incubator/tuscany/java</li>
-</ul><h3> Build
-Tuscany </h3>Obtain <a target="_blank"
href="http://maven.apache.org/";>Maven 2.0.2</a><br><ul><li>cd
-java</li><li>mvn</li></ul><h3>Setup</h3><h4><a name="J2SE_setup"></a>J2SE
-setup</h4>Tuscany applications can be run in a J2SE 5.0
-environment. Before you
-can run Tuscany applications in that environment, the Tuscany runtime
-JAR files and the JAR files they depend on must be added to your J2SE
-classpath.<br>Samples not requiring invoking web
-services
-need at least the following jars in their classpath<br><a
name="#J2SEJARSNWS"></a><br><table style="text-align: left; width: 100%;"
border="1" cellpadding="2" cellspacing="2"><tbody><tr><td><pre
style="margin-left:
40px;">axis-wsdl4j-1.2.jar<br>common-2.2.0-SNAPSHOT.jar<br>ecore-2.2.0-SNAPSHOT.jar<br>ecore-change-2.2.0-SNAPSHOT.jar<br>ecore-xmi-2.2.0-SNAPSHOT.jar<br>sca-api-SNAPSHOT.jar<br>sdo-api-SNAPSHOT.jar<br>stax-api-1.0.jar<br>tuscany-common-SNAPSHOT.jar<br>tuscany-container-java-SNAPSHOT.jar<br>tuscany-core-SNAPSHOT.jar<br>tuscany-model-SNAPSHOT.jar<br>tuscany-sdo-impl-SNAPSHOT.jar<br>xsd-2.2.0-SNAPSHOT.jar</pre></td></tr></tbody></table><span
style="font-style: italic;">There is an <a
href="http://ant.apache.org/bindownload.cgi"; target="_blank">ant</a>
-script in java\testing\tomcat\build.xml that will produce in
-tuscany\java\testing\tomcat\target\j2se all the jars above once you
-have completed the full maven build at the root. Run "<span
style="font-weight: bold;">ant j2se</span>" Use in java -Djava.ext.dirs
to point to this directory to include all these jars.</span><br><br>If
-you're planning to use SCA Web Service bindings from your Tuscany
-application, add the following JAR files to your classpath:<br><table
style="text-align: left; width: 100%;" border="1" cellpadding="2"
cellspacing="2"><tbody><tr><td><pre style="margin-left:
40px;">asm-2.2.jar<br>axiom-api-0.95.jar<br>axiom-impl-0.95.jar<br>axis-wsdl4j-1.2.jar<br>axis2-kernel-0.95.jar<br>common-2.2.0-SNAPSHOT.jar<br>commons-codec-1.3.jar<br>commons-httpclient-3.0.jar<br>commons-logging-1.0.4.jar<br>ecore-2.2.0-SNAPSHOT.jar<br>ecore-change-2.2.0-SNAPSHOT.jar<br>ecore-xmi-2.2.0-SNAPSHOT.jar<br>log4j-1.2.12.jar<br>policy-1.0.jar<br>sca-api-SNAPSHOT.jar<br>sdo-api-SNAPSHOT.jar<br>stax-api-1.0.jar<br>tuscany-binding-axis2-SNAPSHOT.jar<br>tuscany-common-SNAPSHOT.jar<br>tuscany-container-java-SNAPSHOT.jar<br>tuscany-core-SNAPSHOT.jar<br>tuscany-model-SNAPSHOT.jar<br>tuscany-sdo-impl-SNAPSHOT.jar<br>wstx-asl-2.8.2.jar<br>XmlSchema-1.0.jar<br>xsd-2.2.0-SNAPSHOT.jar</pre></td></tr></tbody></table><span
style="font-style: italic;">There is an <a href="http://ant.apach
e.org/bindownload.cgi" target="_blank">ant</a>
-script in java\testing\tomcat\build.xml that will produce in
-tuscany\java\testing\tomcat\target\j2sews all the jars above once you
-have completed the full maven build at the root. Run "<span
style="font-weight: bold;">ant j2sews</span> Use in java -Djava.ext.dirs
to point to this directory to include all these jars.</span><h4><a
name="Tomcat_Setup"></a>Tomcat
-Setup</h4>
-<p>The setup and configuration of the
-Tomcat web server is a little more complex. If you are not
-interested in the details the easiest means of configuring
-this environment is by running "ant" in <span style="font-style:
italic;">java\testing\tomcat </span>that will configure a server that is
-ready to run the samples and deploy your own SCA applications..</p><p>For
-any other SCA application that is run in a Tomcat environment,
-package it as a standard J2EE war file and deploy it as
-usual. For
-Tomcat this is simply done by copying them to its webapps
-directory. </p><p>The
-details:</p>
-<ul compact="compact"><li>Unzip
-Tomcat to acceptance\target\apache-tomcat-5.5.15 </li><li>Add
-org.apache.Tuscany.tomcat.lifecycle.listener.TomcatServerLifecycleListener
-to conf\server.xml<br>
-<table style="width: 100%; text-align: left; margin-left: auto; margin-right:
auto;" border="1" cellpadding="2" cellspacing="2"><tbody><tr><td
style="background-color: rgb(204, 204, 204);"><code>Chage
-the Host element to add </code><span style="font-weight:
bold;">className="org.apache.tuscany.tomcat.TuscanyHost"</span>
-attribute like this<code>:<br>
-<Host <span style="color: rgb(255, 0,
0);">className="org.apache.tuscany.tomcat.TuscanyHost"
-</span>name="localhost" appBase="webapps" unpackWARs="true"
-autoDeploy="true" xmlValidation="false"
-xmlNamespaceAware="false"><br><br></code></td></tr></tbody>
-</table><p>The following jars need to be placed in tomcats
-common/lib directory</p><table style="text-align: left; width: 100%;"
border="1" cellpadding="2"
cellspacing="2"><tbody><tr><td><pre>common-2.2.0-snapshot.jar<br>ecore-2.2.0-snapshot.jar<br>ecore-change-2.2.0-snapshot.jar<br>ecore-xmi-2.2.0-snapshot.jar<br>sca-api-snapshot.jar<br>sdo-api-snapshot.jar<br>tuscany-das-rdb-snapshot.jar<br>tuscany-sdo-impl-snapshot.jar<br>xsd-2.2.0-snapshot.jar<br>jsonrpc-snapshot.jar
<span style="font-style: italic;"><span style="font-weight: bold;">Optional if
you want javascript components</span></span><br>derby-10.1.2.1.jar <span
style="font-style: italic;"><span style="font-weight: bold;">Optional if you
want database support</span></span></pre></td></tr></tbody></table>
-</li><li><p>The
-following jars need to go into the server/lib</p><table style="text-align:
left; width: 100%;" border="1" cellpadding="2"
cellspacing="2"><tbody><tr><td><pre>asm-2.2.jar<br>axiom-api-0.95.jar<br>axiom-impl-0.95.jar<br>axis-wsdl4j-1.2.jar<br>axis2-kernel-0.95.jar<br>commons-codec-1.3.jar<br>commons-httpclient-3.0.jar<br>log4j-1.2.12.jar<br>policy-1.0.jar<br>stax-api-1.0.jar<br>tuscany-binding-axis2-snapshot.jar<br>tuscany-binding-jsonrpc-snapshot.jar<br>tuscany-common-snapshot.jar<br>tuscany-container-java-snapshot.jar<br>tuscany-core-snapshot.jar<br>tuscany-model-snapshot.jar<br>tuscany-tomcat-snapshot.jar<br>wstx-asl-2.8.2.jar<br>xmlschema-1.0.jar</pre></td></tr></tbody></table><br></li><li>For
-the samples copy their war files to Tomcat's webapps
-directory.</li></ul>
+ </style>
+ <link rel="stylesheet" href="./css/print.css" type="text/css" media="print">
+</head>
+
+<body>
+<h2>Tuscany Sample Applications</h2>
+To set up for the sample read the <a href="../sampleSetup.htm">Sample
setup</a><br>
+<br>
<h3>Sample Summary</h3>
-<table style="text-align: left; width: 100%;" border="0" cellpadding="2"
cellspacing="2"><caption style="text-decoration: underline;">Tuscany
+
+<table style="text-align: left; width: 100%;" border="0" cellpadding="2"
cellspacing="2">
+ <caption style="text-decoration: underline;">Tuscany
samples summary</caption><tbody>
-<tr><td style="vertical-align: top; white-space: nowrap;"><a
href="helloworld/helloworld/readme.htm"
target="_blank">helloworld</a></td><td>Shows
-using the Tuscany SCA runtime in a J2SE environment loading a
-component.<br><br></td></tr>
-<tr><td style="vertical-align: top; white-space: nowrap;"><a
href="helloworld/helloworldaxis2/readme.htm"
target="_blank">helloworldaxis</a> </td><td>This sample
-is not an SCA application. The purpose for it's inclusion
-in the samples is to demonstrate the interoperability of
- Tuscany's web service binding with another SOAP
-implementation.<br><br></td></tr>
-<tr><td style="vertical-align: top; white-space: nowrap;"><a
href="helloworld/helloworldaxissvc/readme.htm"
target="_blank">helloworldaxissvc</a> </td><td>This
-sample generates the war for the Axis implemented hello world sample.
- It is not an SCA application.<br> </td></tr>
-<tr><td style="vertical-align: top; white-space: nowrap;"><a
href="helloworld/helloworldmc/readme.htm="
target="_blank">helloworldmc</a> </td><td>This
-sample shows in a J2SE environment the wiring of multiple components
-and customizing components.<br><br></td></tr>
-<tr><td style="vertical-align: top; white-space: nowrap;"><a
href="helloworld/helloworldweb/readme.htm"
target="_blank">helloworldweb</a> </td><td>This
-sample shows in a J2EE environment using SCA components to handle HTML
-forms.<br><br></td></tr>
-<tr><td style="vertical-align: top; white-space: nowrap;"><a
href="helloworld/customers/readme.htm"
target="_blank">customers</a> </td><td>This
-sample is a variation on 'HelloWorldWeb' and employs the Relational
-Database Data Access Service to read customer records from a Derby
-database.
-<br><br></td></tr><tr><td style="vertical-align: top; white-space: nowrap;"><a
href="helloworld/helloworldws/readme.htm"
target="_blank">helloworldws</a> </td><td>Sample
-shows using the Tuscany SCA runtime in a Tomcat environment
-providing a
-web service <br><br></td></tr>
-<tr><td style="vertical-align: top; white-space: nowrap;"><a
href="helloworld/helloworldwsclient/readme.htm"
target="_blank">helloworldwsclient</a> </td><td>Sample
-shows using the Tuscany SCA runtime in a J2SE environment using a
-web service <br><br></td></tr>
-<tr><td style="vertical-align: top; white-space:
nowrap;">bigbank.account </td><td>Sample
+
+
+
+
+
+
+
+
+ <tr>
+ <td style="vertical-align: top; white-space:
nowrap;">bigbank.account </td>
+ <td>Sample
contains an implementation of the bigbank.account module; see "Building
Your First Application" document.
- <br><br></td></tr>
-<tr><td style="vertical-align: top; white-space:
nowrap;">bigbank.webclient </td><td>Sample
+ <br>
+ <br>
+ </td>
+ </tr>
+
+ <tr>
+ <td style="vertical-align: top; white-space:
nowrap;">bigbank.webclient </td>
+ <td>Sample
contains an implementation of the bigbank.webclient module; see
"Building Your First Application" document.
- <br><br></td></tr>
-</tbody></table><br></body></html>
\ No newline at end of file
+ <br>
+ <br>
+ </td>
+ </tr>
+
+ </tbody>
+</table>
+<br>
+</body>
+</html>
Added: incubator/tuscany/java/sca/samples/helloworld/readme.htm
URL:
http://svn.apache.org/viewcvs/incubator/tuscany/java/sca/samples/helloworld/readme.htm?rev=399815&view=auto
==============================================================================
--- incubator/tuscany/java/sca/samples/helloworld/readme.htm (added)
+++ incubator/tuscany/java/sca/samples/helloworld/readme.htm Thu May 4
11:46:37 2006
@@ -0,0 +1,164 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<!--
+ 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.
+ -->
+
+
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+
+
+ <meta http-equiv="Content-Style-Type" content="text/css">
+
+
+ <title>Tuscany HelloWorld</title>
+<!-- LINK rel="stylesheet" href="ait.css" type="text/css" -->
+ <style type="text/css" media="all">
[EMAIL PROTECTED] url("../../../../css/maven-base.css");
[EMAIL PROTECTED] url("../../../../css/maven-theme.css");
[EMAIL PROTECTED] url("../../../../css/site.css");
+ </style>
+ <link rel="stylesheet" href="./css/print.css" type="text/css" media="print">
+</head>
+
+
+<body>
+
+
+<h2>Tuscany Hello World Sample</h2>
+
+
+<h3>Overview</h3>
+
+
+<p>The Tuscany helloworld sample shows using the Tuscany SCA
+ runtime in a J2SE environment loading a component that
+ implements the classic introductory hello world example. </p>
+
+
+
+<h3>Setup</h3>
+The jars for a <a href="../../../sampleSetup.htm" target="_blank">J2SE
setup</a> not requiring web
+services are required including the sample's own jar <span style="font-weight:
bold;">helloworld-SNAPSHOT.jar</span>.
+
+
+<ol>
+
+</ol>
+
+
+<h3>Running</h3>
+
+
+Using JDK 1.5 java command with the previous jars run the class
org.apache.tuscany.samples.helloworld.HelloWorldClient
+<br>
+
+
+<h3>Results</h3>
+
+
+<p>The sample when run should simply display to the standard
+ output:<br>
+
+
+ <code>Hello World</code></p>
+
+
+
+<h3>Code Overview</h3>
+
+
+The source files are physically organized as shown below:
+<pre>sca.module<br>org<br>+-apache<br> +-tuscany<br> +-samples<br>
+-helloworld<br> HelloWorldClient.java<br>
+ HelloWorldService.java<br>
HelloWorldServiceComponentImpl.java<br><br><br></pre>
+
+
+<p> </p>
+
+
+<table style="text-align: left; width: 879px; height: 154px;" border="0"
cellpadding="2" cellspacing="2">
+
+
+ <tbody>
+
+
+ <tr>
+
+
+ <td style="vertical-align: top;">sca.module</td>
+
+
+ <td>Defines the SCA module and component. Defines for the
+ HelloWorldServiceComponent component the Java class that
+ implements that component</td>
+
+
+ </tr>
+
+
+ <tr>
+
+
+ <td style="vertical-align: top;">HelloWorldService.java</td>
+
+
+ <td>Defines the Java interface implemented by the component.</td>
+
+
+ </tr>
+
+
+ <tr>
+
+
+ <td style="vertical-align:
top;">HelloWorldServiceComponentImpl.java</td>
+
+
+ <td>Implements the SCA component. Uses the SCA service
+ annotation tag on the class to show what SCA interface is being
+ implemented.</td>
+
+
+ </tr>
+
+
+ <tr>
+
+
+ <td style="vertical-align: top;">HelloWorldClient.java</td>
+
+
+ <td>Creates a Tuscany runtime and starts it.
+ Obtains the module context which was defined by the
+ sca.module file. From the module context locates the
+ HelloWorldServiceComponent and then calls the
getGreetings
+ method to invoke the component.</td>
+
+
+ </tr>
+
+
+
+ </tbody>
+</table>
+
+
+<br>
+
+
+</body>
+</html>
Added: incubator/tuscany/java/sca/samples/helloworldweb/readme.htm
URL:
http://svn.apache.org/viewcvs/incubator/tuscany/java/sca/samples/helloworldweb/readme.htm?rev=399815&view=auto
==============================================================================
--- incubator/tuscany/java/sca/samples/helloworldweb/readme.htm (added)
+++ incubator/tuscany/java/sca/samples/helloworldweb/readme.htm Thu May 4
11:46:37 2006
@@ -0,0 +1,192 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<!--
+ 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.
+ -->
+
+
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+
+
+ <meta http-equiv="Content-Style-Type" content="text/css">
+
+
+
+ <title>Tuscany Hello World Web Sample</title>
+<!-- LINK rel="stylesheet" href="ait.css" type="text/css" --><!-- maven -->
+ <style type="text/css" media="all">
[EMAIL PROTECTED] url("../../../../css/maven-base.css");
[EMAIL PROTECTED] url("../../../../css/maven-theme.css");
[EMAIL PROTECTED] url("../../../../css/site.css");
+ </style>
+ <link rel="stylesheet" href="./css/print.css" type="text/css" media="print">
+<!-- end maven -->
+</head>
+
+
+<body>
+
+
+<h2>Tuscany Hello World Web Sample</h2>
+
+
+<h3>Overview</h3>
+
+
+<p>The Tuscany hello world web sample shows using the Tuscany SCA
+ runtime in a Tomcat environment being accessed from a JSP
+ page that
+ implements the classic introductory hello world example. </p>
+
+
+
+<h3>Setup</h3>
+Set up your server as described in the <a href="../../../sampleSetup.htm"
target="_blank">Tomcat
+ Setup</a>. If you are not configuring with the acceptance test the
server, you will need to add <span style="font-weight:
bold;">helloworldWeb-SNAPSHOT.war</span> to your tomcat's webapp directory.<br>
+
+
+<h3>Running</h3>
+
+
+Once you've started your web server, use your browse to view the
+following URL: <a href="http://localhost:8080/helloworldWeb-SNAPSHOT/";
target="_blank">http://localhost:8080/helloworldWeb-SNAPSHOT/</a>
+<br>
+
+
+You should see a form you can supply your name and a submit button.
+ Once you submit the form the JSP page calls a Java class that
+gets the CurrentModuleContext and locates the SCA component to execute
+the greeting service. Note, unlike the a J2SE in a Tomcat environment
the Tuscany runtime is automatically
+initialized and running.
+<h3>Results</h3>
+
+
+<p>The page should be updated with the greeting displayed below
+ the form.<br>
+
+
+</p>
+
+
+<h3>Code Overview</h3>
+
+
+The source files are physically organized as shown below:<br>
+
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2"
cellspacing="2">
+
+ <tbody>
+
+ <tr>
+
+ <td>
+
+ <pre>+---main<br>¦ +---java<br>¦ ¦
sca.module<br>¦ ¦<br> <br>¦
+---org<br>¦ +---apache<br>¦
+---tuscany<br> <br>¦
+---samples<br>¦ +---helloworldweb<br>
<br>¦
HelloWorldService.java<br>¦<br>
HelloWorldServiceComponentImpl.java<br>¦<br>+---webapp<br> ¦
HelloWorldWeb.jsp<br> <br> ¦<br> +---WEB-INF<br>
web.xml<br></pre>
+
+ </td>
+
+ </tr>
+
+
+ </tbody>
+</table>
+
+<br>
+
+<br>
+
+
+<p> </p>
+
+
+<table style="text-align: left; width: 100%; height: 154px;" border="0"
cellpadding="2" cellspacing="2">
+
+
+ <tbody>
+
+
+ <tr>
+
+
+ <td style="vertical-align: top;">sca.module</td>
+
+
+ <td>Defines the SCA module and component. Defines for the
+ HelloWorldServiceComponent component and the Java class that
+ implements that component</td>
+
+
+ </tr>
+
+
+ <tr>
+
+
+ <td style="vertical-align: top;">HelloWorldService.java</td>
+
+
+ <td>Defines the Java interface implemented by the component.</td>
+
+
+ </tr>
+
+
+ <tr>
+
+
+ <td style="vertical-align:
top;">HelloWorldServiceComponentImpl.java</td>
+
+
+ <td>Implements the SCA component. Uses the SCA service
+ annotation tag on the class to show what SCA interface is being
+ implemented.</td>
+
+
+ </tr>
+
+
+
+ <tr>
+
+ <td>HelloWorldWeb.jsp</td>
+
+ <td>Handles Web form input.. Obtains the module context which was
defined by the
+ sca.module file. From the module context locates the
+ HelloWorldServiceComponent and then calls the
getGreetings
+ method to invoke the component. and formats
returned results.</td>
+
+ </tr>
+
+ <tr>
+
+ <td>web.xml</td>
+
+ <td>Standard J2EE web application's web.xml</td>
+
+ </tr>
+
+
+
+ </tbody>
+</table>
+
+
+<br>
+
+
+</body>
+</html>
Added: incubator/tuscany/java/sca/samples/helloworldws/readme.htm
URL:
http://svn.apache.org/viewcvs/incubator/tuscany/java/sca/samples/helloworldws/readme.htm?rev=399815&view=auto
==============================================================================
--- incubator/tuscany/java/sca/samples/helloworldws/readme.htm (added)
+++ incubator/tuscany/java/sca/samples/helloworldws/readme.htm Thu May 4
11:46:37 2006
@@ -0,0 +1,269 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<!--
+ 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.
+ -->
+
+
+
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+
+
+
+ <meta http-equiv="Content-Style-Type" content="text/css">
+
+
+
+
+
+ <title>Tuscany Hello World Web Sample</title>
+<!-- LINK rel="stylesheet" href="ait.css" type="text/css" --><!-- maven -->
+ <style type="text/css" media="all">
[EMAIL PROTECTED] url("../../../../css/maven-base.css");
[EMAIL PROTECTED] url("../../../../css/maven-theme.css");
[EMAIL PROTECTED] url("../../../../css/site.css");
+ </style>
+ <link rel="stylesheet" href="./css/print.css" type="text/css" media="print">
+<!-- end maven -->
+</head>
+
+
+<body>
+
+
+
+<h2>Tuscany Hello World WS Sample</h2>
+
+
+
+<h3>Overview</h3>
+
+
+
+<p>The Tuscany hello world ws sample shows using the Tuscany SCA
+ runtime in a Tomcat environment providing a web service.. </p>
+
+
+
+<h3>Setup</h3>
+
+
+
+Set up your server as described in the <a href="../../../sampleSetup.htm"
target="_blank">Tomcat Setup</a>. If
+you are not configuring with the acceptance test the server, you will need to
add <span style="font-weight: bold;">helloworldws-SNAPSHOT.war</span>
+to your Tomcat's webapp directory.
+
+
+<h3>Running</h3>
+
+
+This service can be invoked by either the Tuscany SCA <a target="_blank"
href="../helloworldwsclient/readme.htm">helloworldwsclient</a>
+sample or <a href="../helloworldaxis/readme.htm" target="_blank">hello
+ world Axis sample's</a> client sample.<br>
+
+
+<h3>Code Overview</h3>
+
+
+
+The source files are physically organized as shown below:<br>
+
+
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2"
cellspacing="2">
+
+
+ <tbody>
+
+
+ <tr>
+
+
+ <td>+---main<br>
+
+ ¦ +---java<br>
+
+ ¦ ¦ ¦
sca.module<br>
+
+ ¦ ¦ ¦<br>
+
+ ¦ ¦ +---org<br>
+
+ ¦
¦ +---apache<br>
+
+ ¦
¦ +---tuscany
+ <br>
+¦
+¦
++---samples<br>
+¦
+¦
++---helloworldws<br>
+¦
+¦
+HelloWorldService.java<br>
+¦
+¦
+HelloWorldServiceComponentImpl.java<br>
+
+ ¦ ¦<br>
+
+ ¦ +---resources<br>
+
+ ¦
¦ tuscany-model.config<br>
+
+ ¦ ¦<br>
+
+ ¦ +---wsdl<br>
+
+
¦
+ helloworld.wsdl<br>
+
+ ¦<br>
+
+ ¦<br>
+
+ +---webapp<br>
+
+ +---WEB-INF<br>
+
+
web.xml<br>
+
+ </td>
+
+
+ </tr>
+
+
+
+
+ </tbody>
+</table>
+
+
+<br>
+
+
+<br>
+
+
+
+<table style="text-align: left; width: 100%; height: 154px;" border="0"
cellpadding="2" cellspacing="2">
+
+
+
+ <tbody>
+
+
+
+ <tr>
+
+
+
+ <td style="vertical-align: top; height: 62px;">sca.module</td>
+
+
+
+ <td style="height: 62px;">Defines the SCA module, entryPoint
+ and component. Defines for the
+ HelloWorldServiceComponent component and the Java class that
+ implements the component For the entryPoint it defines WSDL
for the
+ service, the Java interface provided by the service, and wires
the
+ service to the HelloWorldServiceComponent</td>
+
+
+
+ </tr>
+
+
+
+ <tr>
+
+
+
+ <td style="vertical-align: top; height:
26px;">HelloWorldService.java</td>
+
+
+
+ <td style="height: 26px;">Defines the Java interface implemented
by the component.</td>
+
+
+
+ </tr>
+
+
+
+ <tr>
+
+
+
+ <td style="vertical-align:
top;">HelloWorldServiceComponentImpl.java</td>
+
+
+
+ <td>Implements the SCA component. Uses the SCA service
+ annotation tag on the class to show what SCA interface is being
+ implemented. Also uses the SCA Java annotation
"Remotable" to
+ indicate that a component implemented by this class can be
+ referenced out side of the SCA module it resides in.</td>
+
+
+
+ </tr>
+
+
+
+ <tr>
+
+
+ <td>tuscany-model.config</td>
+
+
+ <td>Maps the SCA Entry point WSDL to the physical WSDL file
location.</td>
+
+
+ </tr>
+
+
+ <tr>
+
+ <td>helloworld.wsdl</td>
+
+ <td>WSDL for the service.</td>
+
+ </tr>
+
+ <tr>
+
+
+ <td>web.xml</td>
+
+
+ <td>Standard J2EE web application's web.xml</td>
+
+
+ </tr>
+
+
+
+
+ </tbody>
+</table>
+
+
+
+</body>
+</html>
Added: incubator/tuscany/java/sca/samples/helloworldwsclient/readme.htm
URL:
http://svn.apache.org/viewcvs/incubator/tuscany/java/sca/samples/helloworldwsclient/readme.htm?rev=399815&view=auto
==============================================================================
--- incubator/tuscany/java/sca/samples/helloworldwsclient/readme.htm (added)
+++ incubator/tuscany/java/sca/samples/helloworldwsclient/readme.htm Thu May 4
11:46:37 2006
@@ -0,0 +1,269 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<!--
+ 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.
+ -->
+
+
+ <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+
+
+
+ <meta http-equiv="Content-Style-Type" content="text/css">
+
+
+
+ <title>Tuscany Hello World Web Sample</title>
+<!-- LINK rel="stylesheet" href="ait.css" type="text/css" --><!-- maven -->
+ <style type="text/css" media="all">
[EMAIL PROTECTED] url("../../../../css/maven-base.css");
[EMAIL PROTECTED] url("../../../../css/maven-theme.css");
[EMAIL PROTECTED] url("../../../../css/site.css");
+ </style>
+ <link rel="stylesheet" href="./css/print.css" type="text/css" media="print">
+<!-- end maven -->
+</head>
+
+
+<body>
+
+
+<h2>Tuscany Hello World WS Client Sample</h2>
+
+
+<h3>Overview</h3>
+
+
+<p>The Tuscany hello world WS client sample shows using the Tuscany SCA
+ runtime in a J2SE environment invoking a web service. </p>
+
+
+<h3>Setup</h3>
+
+
+The jars for a <a href="../../../sampleSetup.htm" target="_blank">J2SE
setup</a> including those necessary
+for web services are required including the sample's own jar <span
style="font-weight: bold;">helloworldwsclient-SNAPSHOT.jar</span>.
+
+<h3>Running</h3>
+
+Using JDK 1.5 java command with the previous mentioned jars run the
+class org.apache.tuscany.samples.helloworldwsclient.HelloWorldClient
+
+<h3>Results</h3>
+
+
+<p>The sample when run should simply display to the standard
+ output:<br>
+
+
+ <code>Hello World</code></p>
+
+
+<h3>Code Overview</h3>
+
+
+The source files are physically organized as shown below:<br>
+
+
+<table style="text-align: left; width: 100%;" border="1" cellpadding="2"
cellspacing="2">
+
+
+ <tbody>
+
+
+ <tr>
+
+
+ <td>main<br>
+
+
+ +---java<br>
+
+
+ ¦ ¦
+ sca.module<br>
+
+
+ ¦ ¦<br>
+
+
+ ¦ +---org<br>
+
+
+ ¦
+ +---apache<br>
+
+
+
¦
+ +---tuscany<br>
+
+
+
¦
+ +---samples<br>
+¦
++---helloworldwsclient<br>
+¦
+HelloWorldClient.java<br>
+¦
+HelloWorldService.java<br>
+¦
+HelloWorldServiceComponentImpl.java<br>
+
+
+ ¦<br>
+
+
+ +---resources<br>
+
+
+ ¦
+ tuscany-model.config<br>
+
+
+ ¦<br>
+
+
+ +---wsdl<br>
+
+
+
+ helloworld.wsdl<br>
+
+
+ <br>
+
+
+ </td>
+
+
+ </tr>
+
+
+
+ </tbody>
+</table>
+
+
+<br>
+
+
+<br>
+
+
+<table style="text-align: left; width: 100%; height: 154px;" border="0"
cellpadding="2" cellspacing="2">
+
+
+ <tbody>
+
+
+ <tr>
+
+
+ <td style="vertical-align: top; height: 62px;">sca.module</td>
+
+
+ <td style="height: 62px;">Defines the SCA module,
+ externalService
+ and component. Defines for the
+ HelloWorldServiceComponent component and the Java class that
+ implements the component For the externalService it defines
WSDL for
+ the
+ service, the Java interface provided by the service.
+ The the HelloWorldServiceComponent is via a
+ referenced wired to the externalService</td>
+
+
+ </tr>
+
+
+ <tr>
+
+
+ <td style="vertical-align: top;">HelloWorldClient.java</td>
+
+
+ <td>Creates a Tuscany runtime and starts it.
+ Obtains the module context which was defined by the
+ sca.module file. From the module context locates the
+ HelloWorldServiceComponent and then calls the
getGreetings
+ method to invoke the component.</td>
+
+
+ </tr>
+
+
+ <tr>
+
+
+ <td style="vertical-align: top; height:
26px;">HelloWorldService.java</td>
+
+
+ <td style="height: 26px;">Defines the Java interface
+ implemented by the component.</td>
+
+
+ </tr>
+
+
+ <tr>
+
+
+ <td style="vertical-align:
top;">HelloWorldServiceComponentImpl.java</td>
+
+
+ <td>It does not directly implement the service; instead it
+ has an SCA reference that is wired in the sca.module to an
+ externalService that will provide the service. The service
providing the implementation is the <a href="../helloworldws/readme.htm"
target="_blank">helloworldws</a> sample.<br>
+
+
+ </td>
+
+
+ </tr>
+
+
+ <tr>
+
+
+ <td>tuscany-model.config</td>
+
+
+ <td>Maps the SCA Entry point WSDL to the physical WSDL file
+ location.</td>
+
+
+ </tr>
+
+
+ <tr>
+
+
+ <td>helloworld.wsdl</td>
+
+
+ <td>WSDL for the service.</td>
+
+
+ </tr>
+
+
+
+ </tbody>
+</table>
+
+
+</body>
+</html>
Added: incubator/tuscany/java/sca/samples/readme.htm
URL:
http://svn.apache.org/viewcvs/incubator/tuscany/java/sca/samples/readme.htm?rev=399815&view=auto
==============================================================================
--- incubator/tuscany/java/sca/samples/readme.htm (added)
+++ incubator/tuscany/java/sca/samples/readme.htm Thu May 4 11:46:37 2006
@@ -0,0 +1,116 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+
+<!-- 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.
-->
+ <meta content="text/html; charset=iso-8859-1" http-equiv="Content-Type">
+
+ <meta content="text/css" http-equiv="Content-Style-Type">
+ <title>Tuscany SCA Samples</title>
+
+
+<!-- LINK rel="stylesheet" href="ait.css" type="text/css" -->
+ <style type="text/css" media="all">
[EMAIL PROTECTED] url("../../css/maven-base.css");
[EMAIL PROTECTED] url("../../css/maven-theme.css");
[EMAIL PROTECTED] url("../../css/site.css");
+ </style>
+ <link rel="stylesheet" href="./css/print.css" type="text/css" media="print">
+
+</head>
+
+<body>
+
+<h2>Tuscany SCA Samples</h2>
+
+To configure see <a href="../../sampleSetup.htm">Sample
+setup</a><br>
+
+<br>
+
+<h3>Sample Summary</h3>
+
+<table style="text-align: left; width: 100%;" border="0" cellpadding="2"
cellspacing="2">
+
+ <caption style="text-decoration: underline;">Tuscany
+samples summary</caption><tbody>
+
+ <tr>
+
+ <td style="vertical-align: top; white-space: nowrap;"><a
href="helloworld/readme.htm" target="_blank">helloworld</a></td>
+
+ <td>Shows
+using the Tuscany SCA runtime in a J2SE environment loading a
+component.<br>
+
+ <br>
+
+ </td>
+
+ </tr>
+
+<!--
+<tr>
+<td style="vertical-align: top; white-space: nowrap;"><a
+href="helloworld/helloworldmc/readme.htm="
target="_blank">helloworldmc</a> </td>
+<td>This
+sample shows in a J2SE environment the wiring of multiple components
+and customizing components.<br>
+<br>
+</td>
+-->
+
+ <tr>
+
+ <td style="vertical-align: top; white-space: nowrap;"><a
href="helloworldweb/readme.htm" target="_blank">helloworldweb</a> </td>
+
+ <td>This
+sample shows in a J2EE environment using SCA components to handle HTML
+forms.<br>
+
+ <br>
+
+ </td>
+
+ </tr>
+
+ <tr>
+
+ <td style="vertical-align: top; white-space: nowrap;"><a
href="helloworldws/readme.htm" target="_blank">helloworldws</a> </td>
+
+ <td>Sample
+shows using the Tuscany SCA runtime in a Tomcat environment
+providing a
+web service <br>
+
+ <br>
+
+ </td>
+
+ </tr>
+
+ <tr>
+
+ <td style="vertical-align: top; white-space: nowrap;"><a
href="helloworldwsclient/readme.htm"
target="_blank">helloworldwsclient</a> </td>
+
+ <td>Sample
+shows using the Tuscany SCA runtime in a J2SE environment using a
+web service <br>
+
+ <br>
+
+ </td>
+
+ </tr>
+
+ </tbody>
+</table>
+
+<br>
+
+</body>
+</html>
