Tuscany Java Project

The main Tuscany project repository is located at https://svn . a p ache.org/repos/asf/incubator/tuscany . You can use SVN to check out the Tuscany Java projects by checking out the java directory at https://svn . a pache.org/repos/asf/incubator/tuscany/java , to get the SCA, SDO and DAS implementations for Java.

System requirements

Next, please download the following in order to get your machine ready for Java development.

Software Download Link Download Instructions
JDK 5.0 Update 6 or later jdk 5.0 Steps for Java setup is here .
Apache Maven 2.0.4 or later Maven 2.04
  • We are using Maven 2 to build Tuscany, plus a few Ant scripts. Steps for Maven setup is here .
  • A quick reference on Maven is available here
Apache Ant 1.6.5 or later Ant Steps for Ant setup is here .
Subversion 1.3.0 or later Subversion
  • Tuscany source code is stored in a Subversion (SVN) repository, you need Subversion to download it. Steps for svn setup is here .
  • A quick reference for subversion commands is here
  • Note: Some linux distributions may already have a subversion client installed. try executing "svn --version"
Apache Tomcat 5.5.17 apache tomcat 5.5 This is the Web container that we integrate with, to allow you to use the SCA programming model in Web applications. Steps for Tomcat setup is here .

Environment scripts

There is a windows setenv.bat and a linux setenv.sh script that you can download by right clicking and "selecting save as..." You can edit these scripts with the below described environment variables to set up your environment any time by running them. On linux you invoke the shell script with

. ./setenv.sh

Downloading and installing the Java JDK 5.0
  • Download and extract the appropriate JDK for your operating system from http://java.sun.com/j2se/1.5.0/download.jsp .
  • set the JAVA_HOME environment variable to point to the root directory of where you extracted java download.
  • Add to your PATH environment variable to include the full path to the bin subdirectory of the JDK download package.
Downloading and installing Apache Maven
  • Download and extract Maven 2.0.4 or later from http://maven.apache.org/download.html .
  • Add to your PATH environment variable to include the the full path to the bin subdirectory of the Maven download package.
Downloading and installing Apache Ant
  • Download and extract Ant 1.6.5 or later from http://ant.apache.org/bindownload.cgi .
  • Add to your PATH environment variable to include the the full path to the bin subdirectory of the Ant download.
Downloading and installing Subversion
  • Download and extract Subversion 1.3.1 or later from http://subversion.tigris.org/project_packages.html .
  • Modify your path statement to include the full path to the subversion bin directory.
  • Note: For linux you may need to install subversion as root

A quick reference for subversion commands is here

Download and Setup Tomcat
Checkout and Build Tuscany


Tuscany SCA and Tuscany DAS are dependent on Tuscany SDO. Hence if you plan to build all three from source then you must ensure that Tuscany SDO is the first that you build followed by the other two in any order.

Alternatively, in you intend to build only either of Tuscany SCA or Tuscany DAS, then you may just do so in which case Maven (the build tool used in Tuscany) will download Tuscany SDO binaries from public Maven repositories dynamically during build time.

For more information on checking out and building Tuscany SCA, SDO and DAS visit the following pages:

Tuscany Java SCA
Tuscany Java SDO
Tuscany Java DAS

Running the Samples

The samples for Tuscany fall into two categories.

  • Sample applications that use a mix of the Tuscany technologies SCA, SDO and DAS. These samples show how SCA, SDO and DAS can be combined to create service-oriented applications that implement business scenarios.
  • Technology samples for each of the Tuscany technologies SCA, SDO and DAS. These samples illustrate specific technical features of SCA, SDO and DAS and show how they can be used by an application developer.

The sample applications are in the java/sampleapps module. See the Sample Applications readme for instructions on how to build and run them.

For information on building and running the technology samples for SCA, SDO and DAS, visit the following pages:

Tuscany Java SCA
Tuscany Java SDO
Tuscany Java DAS
Using Eclipse (optional)

Link to Eclipse download : http://www.eclipse.org/downloads/index.php

Getting Started documentation: http://www.eclipse.org/downloads/index.php

To create the eclipse projects to use for SCA development:

1) When checking code out from subversion, checkout the subversion trunk to a location outside your eclipse workspace (it has to be outside because Eclipse will not allow you to import projects from a location overlapping with your workspace)

2) Go to Import / Existing projects into workspace. Select either the runtime, spec, tools or samples directory. The wizard proposes the list of Eclipse projects under that directory. Importing the projects does not copy the files; it just makes the files at that location visible under an Eclipse project.

3) If you need to use Eclipse to edit files outside of these projects (for example the etc directory, or the maven files at the root of the trunk), then delete the Eclipse projects, with the option to not delete the files, and import the whole trunk as a project.

Using Eclipse style templates
tuscany-eclipse-codestyle.xml
You may need to right click and save.
Window->Preferences->Java->Code-Style->Formatter->Import...
                (Specify path and file to the tuscany-eclipse-codestyle.xml just downloaded. 
            
Using Subclipse (optional)

Install the Subversion Eclipse Plugin as described here: http://subclipse.tigris.org/

  1. Open the SVN Repository Exploring perspective
  2. Right click in the SVN Repository view.
  3. Select "New" and "Repository Location"
  4. Url: http://svn.apache.org/repos/asf/incubator/tuscany

    Use URL https://svn.apache.org/repos/asf/incubator/tuscany if you have committer rights and need to commit changes back to the repository.

  5. Select the "Finish" button and allow Subeclipse time to access the repository and display its contents in the SVN Repository explorer. Once the repository is displayed in the explorer, you will see a number of subfolders displayed. The ones that are relevant are "java", "cpp" and "site" - which contain the Tuscany Java runtime, the Tuscany C++ runtime and the Tuscany website material respectively.
  6. Select the folder you want to check out as a project - one of java, cpp or site for example Right click, select "Checkout" and "Checkout using new project wizard" - select the appropriate options for your needs and then click "Finish"

You can check in changes using the "Commit" item in the team submenu of the Java perspective.

Using IDEA style templates
tuscany-idea-codestyle.xml
You may need to right click and save.
copy tuscany-idea-codestyle.xml to ~/.IntelliJIdea50/config/codestyles File->Settings, 
            Project Code Styles, Import
Logging
Tuscany Monitoring