Building Geomajas GIS for webapp developers

Getting the source

What you need:

We use subversion for source version control, so 'll need a subversion client. Seeherefor more information on this. To build the software, we use maven. You'll need maven version 2.0.9 or above. See theApache Maven sitefor more information. We use a maven JAXB plugin that is not yet officially released. You can download it fromfrom the Glassfish JAXB project site. That site contains also a lot of information on how to install and use the plugin. If the information in the following sections doesn't make sense to you, we advise that you read up on subversion and, especially, on maven.

Get the Source Code:

To get the source code for release 1.3.1 do:

$ svn checkout https://svn.geomajas.org/majas/tags/1.4.0 geomajas

Building Geomajas using Maven

Goto to the majas-maven directory and run the install plugin.

Maven commands

$ cd majas-tutorial
$ mvn install

Maybe take a coffee now as this can take quite some time (depending on what jars you might already have in the repository)... After the build is done, the web application majas-tutorial-1.3.1.war should be available in the majas-tutorial/target folder. This is a regular web application which is self-consistent and can be deployed on a servlet engine like Tomcat 5.

Eclipse Integration

Maven can turn the source directories into eclipse projects. Turn the directory where you downloaded the source into a workspace, and define an Eclipse Classpath Variable "M2_REPO" to your local maven repository (usually $HOME/.m2/repository on Unix/Linux/Mac OS X and %HOME%\.m2\repository on Windows).
Also make sure that your java compiler level is 5.0 and turn of validation as it is way to strict on html pages.

Create Eclipse projects

It is now time to transform the directory-structure into an Eclipse project. To do this, go to the majas-tutorial directory (where you see the pom.xml file) and execute:

$ mvn eclipse:eclipse

After that you can import the projects into Eclipse

Import project into the workspace

In Eclipse use:File-> Import ... \-> General/Existing Projects into Workspace

That's it! You have now succesfully created a new Eclipse dynamic web project from the geomajas code.