Jump to: navigation, search

Difference between revisions of "Tigerstripe Headless Generation Tutorial"

(Installing the Generator)
(Installing the Generator)
Line 33: Line 33:
 
# Open the generator's configuration (ts-plugin.xml) for editing.<br>[[Image:Export1.gif]]
 
# Open the generator's configuration (ts-plugin.xml) for editing.<br>[[Image:Export1.gif]]
 
# From the Overview panel, Testing section, click the <code>Package and deploy this plugin</code>. Hyperlink.<br>[[Image:Export2.gif]]
 
# From the Overview panel, Testing section, click the <code>Package and deploy this plugin</code>. Hyperlink.<br>[[Image:Export2.gif]]
 +
# Click "OK" in the '''Deploy New Plugin''' dialog.
 +
# Click "OK" in the '''export-xml Plugin''' dialog.
 +
# Verify Generator installation.
  
 
=Running a Generation from the Command Line=
 
=Running a Generation from the Command Line=

Revision as of 14:45, 13 June 2008

< To: Tigerstripe_Tutorials

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"
      Import.gif
    • Select General -> Existing Projects into Workspace. Click "Next >"
      Import2.gif
    • Click "Select Archive File" and browse to the location of the sample model project .zip file. Click "Finish"
      Import3.gif
  4. Verify that the project is in your Tigerstripe Explorer pane.
    Import4.gif

Installing Tigerstripe Generators

Overview

Tigerstripe Generators are pluggable components that allow users to define rules and conventions for code that is generated from a Tigerstripe Model Project. Several generators are currently available, and in many cases, you may want to write your own. For more information on writing you own Tigerstripe Generators see Tigerstripe Tutorials, Code Generation.

Obtaining Tigerstripe Generators

The generator used in this tutorial is in the Tigerstripe CVS repository at:

:pserver:anonymous@dev.eclipse.org:/cvsroot/technology/org.eclipse.tigerstripe/generators/export-xml

Alternatively, it can be downloaded as a .zip file, export-xml.zip. If downloading the .zip file, follow the procedure described in the Importing an Example Model Section to import the project into your workspace.

Installing the Generator

  1. Open the generator's configuration (ts-plugin.xml) for editing.
    Export1.gif
  2. From the Overview panel, Testing section, click the Package and deploy this plugin. Hyperlink.
    Export2.gif
  3. Click "OK" in the Deploy New Plugin dialog.
  4. Click "OK" in the export-xml Plugin dialog.
  5. Verify Generator installation.

Running a Generation from the Command Line

Overview

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/syntax invokes 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 by the key/value pair: GENERATION_PROJECT=<PROJECT_PATH>
  • <referenced projects> - The referenced projects required for generation. Defined by the key/value pair: PROJECT_IMPORT=<PROJECT_PATH>

Run a headless model generation using the Tigerstripe Workbench

@echo off

REM Set below to match your current configuration
set ECLIPSE_HOME=C:\eclipse
set WORKSPACE=C:\workspace
set HEADLESS_PLUGIN=org.eclipse.tigerstripe.workbench.headless.tigerstripe
set PROJECT=GENERATION_PROJECT=%WORKSPACE%\OrderManagement

REM Use below to define referenced projects
REM set REFERENCE_ONE= PROJECT_IMPORT=%WORKSPACE%\ReferencedProjectOne
REM set REFERENCE_TWO= PROJECT_IMPORT=%WORKSPACE%\ReferencedProjectTwo

%ECLIPSE_HOME%\eclipsec -nosplash -data %WORKSPACE% -application %HEADLESS_PLUGIN% %PROJECT%
  1. Download wincmdline.zip (above) and unzip the .bat file in a handy location
  2. Verify that the .bat file parameters are set correctly for your system
  3. Execute the batch file to initiate model generation (Note: output may vary based on version)
    Bat.gif
  4. Verify generation by navigating to <workspace>OrderManagement\target\tigerstripe.gen\xml. Verify that OrderManagement.xml is a xml based representation of the example model
    Outdir.gif

Running a Generation from a Maven2 Build