apache-tuscany/sca-java-1.x/trunk/samples
2010-10-25 12:27:01 +00:00
..
binding-echo Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
binding-echo-extension Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
binding-notification-broker Merge r1000266 Fix notification sample build.xml and README files to provide clear instructions that work 2010-10-25 11:42:26 +00:00
binding-notification-consumer Merge r1000266 Fix notification sample build.xml and README files to provide clear instructions that work 2010-10-25 11:42:26 +00:00
binding-notification-producer Merge r1000266 Fix notification sample build.xml and README files to provide clear instructions that work 2010-10-25 11:42:26 +00:00
calculator Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
calculator-android Moving 1.x trunk 2009-11-13 01:42:27 +00:00
calculator-corba-reference Merge r1000425 Update CORBA sample READMEs to include instructions for using ant 2010-10-25 11:44:15 +00:00
calculator-corba-service Merge r1000425 Update CORBA sample READMEs to include instructions for using ant 2010-10-25 11:44:15 +00:00
calculator-distributed Merge r998330 Make "compile" the default target in build.xml 2010-10-25 09:57:40 +00:00
calculator-implementation-policies Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
calculator-lean Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
calculator-osgi Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
calculator-rcp Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
calculator-rmi-reference Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
calculator-rmi-service Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
calculator-script Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
calculator-webapp Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
calculator-ws-basicauth-reference A sample that calls the add component (from the calculator-ws-basicauth-service-webapp samples) with basic authentication configured. 2010-05-25 09:13:38 +00:00
calculator-ws-basicauth-service-webapp A sample SCA webapp that can be installed in Tomcat and configured for basic authentication 2010-05-25 09:10:29 +00:00
calculator-ws-secure-webapp Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
calculator-ws-webapp Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
calculator2 Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
callback-ws-client Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
callback-ws-service Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
callbacks-jms Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
chat-webapp Fixing geronimo-web.xml version to 1.7-SNAPSHOT 2010-01-20 03:56:34 +00:00
chat2-webapp Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
customer-dojo Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
customer-dojo-webapp Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
databinding-echo Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
domain-management Merge r1000571 TUSCANY-3684: Update README file to describe building and running the sample using ant 2010-10-25 11:51:55 +00:00
domain-webapp Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
feed-aggregator Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
feed-aggregator-webapp Fixing geronimo-web.xml version to 1.7-SNAPSHOT 2010-01-20 03:56:34 +00:00
helloworld-bpel Merge r999910 Update instructions for running this sample without needing to compile it first, and document the issue described in TUSCANY-1994 2010-10-25 11:05:50 +00:00
helloworld-bpel-ws Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
helloworld-distributed Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
helloworld-dojo-webapp Merge r998364 Fix code for "clean" target in build.xml file (TUSCANY-3680) 2010-10-25 10:06:35 +00:00
helloworld-erlang-reference Renaming erlang samples and excluding them from binary distribution 2010-01-21 20:48:46 +00:00
helloworld-erlang-service Renaming erlang samples and excluding them from binary distribution 2010-01-21 20:48:46 +00:00
helloworld-jms-webapp Fixing geronimo-web.xml version to 1.7-SNAPSHOT 2010-01-20 03:56:34 +00:00
helloworld-jsonrpc-webapp Fixing geronimo-web.xml version to 1.7-SNAPSHOT 2010-01-20 03:56:34 +00:00
helloworld-jsp Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
helloworld-reference-jms Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
helloworld-script Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
helloworld-service-jms Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
helloworld-servlet Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
helloworld-spring Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
helloworld-web Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
helloworld-web-callback Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
helloworld-ws-deep-webapp Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
helloworld-ws-reference Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
helloworld-ws-reference-jms Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
helloworld-ws-reference-lean Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
helloworld-ws-reference-secure Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
helloworld-ws-sdo Merge r998328 Add missing code generation to build.xml file 2010-10-25 09:55:12 +00:00
helloworld-ws-sdo-webapp Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
helloworld-ws-service Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
helloworld-ws-service-jms Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
helloworld-ws-service-secure Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
helloworld-ws-service-webapp Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
holder-ws-service Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
implementation-composite Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
implementation-crud Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
implementation-crud-extension Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
implementation-notification Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
implementation-pojo-extension Merge r1000615 TUSCANY-3685: Add a test client that doesn't use JUnit and update the build.xml and README files 2010-10-25 12:23:58 +00:00
loanapplication Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
osgi-supplychain Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
photo-gallery Merge r1000619 Tidy up the README instructions to cover all options for building and running 2010-10-25 12:27:01 +00:00
quote-xquery Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
simple-bigbank Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
simple-bigbank-spring Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
simple-callback Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
simple-callback-ws Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
spi-implementation-pojo Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
spring-bigbank-calculator Merge r998332 Fix README references to incorrect module name 2010-10-25 09:59:26 +00:00
spring-bigbank-checkaccount Merge r998332 Fix README references to incorrect module name 2010-10-25 09:59:26 +00:00
spring-bigbank-stockquote Merge r998332 Fix README references to incorrect module name 2010-10-25 09:59:26 +00:00
store Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
store-android Moving 1.x trunk 2009-11-13 01:42:27 +00:00
store-distributed Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
store-dojo Merge commit r997683 from 1.6.1 branch 2010-09-16 20:18:34 +00:00
store-secure Merge commit r997683 from 1.6.1 branch 2010-09-16 20:18:34 +00:00
store-webapp Merge r998020 Generate build.xml instead of build-dependency.xml 2010-10-25 08:24:21 +00:00
supplychain Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
web-resource Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
zipcode-jaxws Update 1.x trunk version to 1.7-SNAPSHOT 2009-12-21 12:31:56 +00:00
build.xml Merge r998367 Reorder modules to satisfy dependency relationships 2010-10-25 10:10:24 +00:00
pom-distribution.xml Merge commits r996988, r996991, r996994, r996998, r997259 and r997886 from 1.6.1 branch (TUSCANY-3676) 2010-09-16 20:13:11 +00:00
pom.xml Merge commits r996988, r996991, r996994, r996998, r997259 and r997886 from 1.6.1 branch (TUSCANY-3676) 2010-09-16 20:13:11 +00:00
README Merge commits r996988, r996991, r996994, r996998, r997259 and r997886 from 1.6.1 branch (TUSCANY-3676) 2010-09-16 20:13:11 +00:00

