Nachrichtenmodell erstellen

In diesem Abschnitt wird die Erstellung des Nachrichtenmodells erläutert; der Abschnitt umfasst folgende Unterabschnitte:

Nachrichtendefinitionen erstellen

Zur Erstellung der Nachrichtendefinitionen müssen Sie zunächst Folgendes erstellen:

  1. Ein Nachrichtensatzprojekt und ein Nachrichtensatz; Sie finden entsprechende Informationen in den Abschnitten Nachrichtensatzprojekte und Nachrichtensätze - Übersicht der Dokumentation zu WebSphere Message Broker.
  2. Drei Nachrichtendefinitionsdateien; eine für jeden im Mustercode 'Video Rental' verwendeten Namensbereich. Entsprechende Informationen finden Sie in der Dokumentation zu WebSphere Message Broker unter Nachrichtendefinitionsdateien und Namensbereiche im Nachrichtenmodell.
  3. Eine Nachricht mit dem Namen 'Customer'

Im Folgenden wird die Erstellung der Nachrichtendefinitionen erläutert. Zu einigen Schritten gibt es ausführliche Erläuterungen, die Sie über den Link unterhalb des entsprechenden Schrittes abrufen können.

  1. Erstellen Sie einen neuen Nachrichtensatz namens 'Video', in einem Nachrichtensatzprojekt namens 'Video Message Sets'. Anweisungen hierzu finden Sie in der Dokumentation zu WebSphere Message Broker im Abschnitt Nachrichtensatz erstellen.
    1. Wählen Sie anschließend die Optionen für die Erstellung der physischen Formate CWF, XML und TDS aus. Dabei sollten Sie die Standardnamen verwenden (CWF1, XML1 und TDS1). Wenn Sie neue Nachrichtensatzprojekte mithilfe des Assistenten erstellen, wird gleichzeitig auch ein neuer Nachrichtensatz erstellt.
  2. Erstellen Sie im Projekt 'Video Message Sets' die folgenden Nachrichtendefinitionsdateien. Anweisungen hierzu finden Sie in der Dokumentation zu WebSphere Message Broker im Abschnitt Nachrichtendefinitionsdatei erstellen.
    1. Erstellen Sie eine Nachrichtendefinitionsdatei mit dem Namen 'Customer', und übernehmen Sie dabei die Standardwerte.
      Wenn Sie auf Fertigstellen klicken, wird in der Ansicht 'Brokerentwicklung' unter Video > (Standard) eine Datei mit dem Namen Customer.mxsd angezeigt.
    2. Erstellen Sie eine Nachrichtendefinitionsdatei mit dem Namen 'Address'.
      Klicken Sie auf Zielnamensbereiche verwenden. Geben Sie im Feld Namensbereich den Wert http://www.ibm.com.addressdetails und im Feld Präfix den Wert addr ein. Wenn Sie anschließend auf Fertigstellen klicken, wird unterhalb des Video-Nachrichtensatzes in der Brokerentwicklungsansicht der Namensbereich com.ibm.www.addressdetails angezeigt. Unter com.ibm.www.addressdetails wird eine Datei des Namens Address.mxsd angezeigt.
    3. Erstellen Sie eine Nachrichtendefinitionsdatei mit dem Namen Borrowed.
      Wählen Sie das Optionsfeld Zielnamensbereich verwenden aus. Geben Sie im Feld Namensbereich den Wert http://www.ibm.com.borroweddetails und im Feld Präfix den Wert brw ein. Wenn Sie anschließend auf Fertigstellen klicken, wird unterhalb des Video-Nachrichtensatzes in der Ressourcenentwicklungsansicht der Namensbereich www.ibm.com.borroweddetails angezeigt. Unter "borroweddetails" wird die Datei Borrowed.mxsd angezeigt.
  3. Überprüfen Sie die Einstellungen für den Namensbereich des Nachrichtensatzes:
    1. Klicken Sie in der Brokerentwicklungsansicht doppelt auf messageSet.mset, um diese Ressource zu öffnen.
    2. Klicken Sie im Nachrichtensatzeditor in der Eigenschaftenhierarchie auf XML1. Öffnen Sie den Teilbaum mit den Einstellungen zum Namenbereich. Sie können jetzt die Einstellungen sehen, die Sie in den vorigen Schritten vorgenommen haben.
  4. Fügen Sie der Nachrichtendefinitionsdatei 'Customer' eine neue Nachricht mit dem Namen 'Customer' hinzu. Die entsprechenden Anweisungen finden Sie in der Dokumentation zu WebSphere Message Broker unter Nachricht hinzufügen.
    Für die Nachricht wird automatisch ein komplexer Typ mit dem Namen 'ComplexType1' erstellt. Benennen Sie diesen komplexen Typ in CustomerType um.
    An dieser Stelle müssen den anderen Nachrichtendefinitionsdateien noch keine Nachrichten hinzugefügt werden. Elemente aus 'Address' und 'Borrowed' werden der Nachricht 'Customer' im folgenden Abschnitt hinzugefügt.

