Jump to: navigation, search

Difference between revisions of "Tigerstripe Buckminster Integration Tutorial"

(CSPEC)
(RMAP)
Line 30: Line 30:
 
If you are using the Tigerstripe perspective in Eclipse you will see the CoreModel, ReferencedModel, and VersionedModel projects. If you are in the Java perspective (or other) you will see the model projects noted above along with the ProjectDefinition project.
 
If you are using the Tigerstripe perspective in Eclipse you will see the CoreModel, ReferencedModel, and VersionedModel projects. If you are in the Java perspective (or other) you will see the model projects noted above along with the ProjectDefinition project.
 
====RMAP====
 
====RMAP====
This is the RMAP used in this tutorial. This is a standard RMAP file, with the exception of the "tigerstripe" component type. This component type is made available when the optional Tigerstripe Buckminster plug-in is installed.
+
The RMAP used in this tutorial is presented below. This is a standard RMAP file, with the exception of the "tigerstripe" component type. This component type is made available when the optional Tigerstripe Buckminster plug-in is installed.
  
 
For more information on RMAP files see the [[Introduction_to_Buckminster#Resource_Maps_.28RMAPs.29|Resource Maps section]] of the Buckminster Introduction.
 
For more information on RMAP files see the [[Introduction_to_Buckminster#Resource_Maps_.28RMAPs.29|Resource Maps section]] of the Buckminster Introduction.

Revision as of 16:31, 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" 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 project definition.
  • CoreModel - This is the base Tigerstripe model project for this tutorial. This model project will internally reference the ReferencedModel and the VersionedModel project.
  • ReferencedModel - This is a 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 referenced by the CoreModel project as described in the ReferencedModel entry above. Because we wish to specify a version, this component will be included 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.


Hierarchy Definition

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

Example

This section will describe how to materialize your Tigerstripe workspace and provide a description of the required Buckminster configuration files.

Running the Example

  1. Open Eclipse. Create a new workspace for this tutorial.
  2. Navigate to the File -> Open a Component Query... dialog and paste the CQUERY's URL into the dialogs "URL for query" text box.
    http://www.eclipse.org/tigerstripe/queries/tutorial.cquery
  3. Click "OK". This will open the Buckminster CQUERY Editor.
  4. Click "Resolve and Materialize" in the CQUERY Editor. This will materialize the project's components from this example into your workspace.

If you are using the Tigerstripe perspective in Eclipse you will see the CoreModel, ReferencedModel, and VersionedModel projects. If you are in the Java perspective (or other) you will see the model projects noted above along with the ProjectDefinition project.

RMAP

The RMAP used in this tutorial is presented below. This is a standard RMAP file, with the exception of the "tigerstripe" component type. This component type is made available when the optional Tigerstripe Buckminster plug-in is installed.

For more information on RMAP files see the Resource Maps section of the Buckminster Introduction.

<?xml version="1.0" encoding="UTF-8"?>
  <rmap
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://www.eclipse.org/buckminster/RMap-1.0"
    xmlns:bc="http://www.eclipse.org/buckminster/Common-1.0"
    xmlns:mp="http://www.eclipse.org/buckminster/MavenProvider-1.0"
    xmlns:pp="http://www.eclipse.org/buckminster/PDEMapProvider-1.0">
    <searchPath name="default">
      <provider readerType="cvs" componentTypes="tigerstripe,buckminster" source="true">
        <uri format=":pserver:anonymous@dev.eclipse.org:/cvsroot/technology,org.eclipse.tigerstripe/samples/Buckminster/{0}">
	  <bc:propertyRef key="buckminster.component" />
        </uri>
      </provider>
    </searchPath>
    <locator searchPathRef="default" pattern=".*" />
</rmap>

CSPEC

<?xml version="1.0" encoding="UTF-8"?>
<cs:cspec xmlns:cs="http://www.eclipse.org/buckminster/CSpec-1.0" 
  name="ProjectDefinition" 
  componentType="buckminster" 
  version="1.0.0" versionType="OSGi">
  <cs:dependencies>
    <cs:dependency name="CoreModel" componentType="tigerstripe"/>
    <cs:dependency name="VersionedModel" componentType="tigerstripe" versionDesignator="[3.0.0,3.0.0]" versionType="OSGi"/>
  </cs:dependencies>
</cs:cspec>