In order to be able to follow this tutorial, you have to have the following steps already been completed.

Goal is to develop a simple contact maintenance. The application will be able to handle person and address data.

Eclipse Workspace

As a preparation for the modeling and generation you need an Eclipse workspace with two projects. One project for the model and one project for the files that are going to be generated. A pre-assembled workspace can be downloaded here. That workspace includes the two projects, the model files, a few manually developed classes, a maven pom.xml file and an Eclipse launch-configuration, but not yet any generated files.

The following picture shows the two Eclipse projects in the package explorer.

<TODO Screenshot>


Essentially, two entities are going to be modeled: Person and Address. The example being used here is part of a bigger example that is used to develop an Android application with a full JEE application as a back-end. The data model in ContactsPersistence.gapp looks like this:

And the model file ContactsTypeAliases.gapp , in which the type aliases are defined, looks as follows. Further information related to type aliases can be found in the documentation for the DSL „Basic“ (on the Virtual Developer Website).



The generation is done with the Cloud-Connector for Eclipse. The steps are described here (TODO add link).

Execution of generated Code

In order to be able to execute the generated code, a few more manual steps are required:

  • Installation and start of a database. If you use JavaDB, you do not need to install anything since the JavaDB part of every Java SDK installation. You can start the JavaDB by means of the Eclipse External Tools Configuration. The tutorial workspace already contains a launch configuration for the JavaDB. You only need to adapt the path that points to your Java runtime in case you do not have set the JAVA_HOME environment variable.
  • In the database you create the database schema. To be able to do this, you find a manually written Java class in the tutorial workspace. Additionally, you find a launch-configuration that you can use to execute the named class in order to create the schema.
  • Once the schema is created, you can execute test classes by means of JUnit and develop your own unit-test code.