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 | |
Apache Ant 1.6.5 or later | Ant | Steps for Ant setup is here. |
Subversion 1.3.0 or later | Subversion | |
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. |
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
Note: For linux you may need to install subversion as root
A quick reference for subversion commands is here
Check out Tuscany Java
From the command prompt, in the tuscany directory do the following:
svn co http://svn.apache.org/repos/asf/incubator/tuscany/java
This should check out all the source code from the Tuscany SVN repository into java sub directory.
Build Tuscany Java
When the check out completes change to the java subdirectory. From the command prompt do the following build tuscany using maven:
mvnThis will build the Tuscany runtime with Maven. Maven will download all the JAR dependencies, build all the Tuscany sub-projects and run the unit tests.
Note: Depending on the load of remote Mavan 2.0 repositories you may have to execute mvn several time until required dependencies are all located in your local maven repository. After you have completed a full successful build you can use "mvn -o" which is much faster.
Run the samples by building the distribution.
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.
Window->Preferences->Java->Code-Style->Formatter->Import... (Specify path and file to the tuscany-eclipse-codestyle.xml just downloaded.
Install the Subversion Eclipse Plugin as described here: http://subclipse.tigris.org/
Use URL https://svn.apache.org/repos/asf/incubator/tuscany if you have committer rights and need to commit changes back to the repository.
You can check in changes using the "Commit" item in the team submenu of the Java perspective.
copy tuscany-idea-codestyle.xml to ~/.IntelliJIdea50/config/codestyles File->Settings, Project Code Styles, Import