Difference between revisions of "Tigerstripe Buckminster Integration Tutorial"

Revision as of 12:50, 22 October 2008

< To: Tigerstripe_Tutorials

Prerequisites

• This tutorial will assume a working knowledge and installation of the Tigerstripe Workbench [1] and the Buckminster [2] Eclipse plug-ins.

Overview

The following is an overview of the Tigerstripe project that will be used in this tutorial. This project is composed of several components that will be materialized into an existing Eclipse workspace.

• ProjectDefinition - This is the "meta" buckminster project for this example. The dependencies defined in the CSPEC determine which components will make up the underlying model project. Note that in Phase II this meta project will no longer be required as version information can be gathered from a Tigerstripe component's reference definition.
• CoreModel - This is the base Tigerstripe model project for this tutorial. This model project will internally reference the ReferencedModel project.
• ReferencedModel - This is the Tigerstripe model project referenced by the CoreModel project described above. The presence of this model is required in an Eclipse workspace for the CoreModel project to build.
• VersionedModel - This is a Tigerstripe model project, as well. It will be included in the workspace via a CSPEC definition in the CoreModel project. This is currently the only mechanism for defining a version based inclusion for a Tigerstripe project. Phase II will allow specific versions to be defined in the Tigerstripe model project.

ProjectDefinition 
       | --> CoreModel
                 | --> ReferencedModel
       | --> VersionedModel

Run Example Materialization

CQUERY

A Component Query (CQUERY) is the file based input required by Buckminster to initiate the materialization process. For more information about the CQUERY see Buckminster Component Query.

Example CQUERY file:

<?xml version="1.0" encoding="UTF-8"?>
<cq:componentQuery 
  xmlns:cq="http://www.eclipse.org/buckminster/CQuery-1.0" 
  resourceMap="http://www.eclipse.org/tigerstripe/queries/tutorial.rmap">
    <cq:rootRequest 
      name="CoreReferencedProject" 
      componentType="tigerstripe" versionType="OSGi"/>
</cq:componentQuery>