Project Setup

Requirements

Codegen requires the following software:

• Java 1.8
• Java JDK 8
• Apache Tomcat 8.0.36
• Eclipse IDE for Java EE Developers Neon, which should include:
  • Maven
  • EMF
  • Ant
  • JUnit
• Epsilon 1.3 JAR (kitchen sink)
• xmlparser.jar from my repository (download the release or build yourself)

Running Codegen

1. Import project into your Eclipse workspace.

• Add Epsilon and xmlparser JARs to /WebContent/WEB-INF/lib directory inside CodeGenerator project.
• Check that Maven has added the required dependancies.
• Setup Tomcat as a server, add CodeGenerator to the configured list.
• Create run configurations for each executable:
  • CodeGenerator should already be in the Tomcat config.
  • Client should be a Java Application.
  • All tests should be JUnit.
• Set environment variables, see the next section for more information.
• Test the project is working with the JUnit tests.

Environment Variables

Codegen relies on environment variables to link to directories specific to your setup, so they are not stored in the repository.

• gen_path is the directory where published generators will go.
• output_path is the directory where generated files will go.

Troubleshooting

Sometimes after restarting the server it refuses to work. Try one of the following:

• Restart Eclipse.
• Right click the Server and choose the Clean… option.
• Right click the Server and choose to monitor port 8080.