The Apache Tuscany SCA Samples
==============================
The Apache Tuscany SCA samples are built as part of the main Maven build and 
run, using the provided JUnit test cases, as tests in the Maven build.

In the binary distribution of Apache Tuscany most samples can also 
be run using the provided Ant build.xml files. These show the samples running 
from a simple main() method without the need for a JUnit test case. 

In these notes text that appears in angled brackets like this <example> means 
that you need to make a choice and provide your own text at that point. 

These simple samples have been created with the intention of illustrating the 
usage of the SCA API and annotations and certainly not to levels of SCA component 
abstraction.  In real life situations you should use SCA to assemble real and 
usually bigger components, and when you do that you'll get all the benefits of 
SCA, bindings, policies, integration in an SOA environment etc..

Sample Overview
---------------
The samples generally show off different features of the SCA runtime
and the extensions that come packaged with it.

binding-notification-broker        - A broker for notificatione
binding-notification-consumer      - A consumer of notifications
binding-notification-producer      - A producer of notifications

calculator                         - Calculator built with java components and 
                                     local wires. 
calculator-distributed             - A calculator built using SCA nodes running 
                                     on multiple JVMs
calculator-implementation-policies - Shows logging policites associated with 
                                     SCA implementations
calculator-corba-reference         - The calculator configured to use existing
                                     CORBA service
calculator-corba-service           - The calculator configured to be accessible
                                     as CORBA service
calculator-rmi-reference           - The calculator configured to talk RMI to
                                     the calculator-rmi-service sample
calculator-rmi-service             - The calculator configured to accept RMI
                                     requests from calculator-rmi-reference
calculator-script                  - Calculator built using various script languages
calculator-webapp                  - Calculator running inside a web app
calculator-ws-webapp               - Calculator running inside a web app also 
                                     showing webservices binding

callbck-ws-client                  - The client for showing callbacks across web services
callback-ws-service                - The server for showing callbacks across web serviced

chat-webapp                        - A simple chat style web app demonstrating
                                     use of AJAX binding

databinding-echo                   - An SCA application that shows how databindings 
                                     transform data
                    
feed-aggregator                    - Demonstrates using the ATOM binding
feed-aggregator-webapp             - feed-aggregator running in webapp

helloworld-bpel                    - Demonstrates an SCA component invoking a BPEL 
                                     process in a composition

