Author: rineholt
Date: Fri Mar 10 13:57:49 2006
New Revision: 384925
URL: http://svn.apache.org/viewcvs?rev=384925&view=rev
Log:
more docs
Added:
incubator/tuscany/java/samples/helloworld/helloworldaxis2/readme.htm
incubator/tuscany/java/samples/readme.htm
Added: incubator/tuscany/java/samples/helloworld/helloworldaxis2/readme.htm
URL:
http://svn.apache.org/viewcvs/incubator/tuscany/java/samples/helloworld/helloworldaxis2/readme.htm?rev=384925&view=auto
==============================================================================
--- incubator/tuscany/java/samples/helloworld/helloworldaxis2/readme.htm (added)
+++ incubator/tuscany/java/samples/helloworld/helloworldaxis2/readme.htm Fri
Mar 10 13:57:49 2006
@@ -0,0 +1,126 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<!--
+ 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><head>
+
+ <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 Axis</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 Axis</h2>
+
+<h3>Overview</h3>
+
+<p>The Tuscany hello world axis sample is not an SCA application.
+ This sample is a simple Apache Axis service. Starting from
+ a Java source using Axis's
+ java2wsdl to create a document literal WSDL. And then using
+ that WSDL in wsdl2java to create all the Axis service and client
+ artifacts. Details on this can be found reviewing the Axis
+ documentation.</p>
+
+<p>The original Java code to generate is simply:</p>
+
+<table style="text-align: left; width: 100%; height: 262px;" border="1"
cellpadding="2" cellspacing="2">
+
+ <tbody>
+
+ <tr>
+
+ <td style="width: 100%;">
+ <p>package org.apache.tuscany.samples.helloworldaxis;<br>
+
+ <br>
+
+ /**<br>
+
+ * <br>
+
+ */<br>
+
+ <br>
+
+ public interface HelloWorldService{<br>
+
+ public static final String DEFAULT_NAME=
+ "World";<br>
+
+ public String getGreetings(String
name);<br>
+
+ <br>
+
+ }<br>
+
+ </p>
+
+ </td>
+
+ </tr>
+
+ </tbody>
+</table>
+
+<p></p>
+
+<p>The purpose for it's inclusion in the samples is to
+ demonstrate the interoperability of Tuscany's web service
+ binding with another SOAP implementation.</p>
+
+<h3>Setup</h3>
+
+The following jars are required from the Maven repository in
+the classpath to run the sample client
+<pre style="margin-left:
40px;">helloworldaxis-SNAPSHOT.jar<br>axis-1.2.1.jar<br>axis-jaxrpc-1.2.1.jar
+
<br>axis-saaj-1.2.1.jar<br>axis-wsdl4j-1.5.1.jar<br>commons-discovery-0.2.jar<br>commons-logging-1.0.4.jar<br><br>
+</pre>
+
+See <a href="../helloworldws/readme.htm" target="_blank">helloworldws</a>
and <a
+ href="../helloworldaxissvc/readme.htm"
target="_blank">helloworldaxissvc</a> samples for the server side service
+setup instructions.<br>
+
+<h3>Running.<br></h3>Using JDK 1.5 java command with the previous jars run the
class
+org.apache.tuscany.samples.helloworldaxis.HelloWorldAxisClient<br>Optional
arguments: <br> <br>
+
+<div style="margin-left: 40px;"> Run against sample Tuscany SCA service:
<span style="font-style: italic;">(default no arguments)</span>
+ <br>
<code>http://localhost:8080/helloworldws-SNAPSHOT/services/HelloWorldService
+ World</code><br> Run against sample Axis Service:<br>
<code>
+ http://localhost:8080/helloworldaxissvc-SNAPSHOT/services/helloworld
World</code><br></div>
+
+<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>
+
+More detailed information about Axis web services can be found on the
+Apache Axis website.<br>
+
+</body></html>
Added: incubator/tuscany/java/samples/readme.htm
URL:
http://svn.apache.org/viewcvs/incubator/tuscany/java/samples/readme.htm?rev=384925&view=auto
==============================================================================
--- incubator/tuscany/java/samples/readme.htm (added)
+++ incubator/tuscany/java/samples/readme.htm Fri Mar 10 13:57:49 2006
@@ -0,0 +1,98 @@
+<!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">
[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 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;">sca-api-SNAPSHOT.jar<br>sdo-api-SNAPSHOT.jar<br>tuscany-common-SNAPSHOT.jar<br>tuscany-core-SNAPSHOT.jar<br>tuscany-model-SNAPSHOT.jar<br>tuscany-container-java-SNAPSHOT.jar<br>tuscany-sdo-impl-SNAPSHOT.jar<br>axis-wsdl4j-1.2.jar<br>asm-2.2.jar<br>common-2.2.0-I200602160000.jar<br>ecore-2.2.0-I200602160000.jar<br>ecore-change-2.2.0-I200602160000.jar<br>ecore-xmi-2.2.0-I200602160000.jar<br>xsd-2.2.0-I200602160000.jar</pre></td></tr></tbody></table><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;">tuscany-binding-axis2-SNAPSHOT.jar<br>axis2-core-0.94.jar<br>commons-codec-1.3.jar<br>commons-httpclient-3.0.jar<br>commons-logging-1.0.4.jar<br>log4j-1.2.12.jar<br>stax-api-1.0.jar<br>ws-policy-SNAPSHOT.jar<br>wstx-asl-2.8.2.jar</pre></td></tr></tbody></table><br><br><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 the the<a href="../acceptance/readme.htm"
target="_blank">
+Tuscany acceptance tests</a> 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-i200602160000.jarecore-2.2.0-i200602160000.jar<br>ecore-change-2.2.0-i200602160000.jar<br>ecore-xmi-2.2.0-i200602160000.jar<br>sca-api-snapshot.jar<br>sdo-api-snapshot.jar<br>tuscany-sdo-impl-snapshot.jar<br>xsd-2.2.0-i200602160000.jar</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>axis-wsdl4j-1.2.jar<br>axis2-core-0.94.jar<br>commons-codec-1.3.jar<br>commons-httpclient-3.0.jar<br>commons-logging-1.0.4.jar<br>log4j-1.2.12.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-tomcat-snapshot.jar<br>ws-policy-snapshot.jar<br>wstx-asl-2.8.2.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
