Tuscany BigBank Sample Application

Tuscany BigBank Sample Application

Overview

The Tuscany BigBank sample application shows using the Tuscany SCA runtime to build a financial application.

Location

This sample is located in the sampleapps\bigbank directory. There are two subdirectories in that for the two modules account and webclient.

Setup

This Setup section is not required if you are working from a binary distribution. Set up your server as described in the Tomcat Setup. If you are building the sample from source you need to deploy the war files produced in sampleapps\bigbank\account\target and sampleapps\bigbank\webclient\target your webapp directory.

Running

Once you've started your web server, use your web browser to view the following URL http://localhost:8080/sample-bigbank-webclient/
You can either use an already supplied account with Login as test and Password as password, or you can create a new account.
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:

Stop your server by issuing in the apache-tomcat-5.5.17\bin directory
Issue shutdown command to stop your web application server.
Change the directory to apache-tomcat-5.5.17\webapps\sample-bigbank-account-incubating-M1\WEB-INF\classes
Copy the file WebservicexService_stockquote.fragment to sca.fragment
Change to the directory apache-tomcat-5.5.17\bin
issue startup command to start up the server.

The sample should now be using the real stock quote provider. The "sca.fragment" file is loaded and added to the sca.module at runtime.

Introduction

This example illustrates using Tuscany runtime in building a financial application using SCA programing model. The following key concepts are covered:

Component implementations. that provide web based HTML user interface
Component implementations that provide local services in Java. Local services implement internal application business logic such as tracking user state and are not exposed remotely.
Component implementations that have configuration properties and service references to other services
Components that use and configure the properties and references of component implementations
Entry points to publish remotable services via a Web Service binding.
External services to consume remotable services via a Web Service binding
Assembling implementation, components, entry points and external service into modules.
Creating a module and all of its artifacts as part of a web application to show a front-end access to SCA services
The use of Data Access services to persist and retrieve Service Data Objects from Apache Derby.
The use of existing Web services in SCA.

BigBank sample provides the following user services: account balance, making deposits and withdrawals to purchase and sell stock, and to view current stock value.
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 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 exterenalService and entryPoint.

Overview of modules.

Webclient

Webclient files

click to enlarge

Java source files implementing SCA components and interfaces.
AccountServiceComponentImpl.java	Implements the account service.
AccountLoginServiceImpl.java	Implements the Logiin service.
LoginService.java	Interface for a services provided by a login service component.
ProfileService.java	Interface for a service provided by a profile component.
ProfileServiceImpl.java	Implements the profile component.
SimpleLoginServiceImpl.java	A simple in memory login service.
Java source files implementing Web HTML interface.
AccountStatusTag.java	Implements a jsp tag that displays the account information
StockStatusTag.java	Implements a jsp tag that displays the stock information.
LoginBarrierTag.java	Implements a jsp tag that ensures the user is logged in.
ServiceTag.java	Places an SCA service in the JSP page context.
FormServlet.java	Process user input and uses the AccountService component.
LoginServlet.java	Processes logging in and logout.
Files that will be loaded as resources along classpath.
sca.module	SCA module.
sca.subsystem	SCA subsystem.
AccountService.wsdl	WSDL that defines the account service.
bigbank-tags.tld	Defines the tag libs for the user interface.

Account

Webclient files

click to enlarge

Java source files implementing SCA components and interfaces.
AccountServiceImpl.java	Implements the account service component.
AccountDataService.java	Interface defined for component implementing an account's data service.
AccountDataServiceDASImpl.java	A Data Access Service (DAS) implementation of of the Account Data Service.
AccountDataServiceImpl.java	A Data Service implementation not using DAS.
AccountDBInit.java	A utility to just create the database and it table and fill in some initial data.
StockQuote.java	A class to hold the StockQuote information.
StockQuoteService.java	Interface defined for a component implementing a stock quote service.
StockQuoteServiceImpl.java	Implements a fake stock quote service.
StockQuoteWebservicexServiceImpl.java	Implements an actual stock quote service.
Files that will be loaded as resources along classpath.
AccountService.wsdl	WSDL that defines the account service
stockquotes.webservicex.wsdl	Actual stock quote service.
DasAccountConfiguration.xml	Provides any needed configuration info including datasource properties, table definitions,
sca.module	SCA module.
sca.fragrment	Loaded and combined with the existing SCA module.
sca.subsystem	Processes logging in and logout.