La classe XPath permet d'accéder aux expressions et à l'environnement d'évaluation XPath.

Si une requête est faite pour évaluer l'expression XPath en l'absence d'un élément de contexte, un document vide sera employé pour le contexte. Pour les buts d'évaluation des expressions XPath, un objet DocumentFragment est traité comme un noeud Document.

Si l'expression contient une référence de variable, sa valeur sera trouvée par l'objet XPathVariableResolver. Un exception XPathExpressionException est lancée si l'objet XPathVariableResolver est indéfini ou si ce dernier retourne null pour la variable. La valeur d'une variable doit être immuable au cours de n'importe quelle évaluation.

Si l'expression contient une référence à une fonction, celle-ci sera trouvée par l'objet XPathFunctionResolver. Une exception XPathExpressionException est lancée si l'objet XPathFunctionResolver est indéfini ou si ce dernier retourne null pour la fonction.

Les noms qualifiés dans une expression XPath sont résolus en s'appuyant sur le contexte d'espace de noms de XPath.

Le résultat de l'évaluation d'une expression XPath est converti en une instance du type de retour désiré. Des types de retour valides sont définis dans XPathConstants. La conversion en type de retour suit des règles de conversion de XPath.

Méthode
Description
XPathExpression compile(String expression)
compile une expression XPath pour une prochaine évaluation.
String evaluate(String expression, InputSource source)
évalue une expression XPath dans le contexte de la source d'entrée spécifiée et retourne le résultat sous la forme d'une chaîne de caractères.
Object evaluate(String expression, InputSource source, QName returnType)
évalue une expression XPath dans le contexte de la source d'entrée spécifiée et retourne le résultat sous la forme d'un objet dont le type est indiqué.
String evaluate(String expression, Object item)
évalue une expression XPath dans le contexte spécifié et retourne le résultat sous la forme d'une chaîne de caractères.
Object evaluate(String expression, Object item, QName returnType)
évalue une expression XPath dans le contexte spécifié et retourne le résultat sous la forme d'un objet dont le type est indiqué.
NamespaceContext getNamespaceContext()
retourne le contexte d'espace de noms courant.
XPathFunctionResolver getXPathFunctionResolver()
retourne l'objet XPathFunctionResolver associé à cet objet.
XPathVariableResolver getXPathVariableResolver()
retourne l'objet XPathVariableResolver associé à cet objet.
void reset()
réinitialise la configuration initiale de l'objet XPath.
void setNamespaceContext(NamespaceContext nsContext)
assigne un contexte d'espace de noms pour l'objet courant.
void setXPathFunctionResolver(XPathFunctionResolver resolver)
assigne un objet XPathFunctionResolver associé à l'objet courant.
void setXPathVariableResolver(XPathVariableResolver resolver)
assigne un objet XPathVariableResolver associé à l'objet courant.