Building the travel sample using ant
------------------------------------
1. Download and unzip JDK 1.6.0_07 or later and set the JAVA_HOME environment
variable to the JDK base directory.
2. Install svn and ant.
3. Create a local directory to hold the travel sample code. With this as
your current directory, check out the complete travel sample from svn
using the following command:
svn co http://svn.apache.org/repos/asf/tuscany/sandbox/travelsample
4. Download and unzip the Tuscany 1.5.1 (or later) binary distribution
and set the TUSCANY_HOME environment variable to the base directory
containing the unzipped binary distribution.
5. Download the tuscany-host-corba-jse and tuscany-host-corba-jse-tns
jars from the maven repository http://repo1.maven.org/maven2 and set the
TUSCANY_HOST_CORBA environment variable to the local directory in which
these files are located.
6. Download and unzip the OpenEJB 3.0 or later binary distribution and set
the OPENEJB_HOME environment variable to the base directory containing
the unzipped binary distribution.
7. With the travelsample directory as your current directory, enter the
command "ant compile".
Building the travel sample using maven
--------------------------------------
To be added.
Running the travel sample
-------------------------
The travel sample consists of a number of related scenarios. These are
listed below, together with instructions for running them.
Most of the scenarios are run by opening a single command prompt window
and entering the command "ant run" into that window. If a scenario is
listed with multiple commands, this means that it needs multiple command
prompt windows. In this case, each of the listed commands must be entered
into its own separate command prompt window in the order shown.
For each scenario, the following are given:
Directory: the current directory for the command prompt window or windows
Command(s): the command or commands for running the scenario
Contributions: SCA contributions used in this scenario
Launchers: other launcher directories needed by this scenario, if any
Services: non-SCA services used in this scenario, if any
Clients: non-SCA services used in this scenario, if any
1) Jumpstart - First simple example of using Tuscany
Directory: launchers/jumpstart
Command: ant run
Contributions: introducing-trips
Launchers: common
2) Introducing - Simplified introduction to the travel application
Directory: launchers/introducing
Command: ant run
Contributions: introducing-client, introducing-tours, introducing-trips
Launchers: common
3) Introducing (distributed) - Distributed services with a domain manager
Directory: launchers/introducing-client
Commands: ant run-domain, ant run-trips, ant run-tours, ant run
Contributions: introducing-client, introducing-tours, introducing-trips
Launchers: introducing-domain, introducing-tours, introducing-trips
4) Interaction - Different SCA interaction styles
Directory: launchers/interaction
Command: ant run
Contributions: calendar, common, currency, flight, hotel, interaction-client,
interaction-service-remote, shoppingcart
Launchers: common
5) Full application - The full interactive travel application
Directory: launchers/fullapp
Command: ant run
Contributions: car, common, creditcard-payment-jaxb-policy, currency, flight,
fullapp-bespoketrip, fullapp-coordination, fullapp-currency, fullapp-packagedtrip,
fullapp-shoppingcart, fullapp-ui, hotel, payment-java-policy, scatours,
shoppingcart, travelcatalog, trip, tripbooking
Launchers: common
6) Full application (distributed) - Distributed services with a domain manager
Directory: launchers/fullapp-nodes
Commands: ant run-domain, ant run
Contributions: car, common, creditcard-payment-jaxb-policy, currency, flight,
fullapp-bespoketrip, fullapp-coordination, fullapp-currency, fullapp-packagedtrip,
fullapp-shoppingcart, fullapp-ui, hotel, payment-java-policy, scatours,
shoppingcart, travelcatalog, trip, tripbooking
Launchers: fullapp-domain
7) Blog feed
Directory: launchers/blog-feed
Command: ant run
Contributions: blog-feed
Launchers: common
8) Data binding
Directory: launchers/databinding
Command: ant run
Contributions: creditcard-payment-sdo, databinding-client, payment-java
Launchers: common
9) Feed logger
Directory: launchers/feed-logger
Command: ant run
Contributions: blog-feed
Launchers: common
10) Help pages
Directory: launchers/help-pages
Command: ant run
Contributions: help-pages
Launchers: common
11) Policy
Directory: launchers/policy
Command: ant run
Contributions: creditcard-payment-jaxb-policy, policy-client, payment-java-policy
Launchers: common
12) SCA currency converter service interoperating with SCA or non-SCA client
12a) SCA client
Directory: launchers/currency-converter
Command: ant run
Contributions: currency
Launchers: common
12b) CORBA client
Directory: clients/currency-converter-corba
Command: ant run-service, ant run
Contributions: currency, currency-corba
Launchers: common, currency-converter-corba
12c) JMS client
Directory: clients/currency-converter-jms
Commands: ant run-broker, ant run-service, ant run
Contributions: currency, currency-jms
Launchers: common, currency-converter-jms
12d) RMI client
Directory: clients/currency-converter-rmi
Command: ant run-service, ant run
Contributions: currency, currency-rmi
Launchers: common, currency-converter-rmi
12e) JAX-WS client
Directory: clients/currency-converter-ws-jaxws
Command: ant run-service, ant run
Contributions: currency, currency-ws
Launchers: common, currency-converter-ws
13) SCA notification service interoperating with non-SCA SMS gateway service
13a) SMS gateway CORBA service
Directory: launchers/notification-corba
Commands: ant run-nameserver, ant run-smsgateway, ant run
Contributions: notification, notification-corba
Launchers: common
Services: smsgateway-corba
13b) SMS gateway EJB service
Directory: launchers/notification-ejb
Commands: ant run-smsgateway, ant run
Contributions: notification, notification-ejb
Launchers: common
Services: smsgateway-ejb
13c) SMS gateway JMS service
Directory: launchers/notification-corba
Commands: ant run-broker, ant run-smsgateway, ant run
Contributions: notification, notification-jms
Launchers: common
Services: smsgateway-jms
13d) SMS gateway RMI service
Directory: launchers/notification-rmi
Commands: ant run-smsgateway, ant run
Contributions: notification, notification-rmi
Launchers: common
Services: smsgateway-rmi
13e) SMS gateway JAX-WS service
Directory: launchers/notification-ws
Commands: ant run-smsgateway, ant run
Contributions: notification, notification-ws
Launchers: common
Services: smsgateway-jaxws
17f1dde1f0