Nachrichten unter Verwendung des XMLNSC-Parsers bearbeiten

Bei der Domäne XMLNSC handelt es sich um eine Erweiterung der Domäne XMLNS, die wiederum eine Erweiterung der ursprünglichen Domäne XML ist.

Die Domäne XMLNS dient der Unterstützung von Namespaces, und aus Gründen der Kompatibilität wurde eine neue Domäne erstellt, damit die bereits vorhandenen Anwendungen nicht beeinträchtigt werden. Die neue Domäne XMLNSC wurde für die Erstellung einer kompakteren Baumstruktur entwickelt, damit bei der Handhabung umfangreicher Nachrichten weniger Speicher benötigt wird. Auch hier wurde aus Gründen der Kompatibilität eine neue Domäne hinzugefügt, damit bestehende Anwendungen nicht beeinträchtigt werden.

Nachrichtenbaumstruktur

Der Parser XMLNSC erhält seine kompaktere Baumstruktur durch die Verwendung eines einzelnen Elements des Typs 'Name-Wert', mit dem codierter Text dargestellt wird. Dies steht im Gegensatz zu den separaten Namens- und Wertelementen, die von den Parsern XML und XMLNS verwendet werden. Beachten Sie folgende Nachricht:
<Folder1>
<Folder2 Attribute1='AttributeValue1'>
<Field1><Value1></Field1>
<Field2 Attribute2='AttributeValue2'><Value2></Field2>
</Folder2>
</Folder1>

In der XMLNSC-Domäne wird dies durch zwei Namenselemente (Folder1 und Folder2) sowie vier Elemente des Typs 'Name-Wert' dargestellt (Attribute1, Field1, Field2 und Attribute2).

Die Domänen XML und XMLNS unterscheiden sich darin, dass die beiden Felder jeweils durch ein Namenselement mit einem untergeordneten Wertelement dargestellt werden. Dieser Unterschied erscheint zwar nur gering, häufig verfügen Nachrichten jedoch über solche Feldverzweigungen. Beispiel:
<Folder1>
<Folder2>
<Field1><Value1></Field1>
<Field2><Value2></Field2>
....
<Field100><Value100></Field100>
</Folder2>
</Folder1>

In diesem Fall stellt der XMLNSC-Parser die Nachricht durch zwei Namenselemente und 100 Elemente des Typs 'Name-Wert' dar, während die Parser XML und XMLNS 102 Namens- und 100 Wertelemente sowie weitere 103 Wertelemente für die Darstellung der in den formatierten Nachrichten implizierten Leerzeichen verwenden.

Attribute und codierter Text

Da sowohl Attribute als auch codierter Text durch Elemente des Typs 'Name-Wert' dargestellt werden, unterscheiden sie sich durch die Verwendung der Elementtypen. Wenn Sie keinen Typ angeben, wird von einem codierten Text ausgegangen. Daher könnte die erste Beispielnachricht oben durch folgende SQL-Anweisungen generiert worden sein:
SET Origin.Folder1.Folder2.(XMLNSC.Attribute)Attribute1 = 
'AttributeValue1';
SET Origin.Folder1.Folder2.Field1 = ‘Value1’;
SET Origin.Folder1.Folder2.(XMLNSC.Attribute)Attribute2 = 
'AttributeValue2';
SET Origin.Folder1.Folder2.Field2 = ‘Value2’;

Der vorhergehende SQL-Code scheint zwar nahezu identisch mit dem Code, der beim XML-Parser verwendet würde, die verwendeten Typkonstanten gehören jedoch zum Parser XMLNSC. Die Verwendung von Konstanten, die zu anderen Parsern gehören (beispielsweise zum XML-Parser) führt zu unerwarteten Ergebnissen, da ähnlich benannte Konstanten (beispielsweise XML.Attribute) andere Werte aufweisen.

Handhabung von gemischtem Text

Vorhandener gemischter Text wird standardmäßig gelöscht, da davon ausgegangen wird, dass er lediglich der Formatierung dient und keine sonstige Bedeutung hat.

Es wurde jedoch ein Modus bereitgestellt, bei dem während der Syntaxanalyse jeglicher Text, der sich nicht zwischen einem DTL-Anfangs- und Endbefehl befindet (d. h. zwischen open->open, close->close und close->open), durch ein einzelnes Wert-Element dargestellt wird. Die Wertelementtypen unterstützen PCDATA, CDATA sowie eine Mischform dieser beiden.

