Skip to content

Commit

Permalink
Update MDSL URL
Browse files Browse the repository at this point in the history
  • Loading branch information
stefan-ka committed Jun 17, 2020
1 parent 355c0cc commit 8b3446c
Show file tree
Hide file tree
Showing 5 changed files with 12 additions and 12 deletions.
2 changes: 1 addition & 1 deletion _docs/faqs.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ Have a look at the page [Language Semantic Model](/docs/language-model/). It int
The tactic DDD part of our DSL is based on the [Sculptor DSL](http://sculptorgenerator.org/). We provide a short introduction and examples how you can detail your bounded contexts on the pages [Aggregate](/docs/aggregate/) and [Tactic DDD Syntax](/docs/tactic-ddd/). If you are interested in more details and all features, we refer to the [Sculptor documentation](http://sculptorgenerator.org/documentation/advanced-tutorial).

### Which transformations can I apply to my CML model? Which generators are available?
Currently you can generate [Microservice Domain-Specific Language (MDSL)](https://socadk.github.io/MDSL/) (micro-)service contracts providing assistance regarding how your system can be implemented in an (micro-)service-oriented architecture, [Service Cutter](http://servicecutter.github.io/) input to get suggestions for service cuts or new bounded context, and you can generate UML ([PlantUML](http://plantuml.com/)) diagrams out of your CML. The following pages explain the generators in detail:
Currently you can generate [Microservice Domain-Specific Language (MDSL)](https://microservice-api-patterns.github.io/MDSL-Specification/) (micro-)service contracts providing assistance regarding how your system can be implemented in an (micro-)service-oriented architecture, [Service Cutter](http://servicecutter.github.io/) input to get suggestions for service cuts or new bounded context, and you can generate UML ([PlantUML](http://plantuml.com/)) diagrams out of your CML. The following pages explain the generators in detail:

* [Generate graphical Context Maps](/docs/context-map-generator/)
* [Generate PlantUML diagrams](/docs/plant-uml/)
Expand Down
8 changes: 4 additions & 4 deletions _docs/generators/generators.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ permalink: /docs/generators/
---

The Context Mapper generators provide transformations to derive graphical Context Maps, [PlantUML diagrams](http://plantuml.com/),
[Microservice Domain-Specific Langauge (MDSL)](https://socadk.github.io/MDSL/) (micro-)service contracts, and
[Microservice Domain-Specific Langauge (MDSL)](https://microservice-api-patterns.github.io/MDSL-Specification/) (micro-)service contracts, and
[Service Cutter](https://servicecutter.github.io/) input files from your CML context map. We also provide a [generic, template-based generator](/docs/generic-freemarker-generator/)
based on Freemarker which allows to generate arbitrary textual files.

Expand Down Expand Up @@ -52,11 +52,11 @@ Example class diagram (Cargo booking context):
<img src="/img/plantuml-cargo-booking-context.png" alt="Cargo Booking Context" width="500px">

## MDSL (Micro-)Service Contracts
With our [MDSL](https://socadk.github.io/MDSL/) generator you can generate (micro-)service contracts from your Context Maps (or, more precisely, from upstream bounded contexts that expose at least one aggregate that contains at least one operation in a service or entity).
With our [MDSL](https://microservice-api-patterns.github.io/MDSL-Specification/) generator you can generate (micro-)service contracts from your Context Maps (or, more precisely, from upstream bounded contexts that expose at least one aggregate that contains at least one operation in a service or entity).
The resulting contracts illustrate how you can derive (micro-)services from strategic DDD context maps and provide
assistance regarding how to implement your system as a (micro-)service-oriented architecture.

This is an examplary [MDSL](https://socadk.github.io/MDSL/) service contract for our
This is an examplary [MDSL](https://microservice-api-patterns.github.io/MDSL-Specification/) service contract for our
[insurance example](https://github.com/ContextMapper/context-mapper-examples/tree/master/src/main/cml/insurance-example):

<div class="highlight"><pre><span></span><span class="c">// Generated from DDD Context Map &#39;Insurance-Example_Context-Map.cml&#39; at 21.10.2019 17:48:52 CEST.</span>
Expand Down Expand Up @@ -101,7 +101,7 @@ This is an examplary [MDSL](https://socadk.github.io/MDSL/) service contract for
<span class="k">IPA</span>
</pre></div>

Learn more about the [MDSL](https://socadk.github.io/MDSL/) generator [here](/docs/mdsl/).
Learn more about the [MDSL](https://microservice-api-patterns.github.io/MDSL-Specification/) generator [here](/docs/mdsl/).

## Service Cutter Input Files
Find out how to produce Service Cutter input to calculate possible service cuts or new bounded contexts [here](/docs/service-cutter/):
Expand Down
10 changes: 5 additions & 5 deletions _docs/generators/mdsl.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@ permalink: /docs/mdsl/
---

## Introduction and Motivation
The [Microservices Domain Specific Language (MDSL)](https://socadk.github.io/MDSL/) is a [Domain-Specific Language (DSL)](https://en.wikipedia.org/wiki/Domain-specific_language) to specify (micro-)service contracts and data representations, jointly realizing the technical part of the [API Description](https://microservice-api-patterns.org/patterns/foundation/APIDescription) pattern from [Microservice API Patterns (MAP)](https://microservice-api-patterns.org/).
The [Microservices Domain Specific Language (MDSL)](https://microservice-api-patterns.github.io/MDSL-Specification/) is a [Domain-Specific Language (DSL)](https://en.wikipedia.org/wiki/Domain-specific_language) to specify (micro-)service contracts and data representations, jointly realizing the technical part of the [API Description](https://microservice-api-patterns.org/patterns/foundation/APIDescription) pattern from [Microservice API Patterns (MAP)](https://microservice-api-patterns.org/).

Our [MDSL](https://socadk.github.io/MDSL/) generator automatically produces (micro-)service contracts out of strategic
Our [MDSL](https://microservice-api-patterns.github.io/MDSL-Specification/) generator automatically produces (micro-)service contracts out of strategic
DDD context maps written in CML. The generator creates the contracts according to the following mapping, which reflects our proposal
how we would derive (micro-)services from models based on strategic DDD <!-- (submitted for SummerSoC 2020) -->. The generator aims at providing assistance regarding how your system can be implemented as a (micro-)service-oriented architecture.

Expand Down Expand Up @@ -55,12 +55,12 @@ MDSL data type result:
</pre></div>

All abstract data types that are not base types and not specified in CML (no references to objects) will produce an abstract,
unspecified placeholder element `P` in [MDSL](https://socadk.github.io/MDSL/), as the following example illustrates:
unspecified placeholder element `P` in [MDSL](https://microservice-api-patterns.github.io/MDSL-Specification/), as the following example illustrates:
<div class="highlight"><pre><span></span><span class="k">data type</span> JustAnUnspecifiedParameterType <span class="k">P</span>
</pre></div>

## Example
An exemplary API description in [MDSL](https://socadk.github.io/MDSL/), generated by Context Mapper, is:
An exemplary API description in [MDSL](https://microservice-api-patterns.github.io/MDSL-Specification/), generated by Context Mapper, is:
<div class="highlight"><pre><span></span><span class="c">// Generated from DDD Context Map &#39;Insurance-Example_Context-Map.cml&#39; at 21.10.2019 17:48:52 CEST.</span>
<span class="k">API description</span> CustomerManagementContextAPI
<span class="k">usage context</span> <span class="k">PUBLIC_API</span> <span class="k">for</span> <span class="k">BACKEND_INTEGRATION</span>
Expand Down Expand Up @@ -257,4 +257,4 @@ For example, you can move a set of _data types_ into the corresponding protected
</pre></div>

## MDSL Support
The current version of our MDSL generator is compatible with the MDSL version _3.1.1_. For further questions regarding [MDSL](https://socadk.github.io/MDSL/), please visit its website [https://socadk.github.io/MDSL](https://socadk.github.io/MDSL).
The current version of our MDSL generator is compatible with the MDSL version _3.1.1_. For further questions regarding [MDSL](https://microservice-api-patterns.github.io/MDSL-Specification/), please visit its website [https://microservice-api-patterns.github.io/MDSL-Specification/](https://microservice-api-patterns.github.io/MDSL-Specification/). There you can also find the update site to install the MDSL plugin in Eclipse.
2 changes: 1 addition & 1 deletion _docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ currently offer the following generators:

* Graphical Context Map [generator](/docs/context-map-generator/) based on Graphviz (supported formats: .png, .cvg., .dot),
* [PlantUML](http://plantuml.com/) component and class diagram [generator](/docs/plant-uml/)
* [Microservice Domain-Speciifc Language (MDSL)](https://socadk.github.io/MDSL/) (micro-)service contracts [generator](/docs/mdsl/)
* [Microservice Domain-Speciifc Language (MDSL)](https://microservice-api-patterns.github.io/MDSL-Specification/) (micro-)service contracts [generator](/docs/mdsl/)
* [Service Cutter](http://servicecutter.github.io/) input files [generators](/docs/service-cutter/)
* [Generic Textual Generator based on Freemarker Templates](/docs/generic-freemarker-generator/)

Expand Down
2 changes: 1 addition & 1 deletion project-background.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ and details about our projects in the papers listed below.
* [Slides](/media/ZIOSK-ContextMapper4JUGv10p.pdf)
* Stefan Kapferer: **[Service Decomposition as a Series of Architectural Refactorings](https://eprints.hsr.ch/784/)**, student research project
* **Term project on which the [Architectural Refactorings (ARs)](/docs/architectural-refactorings/) and the [MDSL generator](/docs/mdsl/) of Context Mapper are based on.**
* (see [Microservices Domain-Specific Language (MDSL)](https://socadk.github.io/MDSL/) for language details on MDSL)
* (see [Microservices Domain-Specific Language (MDSL)](https://microservice-api-patterns.github.io/MDSL-Specification/) for language details on MDSL)
* [Project report](https://eprints.hsr.ch/784/)
* [Abstract](/media/FS19-MSE-Stefan-Kapferer-Service-Decomposition-Architectural-Refactorings-Abstract.pdf)
* Olaf Zimmermann: **[Domain-Specific Service Decomposition with Microservices API Patterns](https://www.conf-micro.services/2019/slides//keynotes/Zimmerman.pdf)**,
Expand Down

0 comments on commit 8b3446c

Please sign in to comment.