XMLNSC: Namespacedeklarationen

Namespaces werden vom XMLNSC-Parser vollständig unterstützt.

Der Parser setzt bei der Syntaxanalyse einer Nachricht in jedem von ihm erstellten Syntaxelement den korrekten Namespace; er speichert die Namespacedeklarationen in der Nachrichtenbaumstruktur und wählt bei der Ausgabe der Nachrichtenbaumstruktur anhand dieser Deklarationen die entsprechenden Präfixe aus.

Der XMLNSC-Parser verwendet für die Darstellung von Namespacedeklarationen die folgenden Feldtypen. Bei der Erstellung eigener Namespacedeklarationen in der Nachrichtenbaumstruktur sollten Sie die im Folgenden aufgeführten Feldtypkonstanten verwenden.

Tabelle 1. Spezifische Feldtypkonstanten
XML-Konstrukt XMLNSC-Feldtypkonstante Wert
Namespacedeklaration
XMLNSC.SingleNamespaceDecl
XMLNSC.DoubleNamespaceDecl
0x03000102
0x03000103
Beim Zugriff auf Elemente und Attribute in der Nachrichtenbaumstruktur sollten Sie nicht die Konstanten in der Tabelle oben verwenden. Verwenden Sie die stattdessen die generische Feldtypkonstante, die beide Werte in der Tabelle oben abdeckt.
Tabelle 2. Generische Feldtypkonstanten
XML-Konstrukt XMLNSC-Feldtypkonstante Zweck
Namespacedeklaration XMLNSC.NamespaceDecl Deckt Namespacedeklarationen in einfachen und doppelten Anführungszeichen ab

ESQL-Codebeispiele

Beispiel 1: Deklaration eines Präfixes, das nicht leer ist

DECLARE space1 NAMESPACE ‘namespace1’;
SET OuputRoot.XMLNSC.root.(XMLNSC.NamespaceDecl)xmlns:ns1 = ‘namespace1’;
SET OuputRoot.XMLNSC.root.space1:example = ‘ABCDE’;
Als Ergebnis wird die folgende XML-Nachricht erstellt:
<root xmlns:ns1="namespace1">
    <ns1:example>ABCDE</ns1:example>
</root>
Die ESQL-Namespacekonstante 'space1' wird nur von ESQL verwendet. Sie hat keine Auswirkung auf das Namespacepräfix in der Ausgabenachricht.
Beispiel 2: Deklaration eines leeren Präfixes
DECLARE space1 NAMESPACE ‘namespace1’;
SET OuputRoot.XMLNSC.root.(XMLNSC.NamespaceDecl)xmlns = ‘namespace1’;
SET OuputRoot.XMLNSC.root.space1:example = ‘ABCDE’;
Als Ergebnis wird die folgende XML-Nachricht erstellt:
<root xmlns:ns1="namespace1">
    <example>ABCDE</example>
</root>
Das Syntaxelement 'example' muss einen Namespace haben, der nicht leer ist. Bei der standardmäßigen Namespacedeklaration befinden sich alle untergeordneten Elemente ohne Präfix im Namespace 'namespace1'.
Beispiel 3: Beispiel für eine falsche Verwendung
DECLARE space1 NAMESPACE ‘namespace1’;
SET OuputRoot.XMLNSC.root.(XMLNSC.NamespaceDecl)xmlns = ‘namespace1’;
SET OuputRoot.XMLNSC.root.example = ‘ABCDE’;
Der XMLNSC-Parser gibt bei dem Versuch, die Nachrichtenbaumstruktur auszugeben, die Nachricht BIP5014 aus. Das Element 'example' darf keinen leeren Namespace haben, da es im Bereich einer standardmäßigen Namespacedeklaration liegt.
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2007 Letzte Aktualisierung: Jan 24, 2008
ac67194_