Java javax.xml.xpath 接口 XPath（JDK5）

199 阅读 0 评论 0 点赞

类

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

javax.xml.xpath
接口 XPath

XPath 提供了对 XPath 计算环境和表达式的访问。

XPath 表达式的计算。
上下文	如果在没有上下文项的情况下请求计算表达式，则将使用一个空文档节点作为上下文。为计算 XPath 表达式，应将 DocumentFragment 视为 Document 节点。
变量	如果表达式包含变量引用，则其值将通过 `XPathVariableResolver` 找到，其中 `XPathVariableResolver` 是通过 `setXPathVariableResolver(XPathVariableResolver resolver)` 设置的。如果变量解析器未定义或解析器为变量返回 `null`，则引发 `XPathExpressionException`。在任何单个计算过程中，变量的值必须是不可变的。
函数	如果表达式包含函数引用，则函数将通过 `XPathFunctionResolver` 找到，其中 `XPathFunctionResolver` 是通过 `setXPathFunctionResolver(XPathFunctionResolver resolver)` 设置的。如果函数解析器未定义或解析器为函数返回 `null`，则引发 `XPathExpressionException`。
QNames	表达式中的 QNames 根据通过 `setNamespaceContext(NamespaceContext nsContext)` 设置的 XPath 名称空间上下文来解析。
结果	将计算表达式的结果转换为所需的返回类型的实例。`XPathConstants` 中定义了有效的返回类型。到返回类型的转换遵守 XPath 转换规则。

方法摘要
`XPathExpression`	`compile(String expression)` 编译 XPath 表达式供以后计算使用。
`String`	`evaluate(String expression, InputSource source)` 计算指定 `InputSource` 上下文中的 XPath 表达式并返回 `String` 形式的结果。
`Object`	`evaluate(String expression, InputSource source, QName returnType)` 计算指定 `InputSource` 上下文中的 XPath 表达式并返回指定类型的结果。
`String`	`evaluate(String expression, Object item)` 计算指定上下文中的 XPath 表达式并返回 `String` 形式的结果。
`Object`	`evaluate(String expression, Object item, QName returnType)` 计算指定上下文中的 `XPath` 表达式并返回指定类型的结果。
`NamespaceContext`	`getNamespaceContext()` 返回当前的名称空间上下文。
`XPathFunctionResolver`	`getXPathFunctionResolver()` 返回当前的函数解析器。
`XPathVariableResolver`	`getXPathVariableResolver()` 返回当前的变量解析器。
`void`	`reset()` 将此 `XPath` 重置为其原始配置。
`void`	`setNamespaceContext(NamespaceContext nsContext)` 建立名称空间上下文。
`void`	`setXPathFunctionResolver(XPathFunctionResolver resolver)` 建立函数解析器。
`void`	`setXPathVariableResolver(XPathVariableResolver resolver)` 建立变量解析器。

方法详细信息

void reset()

将此 XPath 重置为其原始配置。

XPath 被重置为通过 XPathFactory.newXPath() 创建它时的状态。reset() 在设计上旨在允许重用现有的 XPath，从而节省与创建新 XPath 相关的资源。

不保证重置的 XPath 具有相同的 XPathFunctionResolver、XPathVariableResolver 或 NamespaceContext Object，例如 Object.equals(Object obj)。但保证具有功能相同的 XPathFunctionResolver、XPathVariableResolver 和 NamespaceContext。

void setXPathVariableResolver(XPathVariableResolver resolver)

建立变量解析器。

如果 resolver 为 null，则抛出 NullPointerException。

XPathVariableResolver getXPathVariableResolver()

返回当前的变量解析器。

如果实际上没有变量解析器，则返回 null。

void setXPathFunctionResolver(XPathFunctionResolver resolver)

建立函数解析器。

如果 resolver 为 null，则抛出 NullPointerException。

XPathFunctionResolver getXPathFunctionResolver()

返回当前的函数解析器。

如果实际上没有函数解析器，则返回 null。

void setNamespaceContext(NamespaceContext nsContext)

建立名称空间上下文。

如果 nsContext 为 null，则抛出 NullPointerException。

NamespaceContext getNamespaceContext()

返回当前的名称空间上下文。

如果实际上没有名称空间上下文，则返回 null。