Using the ORDI framework in the Eclipse IDE

This tutorial will guide you in the process of setting up a workspace in Eclipse IDE that is configured to operate with the ORDI framework.

  • Install Maven

    ORDI requires Maven 2 to be installed. To check if you have already installed Maven 2 and its version simply type mvn -v. Installing Maven is easy, just follow the instructions provided on its official download site.

  • Update the version of ORDI

    Update the version of ORDI, that you would like to work with, in a specified local directory. The chosen directory will be also the root of the Eclipse workspace. In our demonstrative scenario the path S:\orditest\ is used. For more information how to update sources from SVN please check section Source Repository.

  • Generate Eclipse configuration files

    Run Maven Eclipse plugin with eclipse goal to generate all project related files and download the required dependencies:

    mvn eclipse:eclipse

  • Import the generated project description in the Eclipse IDE

    Start the Eclipse IDE and set the workspace path to point to the root directory of ORDI framework (in our case this is S:\orditest\). In the Package Explorer view select Import... (use Window > Show View > Package Explorer to open the Package Explorer view ) and choose General > Existing Projects into workspace.

    Start import wizard

    In the Import Projects wizard enter the path of the current Eclipse workspace (in our case it points to S:\orditest\) and press Finish.

    Complete import wizard
  • Configure the M2_REPO variable to point to the local Maven directory

    Right click any of the imported new projects and choose Build Path > Configure Build Path.... Select the Libraries tab and press the Add Variable... button.

    Configure Java Build Path

    Press the Configure Variables... button and then New... In the pop-up dialog window type M2_REPO for Name and browse to the directory of local Maven repository (under Linux ~/.m2/repository/ and under Windows %USERPROFILE%\.m2\repository\).

    NB: Because of unknown reasons the Eclipse IDE will complain about the path specified with an error message "Variable points to a folder: Use 'Extend...' to select an archive inside the folder". You can ignore the message by pressing Cancel and everything should work fine.

  • Set Eclipse to ignore SVN files

    For each project perform the following procedure to ignore the meta-data files used by SVN. Right click the project and choose Build Path > Configure Build Path.... Choose the Source tab and for each source folder expand the tree and select Excluded: (None). Press Edit... and under Exclusion patterns: press Add.. and type **//.svn//**. Press the Finish button to exit.