helloworld-dojo-webapp             - An SCA application that exposes a service using 
                                     JSONRPC and a client using the Dojo toolkit
helloworld-jsonrpc-webapp          - helloworld using jsonrpc binding
helloworld-ws-reference            - The client side of a hello world sample that uses a 
                                     web service binding (requires helloworld-ws-service)
helloworld-ws-service              - The server side of a hello world sample that uses a 
                                     web service binding
helloworld-ws-reference-jms        - The client side of a hello world sample that uses a 
                                     web service binding with SOAP/JMS (requires 
                                     helloworld-ws-service)
helloworld-ws-service-jms          - The server side of a hello world sample that 
                                     uses a web service binding with SOAP/JMS
helloworld-ws-reference-secure     - The client side of a hello world sample that 
                                     shows how policy intent can be used.
helloworld-ws-service-secure       - The client side of a hello world sample that 
                                     shows how policy intent can be used.
helloworld-ws-sdo                  - helloworld using ws binding and SDO
helloworld-ws-sdo-webapp           - helloworld using ws binding and SDO within a webapp

implementation-composite           - Shows how SCA composites are used 
                     
osgi-supplychain                   - SCA asynchronous API with OSGi and Java 
                                     implementation types

simple-bigbank                     - A banking application built with java components 
                                     and local wire
simple-bigbank-spring              - A banking application showing how SCA works with Spring

simple-callback                    - demonstrates the callback interface
simple-callback-ws                 - demonstrates use of callback interface across WS binding

store                              - Step by step guide for creating an online store

supplychain                        - shows how asynchronous callbacks can be used

web-resource                       - Demonstrates using an SCA Web resource component

quote-xquery                       - Demonstrate SCA components using XQuery

Samples for building extensions
-------------------------------
There are samples that demonstrate how to build extensions for the 
Tuscany SCA runtime. These samples are slightly different from the samples
above in that the provided code is concerned with building the extension
and not with building an application that uses it. The application
that shows how the new extension can be used is provided in an associated
sample. 

implementation-crud-extension - Shows how to build new implementation type 
                                extensions
implementation-crud        - A sample application that exercises the new 
                             implementation extensions
binding-echo-extension     - Shows how to build new binding extensions
binding-echo               - A sample application that exercises the new 
                             binding extension
implementation-notifiaction- Illustrates the use of <implementation.notification/>
implementation-pojo-extension - shows how new implementation types are constructed 

Sample Layout
-------------
All sample directories are organized in the same way based on the default 
project template provided by Maven. For example, take a look at the calculator 
sample;

calculator/        
  src/              - Holds all of the source files for the sample
    main/           - Groups together the files that implement the sample 
      java/         - Java source files
      resources/    - Non java resource files such as composte files
    test/           - Groups together files that provide sample tests
      java          - Java test sources files. Usually JUnit test cases
  target/           - Holds the files generated when the sample is built
    classes/        - For example, Java class files
    test-classes/   - classes from src/test and other test files

Getting Ready To Build
----------------------
You will need to install the following software before you start. 

J2SE Development Kit (JDK) 5.0 or higher
Apache Ant 1.7.1 or higher      - if you are going to use Ant 
Apache Maven 2.0.10 or higher   - if you are going to use Maven

Java and Ant and/or Maven binary directories must be present in your PATH so 
that their executable programs are available in your environment. You may 
find it useful to use a script to set up your environment, for example;

For UNIX:
  JAVA_HOME=/<installation_directory>
  ANT_HOME=/<installation_directory>/apache-ant-1.7.1
  M2_HOME=/<installation_directory>/maven-2.0.10
  export PATH=$JAVA_HOME/bin:$ANT_HOME/bin:$M2_HOME/bin:$PATH

For Windows:
  set JAVA_HOME=C:\<installation_directory>
  set ANT_HOME=C:\<installation_directory>\apache-ant-1.7.1
  set M2_HOME=C:\<installation_directory>\maven-2.0.10
  set PATH=%JAVA_HOME%\bin;%ANT_HOME%\bin;%M2_HOME%\bin;%PATH%


Building And Running The SCA Samples Using Ant
----------------------------------------------
The build.xml files provided with the Apache Tuscany SCA samples are designed 
to work with the binary distribution. They rely on the tuscany-sca-manifest.jar
to describe the class path and this jar is only provided as part of the 
binary distribution.

