Lerneinheit 7: Modell-in-Modell-Zuordnungsdeklaration erstellen und optimieren

Diese Lerneinheit zeigt, wie Sie im Zuordnungsmodell eine Modell-in-Modell-Zuordnungsdeklaration erstellen können. Diese Zuordnungsdeklaration enthält eine angepasste Zuordnungsregel, die bei der Ausführung der generierten Umsetzung ein Zielausgabemodell erstellt, dessen Name vom Quelleneingabemodell abgeleitet ist. Außerdem erfahren Sie in dieser Lerneinheit, wie Sie die Reihenfolge ändern können, in der die Umsetzung die Zuordnungsdeklarationen im Zuordnungsmodell verarbeitet.
Warum und wann dieser Vorgang ausgeführt wird

Zum Umbenennen des von der Umsetzung generierten Zielmodells können Sie eine angepasste Zuordnungsregel zwischen den Eingabe- und Ausgabeobjekten erstellen, statt eine Zuordnungsregel zwischen den Funktionen der Eingabe- und Ausgabeobjekte zu erstellen.

Gehen Sie wie folgt vor, um eine Modell-in-Modell-Zuordnungsdeklaration zu erstellen:

  1. Wenn das Zuordnungsmodell im Umsetzungszuordnungseditor nicht geöffnet ist, klicken Sie in der Sicht Paket-Explorer doppelt auf die .mapping-Datei im Ordner model.
  2. Klicken Sie im Umsetzungszuordnungseditor im Abschnitt Zuordnungsstamm mit der rechten Maustaste auf Generalize_Classes. Klicken Sie anschließend auf Zuordnung erstellen.
  3. Geben Sie im Fenster Neue Zuordnung in das Feld Zuordnungsname den Namen Model2Model ein und klicken Sie auf OK. Die Zuordnung wird in der Modellstruktursicht angezeigt und im Editorbereich unter Zuordnungsstamm geöffnet.

Ein- und Ausgabeobjekte zu Modell-in-Modell-Zuordnungsdeklaration hinzufügen

Warum und wann dieser Vorgang ausgeführt wird

Nach der Erstellung der Modell-in-Modell-Zuordnungsdeklaration müssen Sie ihm ein ein Eingabeobjekt und ein Ausgabeobjekt hinzufügen. In dieser Lerneinheit geben Sie ein Modell als Eingabe- und Ausgabeobjekt an.

Gehen Sie wie folgt vor, um der Modell-in-Modell-Zuordnungsdeklaration ein Eingabeobjekt und ein Ausgabeobjekt hinzuzufügen:

  1. Klicken Sie auf das Symbol für Eingabeobjekt hinzufügen. Dieses befindet sich in der Symbolleiste der von Ihnen bearbeiteten Zuordnung ganz links.
  2. Erweitern Sie im Fenster Eingabe hinzufügen im Teilfenster Element den Eintrag uml und klicken Sie auf Modell und auf OK.
  3. Klicken Sie auf das Symbol für Ausgabeobjekt hinzufügen. Dieses befindet sich in der Symbolleiste der von Ihnen bearbeiteten Zuordnung an zweiter Stelle von links.
  4. Erweitern Sie im Fenster Ausgabe hinzufügen im Teilfenster Element den Eintrag uml und klicken Sie auf Modell und auf OK.
  5. Klicken Sie auf Datei > Speichern.
Ergebnisse
Nun können Sie die Zuordnungsregeln zwischen den Eingabe- und Ausgabeobjekten definieren.

Angepasste Zuordnungsregel und Submap-Regel definieren

Warum und wann dieser Vorgang ausgeführt wird
In dieser Lerneinheit erstellen Sie die folgenden Zuordnungsregeln:
  • Eine angepasste Zuordnungsregel, die das von der Umsetzung generierte Zielmodell umbenennt.
  • Eine Submap-Regel, die die Umsetzung Package2PackageTransform aufruft, um die Pakete im Modell umzusetzen.

