GATHER is a collection of java projects, build using Maven. This is a bare-essentials, command-line oriented guide to getting a developer environment set up.

Prerequisites

Subversion Repository

Component Description URL
base root url for the gather repository http://code.dimagi.com/svn/Gather/
gather-core basic model and interfaces http://code.dimagi.com/svn/Gather/gather/gather-core/
gather-sample-app an "interview" application which illustrates the gather form capture design pattern http://code.dimagi.com/svn/Gather/gather/gather-sample-app/
hmis-handler-jpa JAXB (from XML) and JPA (to persistence) handler for HMIS forms http://code.dimagi.com/svn/Gather/gather/hmis-handler-jpa/
gather-alert alert/notification component http://code.dimagi.com/svn/Gather/gather/gather-alert/
gather-service custom HMIS-oriented web application http://code.dimagi.com/svn/Gather/gather/gather-service/
pentaho-data HSQLDB server with schema for Gather/Pentaho http://code.dimagi.com/svn/Gather/pentaho/pentaho-data/
pentaho-solutions gather custom solutions for Pentaho http://code.dimagi.com/svn/Gather/pentaho/pentaho-solutions/
pentaho-style gather branding for Pentaho http://code.dimagi.com/svn/Gather/pentaho/pentaho-style/

Note: all the components have the usual trunk, branches, tags subdirectories

Recommended order

  1. BuildAndInstallGatherCore - the component needed by all the others
  2. InstallAndRunPentahoData - provides a data source for all components
  3. BuildAndInstallHmisHandlerJpa - provides roundtrip xml-to-object-to-persistence
  4. BuildAndRunGatherService - custom hmis web application

As Eclipse Project

Any maven project can be converted into an Eclipse project with one simple command line... 

mvn eclipse:eclipse

So, to create an Eclipse workspace for GATHER, follow these steps.

  1. Create a workspace directory
  2. check-out each GATHER component into a subdirectory of the workspace
  3. convert each project into an Eclipse project
  4. Launch Eclipse
  5. Use "Import... General->Existing Project Into Workspace" to populate the workbench with the projects