Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

There is already a page that describes how to get started with Eclipse by building a new Tuscany SCA project from scratch. How do you though use the various existing samples and examples that are provided with Tuscany from within Eclipse. Here we'll provide some instructions about how to do just that for both the Maven user and the non-maven user. As an example well look at how to import the introducing-trips contributions and the jumpstart launcher that runs it from the Tuscany SCA Travel Sample.

1 - For the Maven user

1.1 - Creating Eclipse project files

Maven has a plugin which will convert a Maven project into an Eclipse project. For example, to load the travel sample's introducing-trips contribution project into Eclipse first do the following:

Code Block

cd travelsample/contributions/introducing-trips
mvn eclipse:eclipse

That generates, amongst other things, .classpath and .project files into the introducing-trips directory. These files effectively make the introducing-trips module an Eclipse project that can be loaded directly into Eclipse. This Eclipse project will reference dependencies in the local Maven repository, based on the contents of the pom.xml file. These dependency references are constructed using and Eclipse classpath variable called M2_REPO.

1.2 - Setting the M2_REPO variable

Before loading the project in Eclipse we need to set M2_REPO as a classpath variable in our workspace to tell it where the Maven repository is.

You can do this with maven using the following command.

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

Alternatively you can do it manually as follows:

Open the Eclipse workspace you’re going to use then:

Code Block

Select Window/Preferences
From the resulting “Preferences” dialog select Java/Build Path/Classpath Variables
Select the “New…” button
In the “Name:” field type M2_REPO
In the “Path:” field type <path to your maven repo>

1.3 - Loading and existing project into Eclipse

Once M2_REPO is set you can load the project into Eclipse

Open the Eclipse workspace you’re going to use then:

Code Block

Select menu File/Import…
From the resulting “Select” dialog box select General/Existing Projects into Workspace
From the resulting “Import Projects” dialog box select the “Browse…” button to locate the travelsample/contributions/introducing-trips directory
Select “Finish”

The project should now appear in your workspace.

Now you have introducing-trips loaded you can repeat the process for the launchers/jumpstart module. Repeat step 1.1 for launchers/jumpstart and then load it into eclipse with step 1.3. You don't need to repeat step 1.2 as it will remain set.

For the non-Maven user