Bezüglich des Abrufs und der Festlegung von Werten gibt es nach wie vor kein spezielles Verhalten des Syntaxelements. Der SQL-Code kann nur durch eine explizite Adressierung auf Elemente des Typs Wert (Value) zugreifen. Hierfür wurden die folgenden zusätzlichen Konstanten bereitgestellt:
XMLNSC.Value
XMLNSC.PCDataValue
XMLNSC.CDataValue
XMLNSC.HybridValue
Der Modus wird durch neue Nachrichtenoptionswerte gesteuert. Zu diesem Zweck werden die folgenden Konstanten bereitgestellt:
XMLNSC.MixedContentRetainNone = 0x0000000000000000
XMLNSC.MixedContentRetainAll  = 0x0001000000000000
Diese Konstanten können in den Klauseln Option sowohl des SQL-Codes CREATE-Anweisung (PARSE-Abschnitt) als auch Funktion ASBITSTREAM verwendet werden. Beispiel:
DECLARE X BLOB ASBITSTREAM(InputRoot.XMLNSC.Data OPTIONS 
XMLNSC.MixedContentRetainAll);
...
CREATE LASTCHILD OF outputRoot PARSE(X OPTIONS 
XMLNSC.MixedContentRetainNone);

Handhabung von Kommentaren

Vorhandene Kommentare werden ebenfalls standardmäßig gelöscht, da davon ausgegangen wird, dass es sich dabei lediglich um zusätzliche Informationen ohne besondere Bedeutung handelt.

Es wird jedoch ein Modus bereitgestellt, bei dem während der Syntaxanalyse alle Kommentare im Dokument (mit Ausnahme der Kommentare in der Dokumentbeschreibung selbst) durch ein Element des Typs 'Name-Wert' mit dem Namen Comment (Kommentar) dargestellt werden. Hierfür wurde folgender zusätzlicher Kommentar bereitgestellt.
XMLNSC.Comment
Der Modus wird durch neue Nachrichtenoptionswerte gesteuert. Hierfür wurden die folgenden Konstanten bereitgestellt:
XMLNSC.CommentsRetainNone = 0x0000000000000000
XMLNSC.CommentsRetainAll  = 0x0002000000000000
Beispiel:
DECLARE X BLOB ASBITSTREAM(InputRoot.XMLNSC.Data OPTIONS 
XMLNSC.CommentsRetainAll);
...
CREATE LASTCHILD OF outputRoot PARSE(X OPTIONS XMLNSC.CommentsRetainNone);

Handhabung von Verarbeitungsanweisungen

Vorhandene Verarbeitungsanweisungen werden ebenfalls standardmäßig gelöscht, da davon ausgegangen wird, dass es sich dabei lediglich um zusätzliche Informationen ohne besondere Bedeutung handelt.

Es wird jedoch ein Modus bereitgestellt, bei dem während der Syntaxanalyse alle Verarbeitungsanweisungen im Dokument (mit Ausnahme der Verarbeitungsanweisungen in der Dokumentbeschreibung selbst) durch ein Element des Typs 'Name-Wert' mit dem entsprechenden Namen und Wert dargestellt werden. Hierfür wurden die folgenden zusätzlichen Konstanten bereitgestellt:
XMLNSC.ProcessingInstruction
Der Modus wird durch neue Nachrichtenoptionswerte gesteuert. Hierfür wurden die folgenden Konstanten bereitgestellt:
XMLNSC.ProcessingInstructionsRetainNone = 0x0000000000000000
XMLNSC.ProcessingInstructionsRetainAll  = 0x0004000000000000
Beispiel:
DECLARE X BLOB ASBITSTREAM(InputRoot.XMLNSC.Data 
OPTIONS XMLNSC.ProcessingInstructionsRetainAll);
...
CREATE LASTCHILD OF outputRoot PARSE(X OPTIONS 
XMLNSC.ProcessingInstructionsRetainNone);

Einen bestehenden Fluss migrieren

Auf Grund der Tatsache, dass eine neue Domäne eingeführt wurde, müssen Sie Ihren ESQL-Code bei Verwendung des Parsers XMLNSC neu codieren, damit XMLNSC in Ihren Pfaden enthalten ist. Beachten Sie folgende Beispiele:
SET OutputRoot.XML.Person.Salary    = CAST(InputRoot.XML.Person.Salary AS INTEGER) * 3;
SET OutputRoot.XMLNS.Person.Salary  = CAST(InputRoot.XMLNS.Person.Salary AS INTEGER) * 3;
SET OutputRoot.XMLNSC.Person.Salary = CAST(InputRoot.XMLNSC.Person.Salary AS INTEGER) * 3;
In all diesen Fällen hat der XML-Bitstrom, der in der Empfangswarteschlange erwartet und in die Ausgabewarteschlange geschrieben wird, folgendes Format:
<Person><Salary>42</Salary></Person>