Elemente, Typen und Gruppen hinzufügen

Im Anschluss an die Erstellung der Nachrichtendefinitionen müssen Sie diesen Elemente, Typen und Gruppen hinzufügen. Fügen Sie zuerst den Nachrichtendefinitionen 'Address' und 'Borrowed' Elemente, Typen und Gruppen hinzu. Importieren Sie die Namensbereiche 'borroweddetails' und 'addressdetails' in den Standardnamensbereich. Diese Aktion ist erforderlich, damit die Elemente 'Borrowed' und 'Address' anschließend der Nachrichtendefinition 'Customer' hinzugefügt werden können.

Typen und Elemente können Ihrer Nachricht auf verschiedene Arten hinzugefügt werden; das Ergebnis wird davon nicht beeinflusst. Die hier angegebene Reihenfolge stellt eine Art der Nachrichtenerstellung dar. Wenn Sie die Elemente und Typen jedoch in der folgenden Reihenfolge hinzufügen, können Sie die Struktur der Nachricht erkennen.

Elemente und Typen zur Nachrichtendefinitionsdatei 'Address' hinzufügen

Wenn Sie Elemente und Typen zur Nachrichtendefinitionsdatei 'Address' hinzufügen möchten, müssen Sie ein globales Element mit dem Namen Address und anschließend einen lokalen komplexen Typ erstellen. Anschließend können Sie der Nachrichtendefinitionsdatei 'Address' weitere Elemente hinzufügen.

So erstellen Sie das globale Element 'Address' und anschließend einen lokalen komplexen Typ:

  1. Klicken Sie in der Ansicht 'Brokerentwicklung' doppelt auf Address.mxsd, um diese Ressource zu öffnen.
  2. Klicken Sie in der Entwurfsansicht mit der rechten Maustaste auf Elemente und Attribute und klicken Sie anschließend auf Globales Element hinzufügen. Daraufhin wird das Element 'globalElement1', dem der Typ 'Zeichenfolge' zugeordnet ist, hinzugefügt. Benennen Sie dieses Element in Address um.
  3. Markieren Sie im Nachrichtendefinitionseditor die Zeile, in der Adresse ('Address') angezeigt wird. Zugehörige Informationen finden Sie in der Dokumentation zu WebSphere Message Broker unter Nachrichtendefinitionseditor. Klicken Sie in der Spalte 'Typ' auf die Zelle mit dem Standardwert Zeichenfolge (STRING), um ein Menü mit den verfügbaren Typen anzuzeigen. Wählen Sie Neuer komplexer Typ aus. Die Eigenschaft "Lokalen komplexen Typ erstellen" ist standardmäßig ausgewählt.
  4. Klicken Sie auf OK. Jetzt wird in der Entwurfsansicht unter 'Address' der Typ {Local complexType} angezeigt.

Danach können Sie der Nachrichtendefinition 'Address' weitere Elemente hinzufügen. Erstellen Sie die Elemente, die in der folgenden Tabelle aufgeführt sind. Wenn Sie beispielsweise 'HouseNo' hinzufügen möchten, gehen Sie wie folgt vor:

  1. Klicken Sie mit der rechten Maustaste auf {Local complexType} und klicken Sie anschließend auf Lokales Element hinzufügen. Daraufhin wird unter {Local complexType} das Element 'localElement1' hinzugefügt. Ändern Sie den Namen dieses Elements in HouseNo.
  2. Markieren Sie im Nachrichtendefinitionseditor die Zeile, in der 'HouseNo' angezeigt wird. Klicken Sie in der Spalte 'Typ' auf die Zelle mit dem Standardwert Zeichenfolge (STRING), um ein Menü mit den verfügbaren Typen anzuzeigen. Wählen Sie int (Integer) aus.
