Revision as of 17:20, 12 June 2008

< To: Tigerstripe_Tutorials

NOTE THIS IS A DRAFT PAGE

This tutorial will show you how to configure Tigerstripe to run code generations in a headless environment. This will allow you to incorporate Tigerstripe's code generation functionality into a build chain using many of the commonly available build tools, specifically Maven 2.

Tigerstripe Installation

See the Tigerstripe Installation Tutorial page for instructions on installing the Tigerstripe Workbench.

Importing an Example Model

1. Download the sample Tigerstripe model project OrderManagement.zip.
2. Start Eclipse and then open the Tigerstripe Workbench perspective.
3. Import the sample project, OrderManagement.zip into the Tigerstripe Workbench.
   • Right click in the Tigerstripe Explorer pane and select "Import"
     
   • Select General -> Existing Projects into Workspace. Click "Next >"
     
   • Click "Select Archive File" and browse to the location of the sample model project .zip file. Click "Finish"
     
4. Verify that the project is in your Tigerstripe Explorer pane.
   

Installing Tigerstripe generators

Running a generation from the command line

Now that the Tigerstripe workbench is set up and the Tigerstripe generators have been installed and tested you can invoke a generation run from the command line. The Eclipse mechanism for running in a headless environment will be used to accomplish this.

The following command may be executed to invoke a headless generation:

eclipsec -nosplash -data <workspace> -application org.eclipse.tigerstripe.workbench.headless.tigerstripe <referenced projects> <generation project>

• <workspace> - The path of the workspace that contains the required projects
• <generation project> - The project that will be generated.
  • Defined as key/value pair: GENERATION_PROJECT=<PROJECT_PATH>
• <referenced projects> - The referenced projects required for generation
  
  • Defined as key/value pair: PROJECT_IMPORT=<PROJECT_PATH>

Running a generation from a Maven2 build