XMLNode: Bereichsbezogen, global

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 4 Minuten Lesedauer

    • Die XMLNode- API bietet Methoden zum Abfragen von Werten aus XML-Knoten. XMLNodes werden aus XMLDocument2-Objekten extrahiert, die XML-Zeichenfolgen enthalten.

    Es gibt keine Konstruktoren zum Erstellen einer eigenständigen Instanz eines XMLNode-Objekts. Verwenden Sie stattdessen die Methode createElement() von XMLDocument2, die einem vorhandenen Dokument einen Knoten hinzufügt.

    Scoped XMLNode – getAttribute(String attribute)

    Ruft den Wert des Attributs ab.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    Attribut Zeichenfolge Name des Attributs.
    Tabelle : 2. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Wert des Attributs. 
    var xmlString = "<test>" +
                "  <one>" +
                "    <two att=\"xxx\">abcd1234</two>" +
                "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                "    <two>another</two>" +
                "  </one>" +
                "  <number>1234</number>" +
                "</test>";
var xmlDoc = new XMLDocument2();
xmlDoc.parseXML(xmlString);
var node = xmlDoc.getNode('//two');
gs.info(node.getAttribute('att'));

    Ausgabe:

    xxx

    Scoped XMLNode – getAttributes()

    Gibt ein Objekt zurück, das die Attribute des Knotens als Eigenschaften mit Werten enthält.

    Tabelle : 3. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 4. Ergebnisse
    Typ Beschreibung
    Objekt Enthält Name-Wert-Paare, wobei der Name das Attribut und der Wert der Attributwert ist.

    Scoped XMLNode – getChildNodeIterator()

    Ruft ein XMLNodeIterator-Objekt ab, mit dem die Liste der untergeordneten Knoten durchlaufen werden kann.

    Tabelle : 5. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 6. Ergebnisse
    Typ Beschreibung
    XMLNodeIterator Knoten-Iterator-Objekt. 
    var xmlString = "<test>" +
                "  <one>" +
                "    <two att=\"xxx\">abcd1234</two>" +
                "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                "    <two>another</two>" +
                "  </one>" +
                "  <number>1234</number>" +
                "</test>";
var xmlDoc = new XMLDocument2();
xmlDoc.parseXML(xmlString);
var node = xmlDoc.getNode('//one');
var iter= node.getChildNodeIterator();
gs.info(iter.hasNext());

    Scoped XMLNode – getFirstChild()

    Ruft den ersten untergeordneten Knoten des Knotens ab.

    Tabelle : 7. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 8. Ergebnisse
    Typ Beschreibung
    XMLNode Erster untergeordneter Knoten des Knotens. 
    var xmlString = "<test>" +
                "<one>" +
                "<two att=\"xxx\">abcd1234</two>" +
                "<three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                "<two>another</two>" +
                "</one>" +
                "<number>1234</number>" +
                "</test>";
var xmlDoc = new XMLDocument2();
xmlDoc.parseXML(xmlString);
var node = xmlDoc.getNode('//one');
gs.info(node.getFirstChild());
    Ausgabe: 
    <two att="xxx">abcd1234</two>

    Scoped XMLNode – getLastChild()

    Ruft den letzten untergeordneten Knoten des Knotens ab.

    Tabelle : 9. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 10. Ergebnisse
    Typ Beschreibung
    XMLNode Letztes untergeordnetes Element des Knotens. 
    var xmlString = "<test>" +
                "<one>" +
                "<two att=\"xxx\">abcd1234</two>" +
                "<three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                "<two>another</two>" +
                "</one>" +
                "<number>1234</number>" +
                "</test>";
var xmlDoc = new XMLDocument2();
xmlDoc.parseXML(xmlString);
var node = xmlDoc.getNode('//one');
 
gs.info(node.getLastChild());
    Ausgabe: 
    <two>another</two>

    Scoped XMLNode – getNodeName()

    Ruft den Namen des Knotens ab. Der Name eines Knotens wird vom Knotentyp bestimmt. Der Name eines Dokumentelementknotens lautet #document. Der Name eines Textknotens lautet #text. Der Name eines Elementknotens ist der Name des Elements.

    Tabelle : 11. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 12. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Name des Knotens. 
    var xmlString = "<test>" +
                "  <one>" +
                "    <two att=\"xxx\">abcd1234</two>" +
                "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                "    <two>another</two>" +
                "  </one>" +
                "  <number>1234</number>" +
                "</test>";
var xmlDoc = new XMLDocument2();
xmlDoc.parseXML(xmlString);
var node = xmlDoc.getNode('//two');
gs.info(node.getNodeName());

    Ausgabe:

    two

    Scoped XMLNode – getNodeValue()

    Ruft den Wert des Knotens ab. Der Wert eines Knotens wird vom Knotentyp bestimmt. Element- und Dokumentelementknoten geben NULL zurück.

    Tabelle : 13. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 14. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Wert des Knotens. 
    var xmlString = "<test>" +
                "  <one>" +
                "    <two att=\"xxx\">abcd1234</two>" +
                "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                "    <two>another</two>" +
                "  </one>" +
                "  <number>1234</number>" +
                "</test>";