Die drei Fälle unterscheiden sich darin, dass sie für den Eigner dieser Elemente verschiedene Parser verwenden. Daher wird im Header MQRFH2 der eingehenden Nachricht ein anderer Domänenname erwartet, und in den Header MQRFH2 der abgehenden Nachricht wird ein anderer Domänenname geschrieben.

Damit externe Anwendungen vor diesen Änderungen geschützt sind, kann die Eigenschaft XMLNSC-Kompaktparser für XMLNS-Domäne verwenden auf dem Empfangsknoten des Flusses sowie auf dem Rechenknoten mit diesen Anweisungen angegeben werden.

Im ersten Beispiel wird der XMLNSC-Parser zur Syntaxanalyse des Nachrichtenhauptteils verwendet, wenn im MQRFH2-Header der eingehenden Nachricht die Domäne XMLNS angegeben ist; dadurch wird auf dem Rechenknoten im MQRFH2-Header der abgehenden Nachricht der Parser XMLNS anstelle des Parsers XMLNSC angegeben. Dies bedeutet, dass die Ein- und Ausgabenachrichten nicht geändert werden müssen.

Wenn die eingehenden Nachrichten keine MQRFH2-Header enthalten und das Nachrichtendomänenattribut des Empfangsknotens für die Angabe der Domäne verwendet wird, können Sie es es entweder auf XMLNSC setzen, oder auf XMLNS, wobei Sie in diesem Fall darüber hinaus die Eigenschaft XMLNSC-Kompaktparser für XMLNS-Domäne verwenden festlegen müssen.

Wenn die abgehenden Nachrichten keine MQRFH2-Header enthalten, wird die Domäne in den Ausgabenachrichten nirgends angezeigt, und die Festlegung der Eigenschaft XMLNSC-Kompaktparser für XMLNS-Domäne verwenden des Rechenknotens hat keine Auswirkungen.

XML-Header erstellen

Der folgende ESQL-Code ist in der XML-Domäne gültig:
SET OutputRoot.XML.(XML.XmlDecl)*.(XML.Version)* = '1.0';
Zur Migration von XMLNS müssen Sie lediglich das Stammverzeichnis (die Root) ändern:
SET OutputRoot.XMLNS.(XML.XmlDecl)*.(XML.Version)* = '1.0';

Hinweis: Auch wenn der Parser XMLNS verwendet wird, gehören die Elementtyp-Konstanten zum Parser XML. Diese Vorgehensweise funktioniert, weil die von den Parsern XML und XMLNS verwendeten Typwerte identisch sind. Beim Parser XMLNSC unterscheiden sich die Typwerte jedoch und müssen daher immer die eigenen Typkonstanten verwenden.

In der XMLNSC-Domäne gibt es keinen besonderen Typ für die XML-Version; sie wird lediglich als Attribut der XML-Deklaration verwendet. Die funktional entsprechende Syntax für obiges Beispiel lautet wie folgt:
SET OutputRoot.XMLNSC.(XMLNSC.XmlDeclaration)*.(XMLNSC.Attribute)Version = '1.0';

Nachrichtenbaumstrukturen kopieren

Beim Kopieren von Baumstrukturen betrachtet der Broker XML und XMLNSC als ungleiche Parser. Dies bedeutet, dass alle Attribute in der Quellenbaumstruktur Elementen in der Zielbaumstruktur zugeordnet werden. Diese Situation entsteht nur, wenn Sie beide Parser in demselben Fluss verwenden - einen für die Eingabe, den anderen für die Ausgabe. Aus diesem Grund wird empfohlen, für beide Flüsse den kompakten Parser zu verwenden.

Wenn für den Eingabe- und Ausgabefluss verschiedene Parser verwendet werden müssen, kann die explizite Angabe der Elementtypen in den Pfaden oder die Verwendung der Funktion FIELDVALUE erforderlich sein, damit anstelle der untergeordneten Baumstrukturen eine Kopie der Skalarwerte gewährleistet ist.

Halten Sie sich an die Richtlinien für XML-Nachrichten, die im Abschnitt Nachrichten in der XML-Domäne bearbeiten genannt werden, sowie an die Informationen im Abschnitt Inhalt des Hauptteils einer Nachricht bearbeiten.

Mit Hilfe von Korrelationsnamen auf Syntaxelemente in der XMLNSC-Domäne zugreifen

Die folgende Tabelle enthält die Korrelationsnamen der einzelnen XML-Syntaxelemente. Verwenden Sie bei der Arbeit in der XMLNSC-Domäne diese Namen, um in Eingabenachrichten auf die Elemente zu verweisen und in Ausgabenachrichten Elemente, Attribute und Werte festzulegen.
Tabelle 1. Korrelationsnamen für XML-Syntaxelemente
Syntaxelement Korrelationsname Konstanter Wert
Ordner XMLNSC.Folder 0x01000000
Dokumenttyp 1 XMLNSC.DocumentType 0x01000300
XML-Deklaration 2 XMLNSC.XmlDeclaration 0x01000400
     
