Интерфейс XPathExpression

public interface XPathExpression

XPathExpression предоставляет доступ к скомпилированным выражениям XPath.

Вычисление выражений XPath.
контекст	Если выражение требуется вычислить без элемента контекста, будет использован пустой узел документа в качестве контекста. Для целей вычисления выражений XPath, фрагмент документа обрабатывается как узел документа.
переменные	Если выражение содержит ссылку на переменную, её значение будет найдено с помощью XPathVariableResolver. XPathExpressionException выбрасывается, если резолвер переменных не определён или резолвер возвращает null для переменной. Значение переменной должно быть неизменным в ходе каждого отдельного вычисления.
функции	Если выражение содержит ссылку на функцию, функция будет найдена с помощью XPathFunctionResolver. XPathExpressionException выбрасывается, если резолвер функций не определён или резолвер функций возвращает null для функции.
QNames	QNames в выражении разрешаются относительно контекста пространства имён XPath.
результат	Результат вычисления выражения преобразуется в экземпляр желаемого типа возвращаемого значения. Допустимые типы возвращаемых значений определены в XPathConstants. Преобразование в тип возвращаемого значения происходит согласно правилам преобразования XPath.

Выражение XPath не является потокобезопасным и нерекурсивным. Другими словами, приложение должно гарантировать, что один объект XPathExpression не используется из более чем одной потока одновременно, а также, что метод evaluate не вызывается рекурсивно во время выполнения метода evaluate.

Методы

evaluate

Object evaluate(Object item,
                QName returnType)
         throws XPathExpressionException

Параметры:

item - Начальный контекст (например, узел).

returnType - Желаемый тип возвращаемого значения.

Возвращает:

Значение Object, являющееся результатом вычисления выражения и преобразования результата в returnType.

Исключения:

XPathExpressionException - Если выражение не может быть вычислено.

IllegalArgumentException - Если returnType не является одним из типов, определённых в XPathConstants.

NullPointerException - Если returnType равно null.

evaluate

String evaluate(Object item)
         throws XPathExpressionException

Параметры:

item - Начальный контекст (например, узел).

Возвращает:

Значение String, являющееся результатом вычисления выражения и преобразования результата в String.

Исключения:

XPathExpressionException - Если выражение не может быть вычислено.

evaluate

Object evaluate(InputSource source,
                QName returnType)
         throws XPathExpressionException

Параметры:

source - Источник InputSource документа для вычисления.

returnType - Желаемый тип возвращаемого значения.

Возвращает:

Значение Object, являющееся результатом вычисления выражения и преобразования результата в returnType.

Исключения:

XPathExpressionException - Если выражение не может быть вычислено.

IllegalArgumentException - Если returnType не является одним из типов, определённых в XPathConstants.

NullPointerException - Если source или returnType имеют значение null.

evaluate

String evaluate(InputSource source)
         throws XPathExpressionException

Параметры:

source - Источник InputSource документа для вычисления.

Возвращает:

Значение String, являющееся результатом вычисления выражения и преобразования результата в String.

Исключения:

XPathExpressionException - Если выражение не может быть вычислено.

NullPointerException - Если source имеет значение null.