Project Development in Eclipse

An Integrated Development Environment (IDE) should be used to develop source code.  Eclipse is a good choice, as it is free, widely used, and well supported.

You will also want to install the m2eclipse plugin for Maven support and Subversive which provides a Subversion client interface.

Before You Start

Before you start to setup Eclipse, you should follow the instructions at Installing HPS Java to install locally the HPS Java trunk, which contains the various modules that will be loaded as projects.

Installing Eclipse

The "Eclipse Standard" distribution can be downloaded from the Eclipse downloads area.

The Subversive plugin provides SVN access through the IDE and can be installed through this URL:

http://download.eclipse.org/technology/subversive/1.1/update-site/

When Eclipse reboots select and install an appropriate SVN connector for your system, which should be the pure Java version matching the version of the SVN client that you have installed on your operating system (either 1.6, 1.7 or 1.8).

After this, install the m2e plugin for Maven support using this update site URL:

http://download.eclipse.org/technology/m2e/releases

Configuring Plugins

Subversive

The Subversive Plugin provides a graphical Subversion client within Eclipse, implementing commands like commit, update, etc.

1. In Eclipse, open Help > Install New Software.

2. Under work with put the appropriate URL for your release, e.g. for Luna this would be the following.

Creating a New Java Project

To create a new project in Eclipse, you can select File > New > Java Project from the menu.  This will start a wizard for creating the new project.

We will create a project for the users module where miscellaneous user analysis code is located.

In the New Java Project window, you need to do the following.

1. Type the name of the project in the Project name text box, e.g. "hps-users".
2. Uncheck Use default location and navigate to the root directory of the module for the project using Browse.
3. Add the project to a working set (optional).

Then click on the Finish button and the project should now show up in the Package Explorer within the Java View.

Building a Maven Project

It is useful to create a custom build configuration for executing Maven on the project.

Open the window Run > Run Configurations.

Right click on Maven Build and select New.

Setup the new configuration to look like this.

In order to use this, automatic builds must be turned off, which can be done from the menus by deselecting Project > Build Automatically.

To execute this, select the project by left clicking on it, and then go to Run > Run Configurations, click on your configuration, and then click the Run button.

The build log should show up in the console window.

Building HPS Java

It will also be useful to setup a Run Configuration for building the entire trunk of HPS Java and not just a single module at a time.

This can be accomplished by creating a new Run Configuration which looks similar to this.

Notice that instead of an Eclipse variable pointing at the current project directory, the actual path to your HPS Java trunk is put under Base directory instead. 

The above is just an example from my machine.  The actual location will depend on wherever you checked it out in the first place.

When you click Run on this configuration, all of the modules will be installed and not just a single one.  This is useful for creating a new distribution jar with all your local changes included in it.