ctSim.util.xml
Interface XmlDocument.XPathQueryable

All Known Subinterfaces:

QueryableDocument, QueryableNode

All Known Implementing Classes:

XmlDocument.QueryableMixin

Enclosing class:

XmlDocument

public static interface XmlDocument.XPathQueryable

Selektiert mehrere Knoten

Method Summary

Boolean	getBoolean(String xPathExpression) Selektiert Knoten, konvertiert sie in einen String (siehe getString(String)) und konvertiert den String in einen Boolean.
Boolean	getBooleanOrNull(String xPathExpression) Wie getBoolean(), aber falls der übergebene XPath-Ausdruck keine Knoten selektiert, wird null zurückgeliefert.
QueryableNode	getNode(String xPathExpression) Selektiert einen einzelnen Knoten.
IterableNodeList	getNodeList(String xPathExpression) Selektiert mehrere Knoten.
Double	getNumber(String xPathExpression) Selektiert Knoten, konvertiert sie in einen String (siehe getString(String)) und konvertiert den String in einen Double.
Number	getNumberOrNull(String xPathExpression) Wie getNumber(), aber falls der übergebene XPath-Ausdruck keine Knoten selektiert, wird null zurückgeliefert.
String	getString(String xPathExpression) Liefert den "string-value" der Knoten, die vom übergebenen XPath-Ausdruck selektiert wurden.
String	getStringOrNull(String xPathExpression) Wie getString(), aber falls der übergebene XPath-Ausdruck keine Knoten selektiert, wird null zurückgeliefert.

Method Detail

getNodeList

IterableNodeList getNodeList(String xPathExpression)
                             throws XPathExpressionException

Selektiert mehrere Knoten. Wenn z.B. beim Konstruieren dieses Objekts eine Datei angegeben wurde, die 42 Stück <wurst>...</wurst>-Elemente enthält, wird getNodeList("//wurst") eine Liste dieser 42 Elemente zurückliefern.

Drandenken: Knoten müssen nicht Elemente sein – Attribute, CData-Abschnitte usw. sind auch Knoten. Siehe Node.

Parameters:

xPathExpression -

Returns:

Die selektierten Knoten als NodeList, wie sie die Java-Plattform implementiert, die aber auch Iterable ist. for (Node n : document.getNodeList(...)) ist also möglich. Gibt es im Dokument keine Knoten, die von dem XPath-Ausdruck selektiert werden, wird eine NodeList zurückgegeben, die keine Knoten enthält.

Throws:

XPathExpressionException

getNode

QueryableNode getNode(String xPathExpression)
                      throws XPathExpressionException

Selektiert einen einzelnen Knoten. Falls der übergebene XPath-Ausdruck mehrere Knoten selektiert, wird er erste zurückgeliefert; falls er keine Knoten selektiert, wird null zurückliefert.

Drandenken: Knoten müssen nicht Elemente sein – Attribute, CData-Abschnitte usw. sind auch Knoten. Siehe Node.

Parameters:

xPathExpression -

Returns:

Knoten

Throws:

XPathExpressionException

getString

String getString(String xPathExpression)
                 throws XPathExpressionException

Liefert den "string-value" der Knoten, die vom übergebenen XPath-Ausdruck selektiert wurden. Liefert einen leeren String (""), falls der übergebene XPath-Ausdruck keine Knoten selektiert (gemäß XPath-Konvertierungsregeln). Der "string-value" ist –

• für Elemente: sämtlicher Text, den sie enthalten. Beispiel: "wurstbrot", wenn die Elemente <fruehstueck><a>wurst</a><b>brot</b></fruehstueck> mit XPath selektiert wurden.
• für Attribute: der Wert des Attributs. Beispiel: "kaese" falls das erste Attribut von <fruehstueck belag="kaese"> mit XPath selektiert wurde. Details zur Umwandlung eines Attributknotens in einen String
• für Textknoten: ihr Inhalt
• für alle anderen Knotenarten: Siehe XPath-Spezifikation Abschnitt 5

Details zum Thema "string-value" siehe XPath-Spezifikation Abschnitt 5.

Parameters:

xPathExpression -

Returns:

String

Throws:

XPathExpressionException

See Also:

getStringOrNull(String)

getNumber

Double getNumber(String xPathExpression)
                 throws XPathExpressionException

Selektiert Knoten, konvertiert sie in einen String (siehe getString(String)) und konvertiert den String in einen Double. Falls der übergebene XPath-Ausdruck keine Knoten selektiert, wird NaN zurückgeliefert (d.h. getNumber(...).isNaN() == true). Details zur Konvertierung in eine Zahl

Parameters:

xPathExpression -

Returns:

Zahl

Throws:

XPathExpressionException

See Also:

getNumberOrNull(String)

getBoolean

Boolean getBoolean(String xPathExpression)
                   throws XPathExpressionException

Selektiert Knoten, konvertiert sie in einen String (siehe getString(String)) und konvertiert den String in einen Boolean. Falls der übergebene XPath-Ausdruck keine Knoten selektiert, wird false zurückgeliefert. Details zur Konvertierung in einen Boolean

Parameters:

xPathExpression -

Returns:

Boolean

Throws:

XPathExpressionException

See Also:

getBooleanOrNull(String)

getStringOrNull

String getStringOrNull(String xPathExpression)
                       throws XPathExpressionException

Wie getString(), aber falls der übergebene XPath-Ausdruck keine Knoten selektiert, wird null zurückgeliefert. So kann man auseinanderhalten, ob der Knoten nicht existiert (null) oder ob er existiert, aber keinen Text enthält ("").

Parameters:

xPathExpression -

Returns:

String / null

Throws:

XPathExpressionException

getNumberOrNull

Number getNumberOrNull(String xPathExpression)
                       throws XPathExpressionException

Wie getNumber(), aber falls der übergebene XPath-Ausdruck keine Knoten selektiert, wird null zurückgeliefert. So kann man auseinanderhalten, ob der Knoten nicht existiert (null) oder ob er existiert, aber etwas anderes als eine Zahl enthält.

Parameters:

xPathExpression -

Returns:

Zahl / null

Throws:

XPathExpressionException

getBooleanOrNull

Boolean getBooleanOrNull(String xPathExpression)
                         throws XPathExpressionException

Wie getBoolean(), aber falls der übergebene XPath-Ausdruck keine Knoten selektiert, wird null zurückgeliefert. So kann man auseinanderhalten, ob der Knoten nicht existiert (null) oder ob er wirklich da ist und false enthält.

Parameters:

xPathExpression -

Returns:

Boolean / null

Throws:

XPathExpressionException