Option Typ
HouseNo int
Street Zeichenfolge
Town Zeichenfolge

Elemente und Typen zur Nachrichtendefinitionsdatei 'Borrowed' hinzufügen

Wenn Sie Elemente und Typen zur Nachrichtendefinitionsdatei 'Borrowed' hinzufügen möchten, müssen Sie ein globales Element mit dem Namen 'Borrowed' und anschließend einen lokalen komplexen Typ erstellen. Fügen Sie dann die Elemente hinzu, die in der folgenden Tabelle aufgeführt sind. Befolgen Sie hierzu die Anweisungen des vorherigen Abschnitts.

Option Typ
VideoTitle Zeichenfolge
DueDate Datum/Zeit-Format
Cost Dezimal

Die Namensbereiche 'borroweddetails' und 'addressdetails' in den Standardnamensbereich importieren

Bevor Sie die Elemente 'Borrowed' und 'Address' (aus den Namensbereichen 'borroweddetails' und 'addressdetails') in die Kundennachricht (Customer) aufnehmen können, müssen Sie die Namensbereiche 'borroweddetails' und 'addressdetails' in den Standardnamensbereich wie folgt importieren:

  1. Klicken Sie in der Ansicht 'Brokerentwicklung' doppelt auf Customer.mxsd, um diese Ressource zu öffnen.
  2. Klicken Sie im Nachrichtendefinitionseditor auf Customer.mxsd und dann auf die Registerkarte Eigenschaften.
  3. Klicken Sie in der Eigenschaftenhierarchie mit der rechten Maustaste auf Importe und klicken Sie auf IMPORT-Anweisung hinzufügen. Daraufhin wird das Fenster 'Zu importierende Nachrichtendefinitionsdatei auswählen' geöffnet.
  4. Erweitern Sie die Baumstruktur bis hin zu Address.mxsd und klicken Sie auf Fertigstellen.

Wiederholen Sie die oben genannten Schritte für Borrowed.mxsd.

Die Dateien Address.mxsd und Borrowed.mxsd werden in der Eigenschaftenhierarchie unter 'Importe' angezeigt. Klicken Sie auf Address.mxsd und Borrowed.mxsd, um die jeweiligen Einstellungen aufzurufen. Im Feld Präfix wird der Wert angezeigt, den Sie bei der Erstellung der Nachrichtendefinitionsdatei im Feld Präfix angegeben haben. Im Feld Namensbereich wird der Wert angezeigt, den Sie im Feld Namensbereich angegeben haben.

Elemente, Typen und Gruppen zur Nachrichtendefinitionsdatei 'Customer' hinzufügen

Sie müssen der Nachrichtendefinitionsdatei jetzt Elemente, Typen und Gruppen hinzufügen. Anschließend werden Element-, Attribut- und Gruppenverweise auf Typen und Gruppen hinzugefügt.

Elemente, Typen und Gruppen hinzufügen

So fügen Sie Elemente, Typen und Gruppen hinzu:

  1. Klicken Sie in der Ansicht 'Brokerentwicklung' doppelt auf Customer.mxsd, um diese Ressource zu öffnen, und klicken Sie dann auf die Registerkarte Übersicht.
  2. Klicken Sie in der Entwurfsansicht mit der rechten Maustaste auf Typen und klicken Sie anschließend auf Komplexen Typ hinzufügen. Fügen Sie einen komplexen Typ mit dem Namen 'Namenstyp' hinzu.
  3. Klicken Sie mit der rechten Maustaste auf Gruppen und klicken Sie anschließend auf Gruppe hinzufügen. Fügen Sie eine Gruppe mit dem Namen 'IdGroup' hinzu.
  4. Klicken Sie mit der rechten Maustaste auf Elemente und Attribute und klicken Sie anschließend auf Globales Element hinzufügen. Fügen Sie die Elemente hinzu, die in der folgenden Tabelle aufgeführt sind, und ändern Sie die zugehörigen Typen entsprechend:
    1. Klicken Sie im Nachrichtendefinitionseditor auf die Registerkarte Übersicht.
    2. Markieren Sie die Zeile, in der das Element angezeigt wird.
    3. Klicken Sie in der Spalte 'Typ' auf die Zelle mit dem Standardwert Zeichenfolge (STRING), um ein Menü mit den verfügbaren Typen anzuzeigen. Wählen Sie dort den erforderlichen Typ aus. Neben den einfachen Typen (z. B. Zeichenfolge, Integer oder Boolescher Wert) enthält dieses Menü jetzt auch die komplexen Typen, die Sie in Schritt 3 hinzugefügt haben. Folglich können Sie jetzt den Typ des Elements 'Name' in 'Namenstyp' ändern. Um das Element 'NameType' hinzuzufügen, müssen Sie zunächst im Pulldown-Menü auf (Weitere...) klicken.
    Option Typ
    Title Zeichenfolge
    FirstName (Vorname) Zeichenfolge
    ID Zeichenfolge
    PassportNo (Reisepass-Nr.) Zeichenfolge
    DrivingLicenseNo (Führerschein-Nr.) Zeichenfolge
    CreditCardNo (Kreditkarten-Nr.) Zeichenfolge
    Name NameType
    Magazine Boolesch
  5. Klicken Sie mit der rechten Maustaste auf Elemente und Attribute und klicken Sie anschließend auf Globales Attribut hinzufügen. Fügen Sie das folgende globale Attribut hinzu:
    Globales Attribut Typ
    LastName (Nachname) Zeichenfolge