Gehen Sie wie folgt vor, um die Zuordnungsregeln in den Zuordnungsdeklarationen zu erstellen:

  1. Erstellen Sie eine angepasste Zuordnungsregel, die das Zielmodell umbenennt:
    1. Klicken Sie im Editorbereich auf das obere Ablagefach des Modelleingabeobjekts. Das gesamte Modelleingabeobjekt wird hervorgehoben.
    2. Ziehen Sie den Ziehpunkt des Modelleingabeobjekts auf das Modellausgabeobjekt.
    3. Klicken Sie im neuen Submap-Element auf den Abwärtspfeil und auf Benutzerdefiniert.
    4. Klicken Sie mit der rechten Maustaste auf das angepasste Element; klicken Sie anschließend auf In Eigenschaften anzeigen.
    5. Klicken Sie in der Sicht Eigenschaften auf der Registerkarte Details auf die Option Integriert.
    6. Geben Sie im Textbereich unterhalb des Felds Code unter der Methodensignatur den folgenden Code an, der die angepasste Zuordnungsregel bei der Ausführung der Umsetzung implementiert: Model_tgt.setName(Model_src.getName()+"TgtModel");
    7. Klicken Sie auf Anwenden.
    Anmerkung: Zum Umbenennen des generierten Zielmodells können Sie auch eine angepasste Zuordnungsregel zwischen dem Attribut name des Eingabeobjekts und des Ausgabeobjekts erstellen und denselben Code auf der Registerkarte Details angeben, statt eine Zuordnungsregel zwischen den Eingabe- und Ausgabeobjekten zu erstellen.
  2. Erstellen Sie eine Submap-Regel, die die in Lerneinheit 6: Paket-Paket-Zuordnungsdeklaration erstellen und optimieren erstellte Paket-Paket-Zuordnung aufruft:
    1. Ziehen Sie den Ziehpunkt der Funktion packagedElement auf das Attribut packagedElement im Modellausgabeobjekt.
    2. Klicken Sie mit der rechten Maustaste auf das neue Submap-Element; klicken Sie anschließend auf In Eigenschaften anzeigen.
    3. Wählen Sie in der Sicht Eigenschaften auf der Registerkarte Details in der Liste Zuordnung den Eintrag Package2Package aus.
  3. Klicken Sie auf Datei > Speichern.
Ergebnisse
Sie haben nun alle Zuordnungsdeklarationen und Zuordnungsregeln erstellt, die für dieses Lernprogramm benötigt werden. Jetzt können Sie die Verarbeitungsreihenfolge der Zuordnungsdeklarationen angeben.

Verarbeitungsreihenfolge der Zuordnungsdeklarationen ändern

Warum und wann dieser Vorgang ausgeführt wird

Sie können die Verarbeitungsreihenfolge von Zuordnungsdeklarationen in einem Zuordnungsmodell ändern. In der Modellstruktursicht werden die Zuordnungsdeklarationen in der Reihenfolge aufgelistet, in der diese bei der Ausführung des generierten Umsetzungscodes ausgeführt werden. Indem Sie die Verarbeitungsreihenfolge ändern, können Sie Verarbeitungsanweisungen für Eingabeobjekte angeben, die von einer weniger spezifischen Zuordnungsdeklaration verarbeitet und genutzt werden können.

Für dieses Lernprogramm geben Sie an, dass die generierte Umsetzung die Zuordnungsdeklarationen in der folgenden Reihenfolge verarbeitet:
  • Model2Model
  • Package2Package
  • Class2Class
  • Class2Interface
  • Operation2Operation
  • Parameter2Parameter
  • Primitive2Primitive
Anmerkung: In diesem Lernprogramm ist die Reihenfolge der Zuordnungsdeklarationen Model2Model und Package2Package am wichtigsten. Da bei der Ausführung der generierten Umsetzung ein Modell ein Paket ist, akzeptiert die Umsetzung Package2Package ein Modell oder ein Paket. Wenn die Umsetzung Package2Package in der Umsetzung als erste aufgelistet wird, verarbeitet und nutzt sie das Modelleingabeobjekt. In diesem Szenario verarbeitet die Umsetzung Model2Model das Modelleingabeobjekt nicht. Daher wird die angepasste Regel nicht ausgeführt, die Sie in der Umsetzung Model2Model erstellt haben.

Gehen Sie wie folgt vor, um die Verarbeitungsreihenfolge der Zuordnungsdeklarationen zu ändern:

  1. Falls die Modellstruktursicht nicht sichtbar ist, klicken Sie auf die Optionen Fenster > Sicht anzeigen > Ausrichtung.
  2. Klicken Sie in der Modellstruktursicht mit der rechten Maustaste auf die Zuordnungsdeklaration Model2Model; klicken Sie anschließend auf Ausführungsreihenfolge und auf Nach oben. Wiederholen Sie diesen Schritt, bis die Zuordnungsdeklaration Model2Model sich in der Liste ganz oben befindet.
  3. Wiederholen Sie Schritt 2 für die einzelnen Zuordnungsdeklarationen, bis die Reihenfolge der Zuordnungsdeklaration der obigen Listen entspricht.
  4. Klicken Sie auf Datei > Speichern.
Ergebnisse
Nun können Sie den Quellcode für die Umsetzung generieren.

Rückmeldung