Author: rineholt
Date: Mon Oct 23 10:20:34 2006
New Revision: 467035
URL: http://svn.apache.org/viewvc?view=rev&rev=467035
Log:
doco
Modified:
incubator/tuscany/branches/sca-java-M2/samples/applications/bigbank/readme.htm
Modified:
incubator/tuscany/branches/sca-java-M2/samples/applications/bigbank/readme.htm
URL:
http://svn.apache.org/viewvc/incubator/tuscany/branches/sca-java-M2/samples/applications/bigbank/readme.htm?view=diff&rev=467035&r1=467034&r2=467035
==============================================================================
---
incubator/tuscany/branches/sca-java-M2/samples/applications/bigbank/readme.htm
(original)
+++
incubator/tuscany/branches/sca-java-M2/samples/applications/bigbank/readme.htm
Mon Oct 23 10:20:34 2006
@@ -1,637 +1,688 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
-
-<html>
-<head>
- <meta content=
- "HTML Tidy for Windows (vers 1st July 2004), see www.w3.org"
- name="generator">
- <!-- * Licensed to the Apache Software Foundation (ASF) under one * or more
contributor license agreements. See the NOTICE file * distributed with this
work for additional information * regarding copyright ownership. The ASF
licenses this file * to you 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. --><!-- 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 w
ith 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. -->
-
-<script type="text/javascript">
-function expandImage(img,height,width) {
-window.open(img,"Image","menubar=no,resizable=no,status=no,toolbar=no,location=no,height="
+ height + ",width=" + width);
-}
-function goURL(url) {
-window.location = url;
-}
-</script>
- <meta http-equiv="Content-Type" content=
- "text/html; charset=us-ascii">
- <meta http-equiv="Content-Style-Type" content="text/css">
-
- <title>Tuscany BigBank Sample Application</title>
-<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>
- <!-- LINK rel="stylesheet" href="ait.css" type="text/css" -->
- <!-- maven --><!-- end maven -->
-
- <h2>Tuscany BigBank Sample Application</h2>
-
- <h3>Overview</h3>
-
- <p>The Tuscany BigBank sample application shows using
- the Tuscany SCA runtime to build a financial application.
- There are two modules: webclient provides the front-end user
- interface and account provides the back-end business services.
- These are deployed as separate web applications</p>
-
- <h3>Location</h3>This sample is located in the
- <a href=".">sampleapps\bigbank</a> directory. There are two
- subdirectories in that for the two modules <a href="account"
- target="_blank">account</a> and <a href="webclient" target=
- "_blank">webclient.</a>
-
- <h3>Setup</h3>If you have enabled remote deployment in Tomcat by
- adding the line:<br>
- <code> <user username="admin" password=""
- roles="manager"/></code><br>
- into <span style="font-style: italic;"><tomcat
- dir></span>\conf\tomcat-users.xml you can deploy the
- WARs to Tomcat using the tomcat-maven-plugin:<br>
- <code>mvn tomcat:deploy</code><br>
- <br>
- Alternatively you can copy the WAR files to Tomcat's
- webapps directory.<br>
- copy account/target/sample-bigbank-account.war <span style=
- "font-style: italic;"><tomcat dir></span>/webapps/.<br>
- copy
- webclient/target/sample-bigbank-webclient.war <span style=
- "font-style: italic;"><tomcat dir></span>/webapps/.<br>
- <br>
-
- <h3>Running</h3>Once you've started your web server, use your web
- browser to view the following URL <a href=
- "http://localhost:8080/sample-bigbank-webclient/"; target=
- "_blank">http://localhost:8080/sample-bigbank-webclient/</a><br>
- You can either use an already pre configured account with
- <span style="font-weight: bold;">Login</span> as <span style=
- "color: rgb(204, 0, 0); font-weight: bold;">test</span> and
- <span style="font-weight: bold;">Password</span> as <span style=
- "color: rgb(204, 0, 0); font-weight: bold;">password,</span> or
- you can create a new account.<br>
- The demo is first configured to use a local mock stock quote
- service that returns random stock data. If you want to use
- an actual stock quote provider follow these steps:<br>
-
- <ul>
- <li>Stop your server by issuing in the <span style=
- "font-style: italic;"><tomcat dir></span><span style=
- "font-weight: bold;">\bin</span> directory</li>
-
- <li>Issue <span style="font-weight: bold;">shutdown</span>
- command to stop your web application server<span style=
- "font-weight: bold;">.</span></li>
-
- <li>Edit the account SCDL file <span style=
- "font-style: italic;"><tomcat dir></span><span style=
- "font-weight:
bold;">\webapps\sample-bigbank-account\WEB-INF\default.scdl</span></li>
-
- <li>Change the SCDL wiring to remove the mock stock quote
- service by commenting it out as follows:<br>
- <!--<br>
- <component
- name="StockQuoteServiceComponent"><br>
-
- <implementation.java
- class="bigbank.account.services.stockquote.StockQuoteServiceImpl"
- /><br>
- </component><br>
- --></li>
-
- <li>Uncomment the real stockquote service section in lines 68
- to 80.<br></li>
-
- <li>Change to the directory <span style=
- "font-weight: bold;">apache-tomcat-5.5.17\bin </span></li>
-
- <li>issue <span style="font-weight: bold;">startup
- </span> command to start up the serverin the <span style=
- "font-style: italic;"><tomcat dir></span>\bin
- directory<span style="font-weight: bold;">.</span></li>
- </ul>The sample should now be using the real stock quote
- provider. <br>
-
- <h3>Introduction</h3>This example illustrates using Tuscany
- runtime in building a financial application using SCA
- programing model. The following key concepts are covered:
-
- <ul>
- <li><b><i>Component implementations</i></b>. that provide web
- based HTML user interface</li>
-
- <li><b><i>Component implementations</i></b> that provide
- <b><i>local services</i></b> in Java. Local services implement
- internal application business logic such as tracking user state
- and are not exposed remotely.</li>
-
- <li><b><i>Component implementations</i></b> that have
- <b><i>configuration properties</i></b> and <b><i>service
- references</i></b> to other services</li>
-
- <li><b><i>Components</i></b> that use and
- <b><i>configure</i></b> <b><i>the properties and
- references</i></b> of component implementations</li>
-
- <li><b><i>SCA Services</i></b> to publish remotable services
- via a <b><i>Web Service binding</i></b>.</li>
-
- <li><b><i>SCA References </i></b> to consume remotable
- services via a <b><i>Web Service binding</i></b></li>
-
- <li>Assembling implementation, components, entry points and
- external service into composite components.</li>
-
- <li>Creating a module and all of its artifacts as part of a
- <b><i>web application</i></b> to show a front-end access to SCA
- services</li>
-
- <li>The use of Data Access services to persist and retrieve
- Service Data Objects from Apache Derby.</li>
-
- <li style="text-align: left;">The use of existing Web
- services in SCA.</li>
- </ul>BigBank sample provides the following user services: account
- balance, making deposits and withdrawals to purchase
- and sell stock, and to view current stock value.<br>
- The sample is organized into two SCA modules: webclient and
- account. The webclient module functionality is to provide user
- information and obtain user input. The account module is used to
- retrieve and store user information, account information, current
- stock information and the purchasing and selling of stock. The
- two modules interact via web services through SCA references and
- services.<br>
- <br>
-
- <div style="text-align: center;">
- <img style="width: 381px; height: 169px;" alt=
- "Overview of modules." title="Overview of modules." src=
- "docs/modualoverview.png" align="middle">
-
- <h4>Webclient</h4><br>
-
- <table style="text-align: left; width: 100%;" border="0"
- cellpadding="1" cellspacing="0" width="100%">
- <tbody>
- <tr>
- <td align="left" valign="top" width="*">
- <a href=
-
"javascript:expandImage('docs/Show.Image.html?url=webclientfiles.png',800,500)">
- <img style="width: 262px; height: 360px;" alt=
- "Webclient files" title="Click to expand" src=
- "docs/webclientfiles.png"></a> <br>
-
- <div style="text-align: center;">
- <small><span style="font-style: italic;">click to
- enlarge</span></small>
- </div>
- </td>
-
- <td style="text-align: left;" align="left" valign="top"
- width="80%">
- <table style="text-align: left; width: 100%;" border=
- "0" cellpadding="1" cellspacing="0">
- <tbody>
- <tr>
- <td style="text-align: center;" colspan="3">
- <span style=
- "font-weight: bold; text-decoration: underline;">Java
- source files implementing SCA components and
- interfaces.</span></td>
- </tr>
-
- <tr>
- <td style="width: 10%;">
- AccountServiceComponentImpl.java</td>
-
- <td> </td>
-
- <td>Implements the account service.</td>
- </tr>
-
- <tr>
- <td>AccountLoginServiceImpl.java</td>
-
- <td></td>
-
- <td>Implements the Logiin service.</td>
- </tr>
-
- <tr>
- <td>LoginService.java</td>
-
- <td></td>
-
- <td>Interface for a services provided by a
- login service component.</td>
- </tr>
-
- <tr>
- <td>ProfileService.java</td>
-
- <td></td>
-
- <td>Interface for a service provided by a profile
- component.</td>
- </tr>
-
- <tr>
- <td>ProfileServiceImpl.java</td>
-
- <td></td>
-
- <td>Implements the profile component.</td>
- </tr>
-
- <tr>
- <td>SimpleLoginServiceImpl.java</td>
-
- <td></td>
-
- <td>A simple in memory login service.</td>
- </tr>
-
- <tr>
- <td style="text-align: center;" colspan="3">
- <span style=
- "font-weight: bold; text-decoration: underline;">Java
- source files implementing Web HTML
- interface.</span></td>
- </tr>
-
- <tr>
- <td>AccountStatusTag.java</td>
-
- <td></td>
-
- <td>Implements a jsp tag that displays the
- account information</td>
- </tr>
-
- <tr>
- <td>StockStatusTag.java</td>
-
- <td></td>
-
- <td>Implements a jsp tag that displays the stock
- information.</td>
- </tr>
-
- <tr>
- <td>LoginBarrierTag.java</td>
-
- <td></td>
-
- <td>Implements a jsp tag that ensures the user is
- logged in.</td>
- </tr>
-
- <tr>
- <td>ServiceTag.java</td>
-
- <td></td>
-
- <td>Places an SCA service in the JSP page
- context.</td>
- </tr>
-
- <tr>
- <td>FormServlet.java</td>
-
- <td></td>
-
- <td>Process user input and uses the
- AccountService component.</td>
- </tr>
-
- <tr>
- <td>LoginServlet.java</td>
-
- <td></td>
-
- <td>Processes logging in and logout.</td>
- </tr>
-
- <tr>
- <td style="text-align: center;" colspan="3">
- <span style=
- "font-weight: bold; text-decoration: underline;">Files
- that will be loaded as resources along
- classpath.</span></td>
- </tr>
-
- <tr>
- <td>AccountService.wsdl</td>
-
- <td></td>
-
- <td>WSDL that defines the account
- service.</td>
- </tr>
-
- <tr>
- <td>bigbank-tags.tld</td>
-
- <td></td>
-
- <td>Defines the tag libs for the user
- interface.</td>
- </tr>
-
- <tr align="center">
- <td colspan="3"><span style=
- "font-weight: bold; text-decoration: underline;">Files
- located in WEB-INF directory.</span></td>
- </tr>
-
- <tr>
- <td>default.scdl</td>
-
- <td></td>
-
- <td>Application's SCA SCDL file.</td>
- </tr>
-
- <tr>
- <td>web.xml</td>
-
- <td></td>
-
- <td>Application's web.xml file.</td>
- </tr>
-
- <tr align="center">
- <td colspan="3"><span style=
- "font-weight: bold; text-decoration: underline;">Generated
- Files.</span></td>
- </tr>
-
- <tr>
- <td>sdo source</td>
-
- <td></td>
-
- <td>Generated SDO. Created by tuscany-sdo-plugin
- maven plugin.</td>
- </tr>
-
- <tr>
- <td>wsdl2java-source</td>
-
- <td></td>
-
- <td>Generated SDO interface. Created by
- tuscany-plugin-wsdl2java maven plugin.</td>
- </tr>
-
- <tr align="center">
- <td colspan="3"><span style=
- "font-weight: bold; text-decoration: underline;">Build
- files.</span></td>
- </tr>
-
- <tr>
- <td>pom.xml</td>
-
- <td></td>
-
- <td>Maven build file.</td>
- </tr>
- </tbody>
- </table>
- </td>
- </tr>
- </tbody>
- </table>
-
- <p> </p><!-- account -->
-
- <h4>Account</h4>
-
- <table style="text-align: left; width: 100%;" border="0"
- cellpadding="1" cellspacing="0" width="100%">
- <tbody>
- <tr>
- <td align="left" valign="top" width="*">
- <a href=
-
"javascript:expandImage('docs/Show.Image.html?url=accountfiles.png',550,500)">
- <img style="width: 262px; height: 360px;" alt=
- "Webclient files" title="Click to expand" src=
- "docs/accountfiles.png"></a> <br>
-
- <div style="text-align: center;">
- <small><span style="font-style: italic;">click to
- enlarge</span></small>
- </div>
- </td>
-
- <td style="text-align: left;" align="left" valign="top"
- width="80%">
- <table style="text-align: left; width: 100%;" border=
- "0" cellpadding="1" cellspacing="0">
- <tbody>
- <tr>
- <td style="text-align: center;" colspan="3">
- <span style=
- "font-weight: bold; text-decoration: underline;">Java
- source files implementing SCA components and
- interfaces.</span></td>
- </tr>
-
- <tr>
- <td style="width: 10%;">
- AccountServiceImpl.java</td>
-
- <td> </td>
-
- <td>Implements the account service
- component.</td>
- </tr>
-
- <tr>
- <td>AccountDataService.java</td>
-
- <td></td>
-
- <td>Interface defined for component implementing
- an account's data service.</td>
- </tr>
-
- <tr>
- <td>AccountDataServiceDASImpl.java</td>
-
- <td></td>
-
- <td>A Data Access Service (DAS) implementation of
- of the Account Data Service.</td>
- </tr>
-
- <tr>
- <td>AccountDataServiceImpl.java</td>
-
- <td></td>
-
- <td>A Data Service implementation not using
- DAS.</td>
- </tr>
-
- <tr>
- <td>AccountDBInit.java</td>
-
- <td></td>
-
- <td>A utility to just create the database and it
- table and fill in some initial data.</td>
- </tr>
-
- <tr>
- <td>StockQuote.java</td>
-
- <td></td>
-
- <td>A class to hold the StockQuote
- information.</td>
- </tr>
-
- <tr>
- <td>StockQuoteService.java</td>
-
- <td></td>
-
- <td>Interface defined for a component
- implementing a stock quote service.</td>
- </tr>
-
- <tr>
- <td>StockQuoteServiceImpl.java</td>
-
- <td></td>
-
- <td>Implements a fake stock quote service.</td>
- </tr>
-
- <tr>
- <td>StockQuoteWebservicexServiceImpl.java</td>
-
- <td></td>
-
- <td>Implements an actual stock quote
- service.</td>
- </tr>
-
- <tr>
- <td style="text-align: center;" colspan="3">
- <span style=
- "font-weight: bold; text-decoration: underline;">Files
- that will be loaded as resources along
- classpath.</span></td>
- </tr>
-
- <tr>
- <td>AccountService.wsdl</td>
-
- <td></td>
-
- <td>WSDL that defines the account
- service</td>
- </tr>
-
- <tr>
- <td>stockquotes.webservicex.wsdl</td>
-
- <td></td>
-
- <td>Actual stock quote service.</td>
- </tr>
-
- <tr>
- <td>DasAccountConfiguration.xml</td>
-
- <td></td>
-
- <td>Provides any needed configuration info
- including datasource properties, table
- definitions,</td>
- </tr>
-
- <tr align="center">
- <td colspan="3"><span style=
- "font-weight: bold; text-decoration: underline;">Files
- located in WEB-INF directory.</span></td>
- </tr>
-
- <tr>
- <td>default.scdl</td>
-
- <td></td>
-
- <td>Application's SCA SCDL file.</td>
- </tr>
-
- <tr>
- <td>web.xml</td>
-
- <td></td>
-
- <td>Application's web.xml file.</td>
- </tr>
-
- <tr align="center">
- <td colspan="3"><span style=
- "font-weight: bold; text-decoration: underline;">Generated
- Files.</span></td>
- </tr>
-
- <tr>
- <td>sdo source</td>
-
- <td></td>
-
- <td>Generated SDO. Created by tuscany-sdo-plugin
- maven plugin.</td>
- </tr>
-
- <tr>
- <td>wsdl2java-source</td>
-
- <td></td>
-
- <td>Generated SDO interface. Created by
- tuscany-plugin-wsdl2java maven plugin.</td>
- </tr>
-
- <tr align="center">
- <td colspan="3"><span style=
- "font-weight: bold; text-decoration: underline;">Build
- files.</span></td>
- </tr>
-
- <tr>
- <td>pom.xml</td>
-
- <td></td>
-
- <td>Maven build file.</td>
- </tr>
- </tbody>
- </table>
- </td>
- </tr>
- </tbody>
- </table>
- </div><br>
- <br>
-
- <h3>Building</h3>This sample can be built from the bigbank
- directory using Maven 2.0.4:<br>
- <code> mvn package</code><br>
- <br>
-</body>
-</html>
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+
+<html>
+<head>
+ <meta content=
+ "HTML Tidy for Windows (vers 1st July 2004), see www.w3.org"
+ name="generator">
+ <!-- * Licensed to the Apache Software Foundation (ASF) under one * or more
contributor license agreements. See the NOTICE file * distributed with this
work for additional information * regarding copyright ownership. The ASF
licenses this file * to you 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. --><!-- 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 w
ith 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. -->
+
+<script type="text/javascript">
+function expandImage(img,height,width) {
+window.open(img,"Image","menubar=no,resizable=no,status=no,toolbar=no,location=no,height="
+ height + ",width=" + width);
+}
+function goURL(url) {
+window.location = url;
+}
+</script>
+ <meta http-equiv="Content-Type" content=
+ "text/html; charset=us-ascii">
+ <meta http-equiv="Content-Style-Type" content="text/css">
+
+ <title>Tuscany BigBank Sample Application</title>
+<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>
+ <!-- LINK rel="stylesheet" href="ait.css" type="text/css" -->
+ <!-- maven --><!-- end maven -->
+
+ <h2>Tuscany BigBank Sample Application</h2>
+
+ <h3>Overview</h3>
+
+ <p>The Tuscany BigBank sample application shows using
+ the Tuscany SCA runtime to build a financial application.
+ There are two modules: webclient provides the front-end user
+ interface and account provides the back-end business services.
+ These are deployed as separate web applications</p>
+
+ <h3>Location</h3>This sample is located in the
+ <a href=".">sampleapps\bigbank</a> directory. There are two
+ subdirectories in that for the two modules <a href="account"
+ target="_blank">account</a> and <a href="webclient" target=
+ "_blank">webclient.</a>
+
+ <h3>Setup</h3>If you have enabled remote deployment in Tomcat by
+ adding the line:<br>
+ <code> <user username="admin" password=""
+ roles="manager"/></code><br>
+ into <span style="font-style: italic;"><tomcat
+ dir></span>\conf\tomcat-users.xml you can deploy the
+ WARs to Tomcat using the tomcat-maven-plugin:<br>
+ <code>mvn tomcat:deploy</code><br>
+ <br>
+ Alternatively you can copy the WAR files to Tomcat's
+ webapps directory.<br>
+ copy account/target/sample-bigbank-account.war <span style=
+ "font-style: italic;"><tomcat dir></span>/webapps/.<br>
+ copy
+ webclient/target/sample-bigbank-webclient.war <span style=
+ "font-style: italic;"><tomcat dir></span>/webapps/.<br>
+ <br>
+
+ <h3>Running</h3>Once you've started your web server, use your web
+ browser to view the following URL <a href=
+ "http://localhost:8080/sample-bigbank-webclient/"; target=
+ "_blank">http://localhost:8080/sample-bigbank-webclient/</a><br>
+ You can either use an already pre configured account with
+ <span style="font-weight: bold;">Login</span> as <span style=
+ "color: rgb(204, 0, 0); font-weight: bold;">test</span> and
+ <span style="font-weight: bold;">Password</span> as <span style=
+ "color: rgb(204, 0, 0); font-weight: bold;">password,</span> or
+ you can create a new account.<br>
+ The demo is first configured to use a local mock stock quote
+ service that returns random stock data. If you want to use
+ an actual stock quote provider follow these steps:<br>
+
+ <ul>
+ <li>Stop your server by issuing in the <span style=
+ "font-style: italic;"><tomcat dir></span><span style=
+ "font-weight: bold;">\bin</span> directory</li>
+
+ <li>Issue <span style="font-weight: bold;">shutdown</span>
+ command to stop your web application server<span style=
+ "font-weight: bold;">.</span></li>
+
+ <li>Edit the account SCDL file <span style=
+ "font-style: italic;"><tomcat dir></span><span style=
+ "font-weight:
bold;">\webapps\sample-bigbank-account\WEB-INF\default.scdl</span></li>
+
+ <li>Change the SCDL wiring to remove the mock stock quote
+ service by commenting it out as follows:<br>
+ <!--<br>
+ <component
+ name="StockQuoteServiceComponent"><br>
+
+ <implementation.java
+ class="bigbank.account.services.stockquote.StockQuoteServiceImpl"
+ /><br>
+ </component><br>
+ --></li>
+
+ <li>Uncomment the real stockquote service section in lines 68
+ to 80.<br></li>
+
+ <li>Change to the directory <span style=
+ "font-weight: bold;">apache-tomcat-5.5.17\bin </span></li>
+
+ <li>issue <span style="font-weight: bold;">startup
+ </span> command to start up the serverin the <span style=
+ "font-style: italic;"><tomcat dir></span>\bin
+ directory<span style="font-weight: bold;">.</span></li>
+ </ul>The sample should now be using the real stock quote
+ provider. <br>
+
+ <h3>Introduction</h3>This example illustrates using Tuscany
+ runtime in building a financial application using SCA
+ programing model. The following key concepts are covered:
+
+ <ul>
+ <li><b><i>Component implementations</i></b>. that provide web
+ based HTML user interface</li>
+
+ <li><b><i>Component implementations</i></b> that provide
+ <b><i>local services</i></b> in Java. Local services implement
+ internal application business logic such as tracking user state
+ and are not exposed remotely.</li>
+
+ <li><b><i>Component implementations</i></b> that have
+ <b><i>configuration properties</i></b> and <b><i>service
+ references</i></b> to other services</li>
+
+ <li><b><i>Components</i></b> that use and
+ <b><i>configure</i></b> <b><i>the properties and
+ references</i></b> of component implementations</li>
+
+ <li><b><i>SCA Services</i></b> to publish remotable services
+ via a <b><i>Web Service binding</i></b>.</li>
+
+ <li><b><i>SCA References </i></b> to consume remotable
+ services via a <b><i>Web Service binding</i></b></li>
+
+ <li>Assembling implementation, components, entry points and
+ external service into composite components.</li>
+
+ <li>Creating a module and all of its artifacts as part of a
+ <b><i>web application</i></b> to show a front-end access to SCA
+ services</li>
+
+ <li>The use of Data Access services to persist and retrieve
+ Service Data Objects from Apache Derby.</li>
+
+ <li style="text-align: left;">The use of existing Web
+ services in SCA.</li>
+ </ul>BigBank sample provides the following user services: account
+ balance, making deposits and withdrawals to purchase
+ and sell stock, and to view current stock value.<br>
+ The sample is organized into two SCA modules: webclient and
+ account. The webclient module functionality is to provide user
+ information and obtain user input. The account module is used to
+ retrieve and store user information, account information, current
+ stock information and the purchasing and selling of stock. The
+ two modules interact via web services through SCA references and
+ services.<br>
+ <br>
+
+ <div style="text-align: center;">
+ <img style="width: 381px; height: 169px;" alt=
+ "Overview of modules." title="Overview of modules." src=
+ "docs/modualoverview.png" align="middle">
+
+ <h4>Webclient</h4><br>
+
+ <table style="text-align: left; width: 100%;" border="0"
+ cellpadding="1" cellspacing="0" width="100%">
+ <tbody>
+ <tr>
+ <td align="left" valign="top" width="*">
+ <a href=
+
"javascript:expandImage('docs/Show.Image.html?url=webclientfiles.png',800,500)">
+ <img style="width: 262px; height: 360px;" alt=
+ "Webclient files" title="Click to expand" src=
+ "docs/webclientfiles.png"></a> <br>
+
+ <div style="text-align: center;">
+ <small><span style="font-style: italic;">click to
+ enlarge</span></small>
+ </div>
+ </td>
+
+ <td style="text-align: left;" align="left" valign="top"
+ width="80%">
+ <table style="text-align: left; width: 100%;" border=
+ "0" cellpadding="1" cellspacing="0">
+ <tbody>
+ <tr>
+ <td style="text-align: center;" colspan="3">
+ <span style=
+ "font-weight: bold; text-decoration: underline;">Java
+ source files implementing SCA components and
+ interfaces.</span></td>
+ </tr>
+
+ <tr>
+ <td style="width: 10%;">
+ AccountServiceComponentImpl.java</td>
+
+ <td> </td>
+
+ <td>Implements the account service.</td>
+ </tr>
+
+ <tr>
+ <td>AccountLoginServiceImpl.java</td>
+
+ <td></td>
+
+ <td>Implements the Logiin service.</td>
+ </tr>
+
+ <tr>
+ <td>LoginService.java</td>
+
+ <td></td>
+
+ <td>Interface for a services provided by a
+ login service component.</td>
+ </tr>
+
+ <tr>
+ <td>ProfileService.java</td>
+
+ <td></td>
+
+ <td>Interface for a service provided by a profile
+ component.</td>
+ </tr>
+
+ <tr>
+ <td>ProfileServiceImpl.java</td>
+
+ <td></td>
+
+ <td>Implements the profile component.</td>
+ </tr>
+
+ <tr>
+ <td>SimpleLoginServiceImpl.java</td>
+
+ <td></td>
+
+ <td>A simple in memory login service.</td>
+ </tr>
+
+ <tr>
+ <td style="text-align: center;" colspan="3">
+ <span style=
+ "font-weight: bold; text-decoration: underline;">Java
+ source files implementing Web HTML
+ interface.</span></td>
+ </tr>
+
+ <tr>
+ <td>AccountStatusTag.java</td>
+
+ <td></td>
+
+ <td>Implements a jsp tag that displays the
+ account information</td>
+ </tr>
+
+ <tr>
+ <td>StockStatusTag.java</td>
+
+ <td></td>
+
+ <td>Implements a jsp tag that displays the stock
+ information.</td>
+ </tr>
+
+ <tr>
+ <td>LoginBarrierTag.java</td>
+
+ <td></td>
+
+ <td>Implements a jsp tag that ensures the user is
+ logged in.</td>
+ </tr>
+
+ <tr>
+ <td>ServiceTag.java</td>
+
+ <td></td>
+
+ <td>Places an SCA service in the JSP page
+ context.</td>
+ </tr>
+
+ <tr>
+ <td>FormServlet.java</td>
+
+ <td></td>
+
+ <td>Process user input and uses the
+ AccountService component.</td>
+ </tr>
+
+ <tr>
+ <td>LoginServlet.java</td>
+
+ <td></td>
+
+ <td>Processes logging in and logout.</td>
+ </tr>
+
+ <tr>
+ <td style="text-align: center;" colspan="3">
+ <span style=
+ "font-weight: bold; text-decoration: underline;">Files
+ that will be loaded as resources along
+ classpath.</span></td>
+ </tr>
+
+ <tr>
+ <td>AccountService.wsdl</td>
+
+ <td></td>
+
+ <td>WSDL that defines the account
+ service.</td>
+ </tr>
+
+ <tr>
+ <td>bigbank-tags.tld</td>
+
+ <td></td>
+
+ <td>Defines the tag libs for the user
+ interface.</td>
+ </tr>
+
+ <tr align="center">
+ <td colspan="3"><span style=
+ "font-weight: bold; text-decoration: underline;">Files
+ located in WEB-INF directory.</span></td>
+ </tr>
+
+ <tr>
+ <td>default.scdl</td>
+
+ <td></td>
+
+ <td>Application's SCA SCDL file.</td>
+ </tr>
+
+ <tr>
+ <td>web.xml</td>
+
+ <td></td>
+
+ <td>Application's web.xml file.</td>
+ </tr>
+
+ <tr align="center">
+ <td colspan="3"><span style=
+ "font-weight: bold; text-decoration: underline;">Generated
+ Files.</span></td>
+ </tr>
+
+ <tr>
+ <td>sdo source</td>
+
+ <td></td>
+
+ <td>Generated SDO. Created by tuscany-sdo-plugin
+ maven plugin.</td>
+ </tr>
+
+ <tr>
+ <td>wsdl2java-source</td>
+
+ <td></td>
+
+ <td>Generated SDO interface. Created by
+ tuscany-plugin-wsdl2java maven plugin.</td>
+ </tr>
+
+ <tr align="center">
+ <td colspan="3"><span style=
+ "font-weight: bold; text-decoration: underline;">Build
+ files.</span></td>
+ </tr>
+
+ <tr>
+ <td><a href="#Building">pom.xml</a></td>
+
+ <td></td>
+
+ <td>Maven build file.</td>
+ </tr>
+ </tbody>
+ </table>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+
+ <p> </p><!-- account -->
+
+ <h4>Account</h4>
+
+ <table style="text-align: left; width: 100%;" border="0"
+ cellpadding="1" cellspacing="0" width="100%">
+ <tbody>
+ <tr>
+ <td align="left" valign="top" width="*">
+ <a href=
+
"javascript:expandImage('docs/Show.Image.html?url=accountfiles.png',550,500)">
+ <img style="width: 262px; height: 360px;" alt=
+ "Webclient files" title="Click to expand" src=
+ "docs/accountfiles.png"></a> <br>
+
+ <div style="text-align: center;">
+ <small><span style="font-style: italic;">click to
+ enlarge</span></small>
+ </div>
+ </td>
+
+ <td style="text-align: left;" align="left" valign="top"
+ width="80%">
+ <table style="text-align: left; width: 100%;" border=
+ "0" cellpadding="1" cellspacing="0">
+ <tbody>
+ <tr>
+ <td style="text-align: center;" colspan="3">
+ <span style=
+ "font-weight: bold; text-decoration: underline;">Java
+ source files implementing SCA components and
+ interfaces.</span></td>
+ </tr>
+
+ <tr>
+ <td style="width: 10%;">
+ AccountServiceImpl.java</td>
+
+ <td> </td>
+
+ <td>Implements the account service
+ component.</td>
+ </tr>
+
+ <tr>
+ <td>AccountDataService.java</td>
+
+ <td></td>
+
+ <td>Interface defined for component implementing
+ an account's data service.</td>
+ </tr>
+
+ <tr>
+ <td>AccountDataServiceDASImpl.java</td>
+
+ <td></td>
+
+ <td>A Data Access Service (DAS) implementation of
+ of the Account Data Service.</td>
+ </tr>
+
+ <tr>
+ <td>AccountDataServiceImpl.java</td>
+
+ <td></td>
+
+ <td>A Data Service implementation not using
+ DAS.</td>
+ </tr>
+
+ <tr>
+ <td>AccountDBInit.java</td>
+
+ <td></td>
+
+ <td>A utility to just create the database and it
+ table and fill in some initial data.</td>
+ </tr>
+
+ <tr>
+ <td>StockQuote.java</td>
+
+ <td></td>
+
+ <td>A class to hold the StockQuote
+ information.</td>
+ </tr>
+
+ <tr>
+ <td>StockQuoteService.java</td>
+
+ <td></td>
+
+ <td>Interface defined for a component
+ implementing a stock quote service.</td>
+ </tr>
+
+ <tr>
+ <td>StockQuoteServiceImpl.java</td>
+
+ <td></td>
+
+ <td>Implements a fake stock quote service.</td>
+ </tr>
+
+ <tr>
+ <td>StockQuoteWebservicexServiceImpl.java</td>
+
+ <td></td>
+
+ <td>Implements an actual stock quote
+ service.</td>
+ </tr>
+
+ <tr>
+ <td style="text-align: center;" colspan="3">
+ <span style=
+ "font-weight: bold; text-decoration: underline;">Files
+ that will be loaded as resources along
+ classpath.</span></td>
+ </tr>
+
+ <tr>
+ <td>AccountService.wsdl</td>
+
+ <td></td>
+
+ <td>WSDL that defines the account
+ service</td>
+ </tr>
+
+ <tr>
+ <td>stockquotes.webservicex.wsdl</td>
+
+ <td></td>
+
+ <td>Actual stock quote service.</td>
+ </tr>
+
+ <tr>
+ <td>DasAccountConfiguration.xml</td>
+
+ <td></td>
+
+ <td>Provides any needed configuration info
+ including datasource properties, table
+ definitions,</td>
+ </tr>
+
+ <tr align="center">
+ <td colspan="3"><span style=
+ "font-weight: bold; text-decoration: underline;">Files
+ located in WEB-INF directory.</span></td>
+ </tr>
+
+ <tr>
+ <td>default.scdl</td>
+
+ <td></td>
+
+ <td>Application's SCA SCDL file.</td>
+ </tr>
+
+ <tr>
+ <td>web.xml</td>
+
+ <td></td>
+
+ <td>Application's web.xml file.</td>
+ </tr>
+
+ <tr align="center">
+ <td colspan="3"><span style=
+ "font-weight: bold; text-decoration: underline;">Generated
+ Files.</span></td>
+ </tr>
+
+ <tr>
+ <td>sdo source</td>
+
+ <td></td>
+
+ <td>Generated SDO. Created by tuscany-sdo-plugin
+ maven plugin.</td>
+ </tr>
+
+ <tr>
+ <td>wsdl2java-source</td>
+
+ <td></td>
+
+ <td>Generated SDO interface. Created by
+ tuscany-plugin-wsdl2java maven plugin.</td>
+ </tr>
+
+ <tr align="center">
+ <td colspan="3"><span style=
+ "font-weight: bold; text-decoration: underline;">Build
+ files.</span></td>
+ </tr>
+
+ <tr>
+ <td><a href="#Building">pom.xml</a></td>
+
+ <td></td>
+
+ <td>Maven build file.</td>
+ </tr>
+ </tbody>
+ </table>
+ </td>
+ </tr>
+ </tbody>
+ </table>
+ </div><br>
+ <br>
+
+ <h3><a name="Building" id="Building"></a>Building</h3>This sample
+ can be built from the bigbank directory using Maven 2.0.4 with
+ the following command:<br>
+ <code> mvn package<br>
+ <br></code>
+
+ <h4>Pom.xml</h4>The directions to build the each module is
+ located in each module's directory in the maven file pom.xml
+ The application use Java 1.5 and thus in the build
+ plugin section needs the following compiler directives:<br>
+ <code>
+ <plugin><br>
+
+ <groupId>org.apache.maven.plugins</groupId><br>
+
+ <artifactId>maven-compiler-plugin</artifactId><br>
+
+ <configuration><br>
+
+ <source><span style=
+ "color: rgb(255, 0, 0); font-weight: bold;">1.5</span></source><br>
+
+
+ <target><span style=
+ "color: rgb(255, 0, 0); font-weight: bold;">1.5</span></target><br>
+
+
+ </configuration><br>
+
+ </plugin></code><br>
+ Both modules uses three maven plugins: tuscany-sdo-plugin,
+ org.apache.tuscany.sca.plugins, and tuscany-war-plugin.
+ The tuscany-sdo-plugin is provided by Tuscany 's SDO project
+ while the other two are provided by the Tuscany SCA project.<br>
+ <br>
+ The <code style="font-weight: bold;">tuscany-sdo-plugin</code>
+ references the WSDL's schema and generates all the files
+ located in target/sdo_source directory. The application
+ uses these classes as a databinding instead of having to deal
+ directly with XML that represents form as defined in the
+ WSDL's schema.<br>
+ <br>
+ The <code style=
+ "font-weight: bold;">tuscany-plugin-wsdl2java</code> plugin
+ generates a Java interface in the target/wsdl2java-source
+ directory that is used to define the inteface (prottype) in the
+ wsdl.<br>
+ <br>
+ The <code style="font-weight: bold;">tuscany-war-plugin</code> is
+ used to add both the tuscany runtime and any Tuscany
+ extensions requied by the application.<br>
+ <br>
+ <br>
+ <br>
+ <code><br></code><br>
+</body>
+</html>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