The binary distribution of SCA also includes precompiled versions of each sample. 
If you look in the target directory of each sample you will see this jar file. To
run a sample based on all of the precompiled artifacts all you have to do is:

cd <sampledir>
ant run

Check each <sampledir>/README file as some samples require that two progams are
run to get the desired result, for example, the two samples that show how
to build extensions are run from their associated application samples. 

If you want to rebuild a sample, for example, if you have changed it, do the
following:

cd <sampledir>
ant compile

Once the sample is built you have the option of running the sample in whatever 
way best suits you. Two alternatives are provided in the ant build files.

The compile target builds the class files and then builds the jar so you can use 
the same command as before:

ant run

This will use the generated jar to run the samples. The command line version of
this is:

on Windows

java -cp ..\..\lib\tuscany-sca-manifest.jar;target\<sample jar file> <sample runnable class>

for example : java -cp ..\..\lib\tuscany-sca-manifest.jar;target\sample-calculator.jar calculator.CalculatorClient

on *nix 

java -cp ../../lib/tuscany-sca-manifest.jar:target/<sample jar file> <sample runnable class>

for example : java -cp ../../lib/tuscany-sca-manifest.jar:target/sample-calculator.jar calculator.CalculatorClient


You can use the compiled classes directly using

ant run-classes

The command line version of this is:

on Windows

java -cp ..\..\lib\tuscany-sca-manifest.jar;target\classes <sample runnable class>

for example : java -cp ..\..\lib\tuscany-sca-manifest.jar;target\classes calculator.CalculatorClient

on *nix 

java -cp ../../lib/tuscany-sca-manifest.jar:target/classes <sample runnable class>

for example : java -cp ../../lib/tuscany-sca-manifest.jar:target/classes calculator.CalculatorClient

The class specified on the command of course depends on which sample you want to 
run. In the examples we have used we are running the CalculatorClient from the calculator sample. 


Building And Running The SCA Samples Using Maven
------------------------------------------------

The Maven build process will work from both source and binary distributions. 
To build and test all of the Apache Tuscany SCA sources, including the samples,
do the following.

cd samples
mvn

This will take a little while to complete. Experience with Maven tells us that 
sometimes there are problems downloading the dependencies that Apache Tuscany 
SCA requires. If Maven reports that it cannot download required dependencies 
try running the Maven build again. 

Once you have all of the source built you can build and run each sample 
independently if required.

cd <sampledir>
mvn

When using Maven the samples are run within JUnit test cases and so you will 
sometimes not see any test output. You will always see an indication of test 
success or failure. 


Using The Samples In An IDE
---------------------------
The easiest way to use the samples in an IDE is to use Maven to generate all 
of the IDE project files for you automatically.

If you are using the Apache Tuscany SCA source distribution, you can find
details of how to generate IDE project files (including IDE project files
for the samples) in the "Using an IDE" section of the BUILDING file.

If you are using the Apache Tuscany SCA binary distribution, follow these
steps to generate IDE project files for all of the samples;

cd samples

If you are an Eclipse user do the following

mvn eclipse:eclipse
mvn -Declipse.workspace=<path-to-eclipse-workspace> eclipse:add-maven-repo

If you are an IDEA user do the following 

mvn idea:idea

These commands generate project files for each module in the samples directory. 
The modules you are interested in can now be included in your IDE.

For example, in Eclipse, if you create a new Java project and use the option
to "create a new project from existing source" you can specify an SCA module
directory, which includes the generated project files, and Eclipse will treat
it like any other Java project. 


Using The Samples In An IDE Without Maven
-----------------------------------------
We don't provide any IDE project files with our distributions so you will have to 
import the sample files into your IDE manually. Here's an example of how it can be 
done using Eclipse.
 
In a new or existing workspace
    Create a new java project to represent the sample you want to work on, e.g.
        calculator
    Import all of the sample code and resources into this project, e.g.
        File, Import and then select samples/calculator from the filesystem
    Configure the source path to include
        src/main/java
        src/main/resources
    Configure the output folder to be
        calculator/target
    Configure the build path to include all of the jars provided in
        lib
     If you select calculator.CalculatorClient.java and run as "Java Application" you should see
        3 + 2=5.0
        3 - 2=1.0
        3 * 2=6.0
        3 / 2=1.5

The details of how to do this for other development environments will
vary but the process will be similar.