3.5 Running GreenPages from Eclipse
Prev 3. Installing and exploring GreenPages Next

3.5 Running GreenPages from Eclipse

Using Eclipse and the dm Server tools, it is possible to run applications directly from the IDE. As changes are made to the application in the IDE, they can be automatically applied to the running application allowing for rapid feedback of changes in function.

Importing the GreenPages projects into Eclipse

Before the GreenPages application can be started from Eclipse, the projects need to be imported. To import the projects into Eclipse:

  1. Open the Import Wizard using File → Import.

  2. From the Import Wizard select General → Existing Projects into Workspace and click Next:

  3. Click Browse… and select $GREENPAGES_HOME/solution as the root directory.

  4. In the Import Projects window, select all the projects and click Finish:

  5. Validate that the imported projects appear in Package Explorer:

    There may be compilation errors at this stage.

Configuring dm Server target runtime

Projects for dm Server are associated with a dm Server runtime environment in Eclipse. This is to allow launching and testing from within Eclipse, and also to allow classpath construction in Eclipse to mirror the dynamic classpath in the dm Server runtime.

Compilation errors in the previous step will be resolved here.

To configure a dm Server runtime environment:

  1. Open Window → Show View → Other….

  2. In the Show View dialog choose Server → Servers to make the servers view visible:

  3. Right-click in the (empty) Servers view and select New → Server.

  4. In the New Server dialog, choose SpringSource → SpringSource dm Server v1.0 and click Next.

  5. Click Browse and select the $DMS_HOME directory. Click Finish to complete creation of the server:

  6. Close and reopen all projects. Select all projects in Package Explorer. Right-click on the projects and choose Close Project and then Open Project.

It is possible that there remain spurious build errors from Eclipse (see the Problems view), in which case a project clean build may clear the problems. Select Project → Clean… from the main menu, and choose to Clean all projects. This process is known as the “Eclipse dance”. It may be necessary to repeat this on a few projects.

Despite the dance steps outlined, there will remain a Warning like this:

It is safe to ignore this warning.

Running GreenPages from within Eclipse

Now that GreenPages is successfully imported into Eclipse, the project can be run directly from within the IDE. Before doing so, remove a GreenPages PAR that may currently be deployed in dm Server.

To run GreenPages from within Eclipse:

  1. Drag the greeenpages PAR project from the Package Explorer onto the dm Server node in the Servers window:

  2. To start dm Server from within Eclipse right-click on the dm Server node in the Servers window and choose Start.

  3. Verify that GreenPages is installed correctly by checking for <SPDE0010I> Deployment of 'greenpages' version '1' completed in the Console window.

Prev Up Next
3.4 Browsing the GreenPages application Home 4. The Web Module