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
<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).
<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
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.
XMLNSC.Value XMLNSC.PCDataValue XMLNSC.CDataValue XMLNSC.HybridValue
XMLNSC.MixedContentRetainNone = 0x0000000000000000 XMLNSC.MixedContentRetainAll = 0x0001000000000000
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.
XMLNSC.Comment
XMLNSC.CommentsRetainNone = 0x0000000000000000 XMLNSC.CommentsRetainAll = 0x0002000000000000Beispiel:
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.
XMLNSC.ProcessingInstruction
XMLNSC.ProcessingInstructionsRetainNone = 0x0000000000000000 XMLNSC.ProcessingInstructionsRetainAll = 0x0004000000000000Beispiel:
DECLARE X BLOB ASBITSTREAM(InputRoot.XMLNSC.Data OPTIONS XMLNSC.ProcessingInstructionsRetainAll); ... CREATE LASTCHILD OF outputRoot PARSE(X OPTIONS XMLNSC.ProcessingInstructionsRetainNone);
Einen bestehenden Fluss migrieren
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;
<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
SET OutputRoot.XML.(XML.XmlDecl)*.(XML.Version)* = '1.0';
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.
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
Syntax- element | 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 |
SET OutputRoot.XMLNSC.(XMLNSC.DocumentType)BodyDocument.(XMLNSC.EntityDefinition)TestDef = 'Compact Tree Parser XML Test Module Version 1.0';
-- 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.
XMLNSC.MixedContentRetainNone XMLNSC.MixedContentRetainAll XMLNSC.CommentsRetainNone XMLNSC.CommentsRetainAll XMLNSC.ProcessingInstructionsRetainNone XMLNSC.ProcessingInstructionsRetainAllIm 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);