The Mappings Language

Max Kramer edited this page Aug 31, 2017 · 2 revisions

The mappings language is intended to be used for maintaining elements of models of two modelling language consistent by defining so called mappings. These mappings specify metaclasses and conditions in a mostly enforcement-agnostic and bidirectional way. It is, however, possible to specify explicitly how conditions should be enforced or what should be enforced in which direction.

The overall semantics of a mapping is that all instances of the mapped metaclasses are to be checked after every change in any model of one modelling language in order to enforce conditions in models of the other modelling language.

A research prototype for the mappings language compiler is currently developed in the mappingsLanguage branch of the Vitruv-Framework github repository.

Further explanations of the concepts and goals of the mappings language can be found in chapter 7 of a PhD thesis.

Development Setup

First, get a clean new Eclipse Oxygen DSL Edition and install the following features from the Vitruvius update site:

  1. Vitruv Consistency Specification DSLs
  2. Vitruv Core Framework
  3. Vitruv Extension DSLs Runtime

(Its recommended to always also install the "Developer Resources" features which give you the source code in addition to the byte code :-)

Next, install the two metamodels that are used for testing the mappings language from the SDQ DemoMetamodels update site.

Finally, clone the Vitruv-Framework repo and checkout the mappingsLanguage branch. Import the following projects into your workspace:

  1. All projects with a name that starts with "tools.vitruv.dsls.mappings" (take care of the last s, without it you get an old prototype of the language)
  2. All projects with a name that starts with "tools.vitruv.dsls.mirbase"
  3. The two demo domain projects "" and ""
  4. The project with the platform code that is used by code generated for mappings: "tools.vitruv.extensions.dslsruntime.mappings"

Testing Setup

To test you changes to the mappings language, start a new Eclipse from your first Eclipse (Debug Configurations ...) and import the following projects into the workspace of this second Eclipse:

  1. tools.vitruv.demo.applications.addressesrecipients
  2. tools.vitruv.dsls.mappings.tests.addressesXrecipients
  3. tools.vitruv.framework.tests.util

Run or debug the "AddressesXRecipientsTestSuite" as a JUnit Plug-In Test. All tests should always pass!

Reintegrating Previous Work

To reintegrate the bidirectionalization technique for the previous mapping language prototype, which was presented in a paper and a technical report, you have to reuse the code of a branch of the old svn repository.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.