var xmlDoc = new XMLDocument2();
xmlDoc.parseXML(xmlString);
var node = xmlDoc.getNode('//two');
gs.info(node.getNodeValue());

    Ausgabe:

    null

    Scoped XMLNode – getTextContent()

    Ruft den Textinhalt des aktuellen Knotens ab. Der Textinhalt eines Knotens besteht aus allen untergeordneten Textknoten des Knotens.

    Tabelle : 15. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 16. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Textinhalt des aktuellen Knotens. 
    var xmlString = "<test>" +
                "  <one>" +
                "    <two att=\"xxx\">abcd1234</two>" +
                "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                "    <two>another</two>" +
                "  </one>" +
                "  <number>1234</number>" +
                "</test>";
var xmldoc = new XMLDocument2();
xmldoc.parseXML(xmlString);
var node = xmldoc.getNode('//one/two');
gs.info(node.getTextContent());

    Ausgabe:

    abcd1234

    Scoped XMLNode – hasAttribute(String attribute)

    Bestimmt, ob der Knoten das angegebene Attribut hat.

    Tabelle : 17. Parameter
    Name Typ Beschreibung
    Attribut Zeichenfolge Name des zu überprüfenden Attributs.
    Tabelle : 18. Ergebnisse
    Typ Beschreibung
    Boolean „True“, wenn der Knoten das Attribut hat. 
    var xmlString = "<test>" +
                "  <one>" +
                "    <two att=\"xxx\">abcd1234</two>" +
                "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                "    <two>another</two>" +
                "  </one>" +
                "  <number>1234</number>" +
                "</test>";
var xmlDoc = new XMLDocument2();
xmlDoc.parseXML(xmlString);
var node = xmlDoc.getNode('//two');
gs.info(node.hasAttribute('att'));

    Ausgabe:

    true

    Bereichsbezogener XMLNode – isCDATANode()

    Gibt an, ob der CDATA-Knoten als separater Knoten beibehalten wird.

    Verwenden Sie die Methode Bereichsbezogenes XML-Dokument2 – setEnableCDATAReporting(Boolean enable), um sicherzustellen, dass CDATA-Knoten erhalten bleiben und nicht als Text behandelt werden.

    Tabelle : 19. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 20. Ergebnisse
    Typ Beschreibung
    Boolean Kennzeichnung, die angibt, ob es sich bei einem abgefragten Knoten um CDATA oder Nur-Text handelt.
    Gültige Werte:
    • wahr: Der abgefragte Knoten ist CDATA.
    • „falsch“: Der abgefragte Knoten ist Nur-Text.

    Das folgende Beispiel zeigt, wie eine XML-Zeichenfolge bei aktivierter CDATA-Berichterstellung mit Bereichsbezogenes XML-Dokument2 – setEnableCDATAReporting(Boolean enable)analysiert wird. Der Code verwendet isCDATANode(), um anzuzeigen, dass der erste in der XML-Zeichenfolge abgefragte Knoten ein CDATA-Knoten ist.

    var xmlString = "<test>" +
  "  <one>" +
  "    <two att=\"xxx\">abcd1234</two>" +
  "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>"+
  "    <four><![CDATA[another]]>element</four>" +
  "  </one>" +
  "  <number>1234</number>" +
  "</test>";
var xmlDoc = new XMLDocument2();
xmlDoc.setEnableCDATAReporting(true); // Enables CDATA reporting
xmlDoc.parseXML(xmlString);
var content = xmlDoc.getFirstNode('/test/one/four');
gs.info(content.getFirstChild().isCDATANode());

    Ausgabe:

    true

    Scoped XMLNode – toString()

    Gibt den Zeichenfolgenwert des aktuellen Knotens zurück.

    Tabelle : 21. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 22. Ergebnisse
    Typ Beschreibung
    Zeichenfolge Zeichenfolgewert des aktuellen Knotens. 
    var xmlString = "<test>" +
                "  <one>" +
                "    <two att=\"xxx\">abcd1234</two>" +
                "    <three boo=\"yah\" att=\"yyy\">1234abcd</three>" +
                "    <two>another</two>" +
                "  </one>" +
                "  <number>1234</number>" +
                "</test>";
var xmlDoc = new XMLDocument2();
xmlDoc.parseXML(xmlString);
var node = xmlDoc.getNode('//one');
gs.info(node.toString());
    Ausgabe: Der Ausgabe wurden Zeilenumbrüche hinzugefügt.
    <one>    
<two att="xxx">abcd1234</two>    
<three att="yyy" boo="yah">1234abcd</three>    
<two>another</two>  
</one>