Feld- oder Attributwert XMLNSC.Value 0x02000000
PCData value XMLNSC.PCDataValue 0x02000000
CData value XMLNSC.CDataValue 0x02000001
Hybridwert XMLNSC.HybridValue 0x02000002
     
Einheitenverweis XMLNSC.EntityReference 0x02000100
     
Feld XMLNSC.Field 0x03000000
PCData XMLNSC.PCDataField 0x03000000
CData XMLNSC.CDataField 0x03000001
Hybrid XMLNSC.HybridField 0x03000002
     
Attribut XMLNSC.Attribute 0x03000100
Einfaches Anführungszeichen XMLNSC.SingleAttribute 0x03000101
Doppeltes Anführungszeichen XMLNSC.DoubleAttribute 0x03000100
     
Namespacedeklaration XMLNSC.NamespaceDecl 0x03000102
Einfaches Anführungszeichen XMLNSC.SingleNamespaceDecl 0x03000103
Doppeltes Anführungszeichen XMLNSC.DoubleNamespaceDecl 0x03000102
     
Bitstromdaten XMLNSC.BitStream 0x03000200
     
Einheitendefinition 1 XMLNSC.EntityDefinition 0x03000300
Einfaches Anführungszeichen XMLNSC.SingleEntityDefinition 0x03000301
Doppeltes Anführungszeichen XMLNSC.DoubleEntityDefinition 0x03000300
     
Kommentar XMLNSC.Comment 0x03000400
     
Verarbeitungsanweisung XMLNSC.ProcessingInstruction 0x03000401
Hinweise:
  1. Dokumenttyp wird nur für Einheitendefinitionen verwendet. Beispiel:
    SET OutputRoot.XMLNSC.(XMLNSC.DocumentType)BodyDocument.(XMLNSC.EntityDefinition)TestDef =
    		          'Compact Tree Parser XML Test Module Version 1.0';
  2. Beachten Sie, dass es sich bei der XML-Deklaration um einen speziellen Ordnertyp handelt, der untergeordnete Elemente für die Version, etc. enthält. Beispiel:
    -- XML-Deklaration erstellen 		
    SET OutputRoot.XMLNSC.(XMLNSC.XmlDeclaration)*.Version = 1.0;
    SET OutputRoot.XMLNSC.(XMLNSC.XmlDeclaration)*.Encoding = 'UTF8';
    SET OutputRoot.XMLNSC.(XMLNSC.XmlDeclaration)*.Standalone = 'yes';

Modi für XMLNSC-Parser

Standardmäßig löscht der XMLNSC-Parser Dokumentelemente, die normalerweise keine geschäftliche Bedeutung haben. Es sind jedoch Parsermodi verfügbar, die die Sicherung dieser Elemente erzwingen. Sie können diese Modi auf den Eigenschaften des Knotens konfigurieren, der angibt, dass die Nachricht in der XMLNSC-Domäne analysiert wird.

Für den XMLNSC-Parser sind folgende Parsermodi gültig:
XMLNSC.MixedContentRetainNone
XMLNSC.MixedContentRetainAll
XMLNSC.CommentsRetainNone
XMLNSC.CommentsRetainAll
XMLNSC.ProcessingInstructionsRetainNone
XMLNSC.ProcessingInstructionsRetainAll
Im folgenden Beispiel werden die Modi XMLNSC.ProcessingInstructionsRetainAll und XMLNSC.ProcessingInstructionsRetainNone verwendet, um die Anweisungen zur Dokumentverarbeitung bei der Syntaxanalyse zu erhalten:
DECLARE X BLOB ASBITSTREAM(InputRoot.XMLNSC.Data OPTIONS XMLNSC.ProcessingInstructionsRetainAll);
...
CREATE LASTCHILD OF outputRoot PARSE(X OPTIONS XMLNSC.ProcessingInstructionsRetainNone);
Zugehörige Konzepte
Nachrichtenflüsse - Übersicht
XML-Parser und -Domänen
Übersicht zu ESQL
Zugehörige Tasks
Nachrichtenfluss entwerfen
Nachrichtenflussinhalt definieren
Nachrichten in der XML-Domäne bearbeiten
Zugehörige Verweise
ESQL-Referenz
SET-Anweisung
Funktion FIELDVALUE
Funktion ASBITSTREAM
CREATE-Anweisung
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 18.05.2006
ac26040_