Element-, Attribut- und Gruppenverweise hinzufügen

So fügen Sie 'IdGroup' Elementverweise hinzu:

  1. Erweitern Sie in der Entwurfsansicht 'Gruppen'.
  2. Klicken Sie mit der rechten Maustaste auf IdGroup und klicken Sie anschließend auf Elementverweis hinzufügen. Fügen Sie Verweise auf die folgenden Elemente hinzu:

So fügen Sie 'NameType' Element- und Attributverweise hinzu:

  1. Erweitern Sie in der Entwurfsansicht 'Typen'.
  2. Klicken Sie mit der rechten Maustaste auf NameType und klicken Sie anschließend auf Elementverweis hinzufügen. Fügen Sie in der folgenden Reihenfolge Verweise für die folgenden Elemente hinzu:
    1. Title
    2. FirstName (Vorname)
  3. Klicken Sie mit der rechten Maustaste auf NameType und klicken Sie anschließend auf Attributverweis hinzufügen. Fügen Sie einen Verweis für das globale Attribut 'LastName' hinzu.

    Es spielt keine Rolle, an welcher Stelle unter 'NameType' das Attribut 'LastName' steht, da Attribute bei der Laufzeitverarbeitung nicht gleich behandelt werden wie Elemente.

Befolgen Sie die folgenden Anweisungen, um Element-, Attribut- und Gruppenverweise zu 'CustomerType' hinzuzufügen. Es ist wichtig, dass die Verweise in der hier dargestellten Reihenfolge hinzugefügt werden.

  1. Erweitern Sie in der Entwurfsansicht 'Typen'.
  2. Klicken Sie mit der rechten Maustaste auf CustomerType und klicken Sie anschließend auf Elementverweis hinzufügen. Fügen Sie Verweise auf die folgenden Elemente hinzu: Das Element 'addr:Address' stammt aus dem Namensbereich 'addressdetails'. Dieses Element können Sie zu 'CustomerType' hinzufügen, da Sie die Namensbereiche 'addressdetails' und 'borroweddetails' bereits in den Standardnamensbereich importiert haben. Dieser Elementverweis wird auf genau dieselbe Weise wie alle anderen Elementverweise hinzugefügt. Er hat jedoch ein Präfix, das von Ihnen bei der Erstellung der Nachrichtendefinitionsdatei für die Adresse über den Wert für die Namensbereichs-URI festgelegt wurde.
  3. Klicken Sie mit der rechten Maustaste auf CustomerType und klicken Sie anschließend auf Gruppenverweis hinzufügen. Fügen Sie einen Verweis für die folgende Gruppe hinzu:
  4. Klicken Sie mit der rechten Maustaste auf CustomerType und klicken Sie anschließend auf Elementverweis hinzufügen. Fügen Sie einen Verweis für die folgenden Elemente hinzu:

Wenn Sie alle hier aufgeführten Schritte ausgeführt und den Nachrichtendefinitionsdateien alle erforderlichen Elemente, Typen und Gruppen hinzugefügt haben, können Sie das Nachrichtenmodell konfigurieren.

Zurück zum Beginn des Mustercodes