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 –

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