Getting Started with Tuscany SCA for Java

Overview

Set up the development environment

1) Repository

Tuscany source code is hosted at Apache subversion repository. If you want to build Tuscany from source, you need to install a subversion client.

Where to download the subversion clients?
Command line: http://subversion.tigris.org/ (1.4.2)
Windows GUI: http://tortoisesvn.tigris.org/ (1.4.1)

2) Build

Where to download maven?
Maven 2: http://maven.apache.org/ (2.0.4)

3) Development IDE

Where to download Eclipse/WTP?
Eclipse: http://www.eclipse.org/ (3.2.1)
Eclipse WTP: http://www.eclipse.org/webtools/ (1.5.2)

Create a simple project from scratch

mvn archetype:create -DgroupId=sample -DartifactId=helloworld

Configure the project for maven build

<project>
    <modelVersion>4.0.0</modelVersion>
    <groupId>org.apache.tuscany.samples.sca</groupId>
    <version>1.0-incubator-SNAPSHOT</version>
    <artifactId>sample-mortgage</artifactId>
    <packaging>jar</packaging>
    <name>Tuscany Mortgage Sample</name>
    <description>A sample Mortgage application made of several SCA components wired together.</description>

    <properties>
        <property name="tuscanyVersion">1.0-incubator-SNAPSHOT</property>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.osoa</groupId>
            <artifactId>sca-api-r0.95</artifactId>
            <version>${tuscanyVersion}</version>
        </dependency>
        <dependency>
            <groupId>org.apache.tuscany.sca</groupId>
            <artifactId>test</artifactId>
            <version>${tuscanyVersion}</version>
            <scope>test</scope>
        </dependency>
</project>

Load the project into Eclipse

1. Adding M2_REPO classpath variable

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

2. (Optional) Add maven as an external tool for Eclipse

3. Create Eclispe metadata files

mvn -Peclipse eclipse:eclipse

4. Import projects into Eclipse
File --> Import ... --> Existing Projects into Workspace

"Maven integration with Eclipse"
http://maven.apache.org/guides/mini/guide-ide-eclipse.html

Develop a simple SCA application

1. Declare components in the SCDL

META-INF/sca/default.scdl

The SCDL file

2. Implement the components in java

CreditCheckImpl.java

The java file