javax.xml.xpath

Интерфейсный XPathExpression

public interface XPathExpression

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

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

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

С тех пор:

1.5

См. Также:

Язык Пути XML (XPath) Версия 1.0, Выражения

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
Строка	evaluate(InputSource source) Оцените скомпилированное выражение XPath в контексте указанного InputSource и возвратите результат как a String.
Объект	evaluate(InputSource source, QName returnType) Оцените скомпилированное выражение XPath в контексте указанного InputSource и возвратите результат как указанный тип.
Строка	evaluate(Object item) Оцените скомпилированное выражение XPath в указанном контексте и возвратите результат как a String.
Объект	evaluate(Object item, QName returnType) Оцените скомпилированное выражение XPath в указанном контексте и возвратите результат как указанный тип.

Деталь метода

оценить

Object evaluate(Object item,
              QName returnType)
                throws XPathExpressionException

Оцените скомпилированное выражение XPath в указанном контексте и возвратите результат как указанный тип.

См. Оценку Выражений XPath для оценки элемента контекста, переменной, функционального и разрешения QName и возвратите преобразование типов.

Если returnType не один из типов, определенных в XPathConstants, тогда IllegalArgumentException бросается.

Если a null значение предусматривается item, пустой документ будет использоваться для контекста. Если returnType null, тогда a NullPointerException бросается.

Параметры:

item - Запускающийся контекст (узел, например).

returnType - Требуемый тип возврата.

Возвраты:

Object это - результат оценки выражения и преобразования результата к returnType.

Броски:

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

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

NullPointerException - Если returnType null.

оценить

String evaluate(Object item)
                throws XPathExpressionException

Оцените скомпилированное выражение XPath в указанном контексте и возвратите результат как a String.

Это вызовы метода evaluate(Object item, QName returnType) с a returnType из XPathConstants.STRING.

См. Оценку Выражений XPath для оценки элемента контекста, переменной, функционального и разрешения QName и возвратите преобразование типов.

Если a null значение предусматривается item, пустой документ будет использоваться для контекста.

Параметры:

item - Запускающийся контекст (узел, например).

Возвраты:

String это - результат оценки выражения и преобразования результата к a String.

Броски:

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

оценить

Object evaluate(InputSource source,
              QName returnType)
                throws XPathExpressionException

Оцените скомпилированное выражение XPath в контексте указанного InputSource и возвратите результат как указанный тип.

Этот метод создает модель данных для InputSource и вызовы evaluate(Object item, QName returnType) на получающемся объекте документа.

См. Оценку Выражений XPath для оценки элемента контекста, переменной, функционального и разрешения QName и возвратите преобразование типов.

Если returnType не один из типов, определенных в XPathConstants, тогда IllegalArgumentException бросается.

Если source или returnType null, тогда a NullPointerException бросается.

Параметры:

source - InputSource из документа, чтобы оценить.

returnType - Требуемый тип возврата.

Возвраты:

Object это - результат оценки выражения и преобразования результата к returnType.

Броски:

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

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

NullPointerException - Если source или returnType null.

оценить

String evaluate(InputSource source)
                throws XPathExpressionException

Оцените скомпилированное выражение XPath в контексте указанного InputSource и возвратите результат как a String.

Это вызовы метода evaluate(InputSource source, QName returnType) с a returnType из XPathConstants.STRING.

См. Оценку Выражений XPath для оценки элемента контекста, переменной, функционального и разрешения QName и возвратите преобразование типов.

Если source null, тогда a NullPointerException бросается.

Параметры:

source - InputSource из документа, чтобы оценить.

Возвраты:

String это - результат оценки выражения и преобразования результата к a String.

Броски:

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

NullPointerException - Если source null.