diff options
Diffstat (limited to 'branches/java-M1/java/samples/sca/helloworldweb/readme.htm')
-rw-r--r-- | branches/java-M1/java/samples/sca/helloworldweb/readme.htm | 248 |
1 files changed, 248 insertions, 0 deletions
diff --git a/branches/java-M1/java/samples/sca/helloworldweb/readme.htm b/branches/java-M1/java/samples/sca/helloworldweb/readme.htm new file mode 100644 index 0000000000..037b1d70f8 --- /dev/null +++ b/branches/java-M1/java/samples/sca/helloworldweb/readme.htm @@ -0,0 +1,248 @@ +<!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">
+@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"><!-- 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>Location</h3>
+This sample is located in the samples\sca\helloworldweb directory.
+
+
+
+<h3>Setup</h3>
+
+Set up your server as described in the <a href="../../../GettingStarted.htm" target="_blank">Tomcat Setup</a>.
+
+If you are not using the pre-configured Tomcat server from the binary distribution, you will need to add <span style="font-weight: bold;">sample-helloworldweb-incubating-M1.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/sample-helloworldweb/" target="_blank">http://localhost:8080/sample-helloworldweb/</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>src<br>+---main<br> +---java<br> ¦ +---helloworld<br> ¦ HelloWorldImpl.java<br> ¦ HelloWorldService.java<br> ¦<br> +---resources<br> ¦ sca.module<br> ¦<br> +---webapp<br> ¦ HelloWorldWeb.jsp<br> ¦<br> ¦<br> +---WEB-INF<br> web.xml<br><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;">HelloWorldImpl.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>
|