XPathExpression (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
javax.xml.xpath
接口 XPathExpression
public interface XPathExpression
XPathExpression 提供了对编译后的 XPath 表达式的访问。
| XPath 表达式的计算。 | |
|---|---|
| 上下文 | 如果在没有上下文项的情况下请求计算表达式，则将使用一个空文档节点作为上下文。为计算 XPath 表达式，应将 DocumentFragment 视为 Document 节点。 |
| 变量 |
如果表达式包含变量引用，则其值将通过 XPathVariableResolver 找到。如果变量解析器未定义或解析器对变量返回 null，则引发 XPathExpressionException。在任何单个计算过程中，变量的值必须是不可变的。
|
| 函数 |
如果表达式包含函数引用，则函数将通过 XPathFunctionResolver 找到。如果函数解析器未定义或解析器为函数返回 null，则引发 XPathExpressionException。
|
| QNames | 表达式中的 QNames 根据 XPath 名称空间上下文来解析。 |
| 结果 |
将计算表达式的结果转换为所需的返回类型的实例。XPathConstants 中定义了有效的返回类型。转换到返回类型的过程遵守 XPath 转换规则。
|
XPath 表达式不是线程安全的，也不能重入。换句话说，应用程序负责确保在任意给定时刻不能有多个线程使用一个 XPathExpression 对象，且当调用 evaluate 方法时，应用程序不能以递归方式调用 evaluate 方法。
- 从以下版本开始：
- 1.5
- 另请参见：
- XML Path Language (XPath) Version 1.0, Expressions
| 方法摘要 | |
|---|---|
String |
evaluate(InputSource source)
计算指定 InputSource 上下文中编译后的 XPath 表达式并以 String 形式返回结果。 |
Object |
evaluate(InputSource source,
QName returnType)
计算指定 InputSource 上下文中编译后的 XPath 表达式并返回指定类型的结果。 |
String |
evaluate(Object item)
计算指定上下文中编译后的 XPath 表达式并以 String 形式返回结果。 |
Object |
evaluate(Object item,
QName returnType)
计算指定上下文中的 XPath 表达式并返回指定类型的结果。 |
| 方法详细信息 |
|---|
evaluate
Object evaluate(Object item, QName returnType) throws XPathExpressionException
计算指定上下文中的 XPath 表达式并返回指定类型的结果。
有关上下文项计算、变量、函数和 QName 解析，以及返回类型转换，请参阅 XPath 表达式的计算。
如果
returnType不是XPathConstants中定义的类型之一，则抛出IllegalArgumentException。如果为
item提供了null值，则将使用一个空文档作为上下文。如果returnType为null，则抛出NullPointerException。- 参数：
item- 开始上下文（例如节点）。returnType- 所需的返回类型。- 返回：
- 计算表达式并将计算结果转换为
returnType所得到的结果Object。 - 抛出：
XPathExpressionException- 如果不能计算表达式。IllegalArgumentException- 如果returnType不是XPathConstants中定义的类型之一。NullPointerException- 如果returnType为null。
evaluate
String evaluate(Object item) throws XPathExpressionException
计算指定上下文中编译后的 XPath 表达式并以
String形式返回结果。此方法调用
evaluate(Object item, QName returnType)，其中returnType为XPathConstants.STRING。有关上下文项计算、变量、函数和 QName 解析，以及返回类型转换，请参阅 XPath 表达式的计算。
如果为
item为null值，则将使用一个空文档作为上下文。- 参数：
item- 开始上下文（例如节点）。- 返回：
- 计算表达式并将计算结果转换为
String所得到的结果String。 - 抛出：
XPathExpressionException- 如果不能计算表达式。
evaluate
Object evaluate(InputSource source, QName returnType) throws XPathExpressionException
计算指定
InputSource上下文中编译后的 XPath 表达式并返回指定类型的结果。此方法构建
InputSource的数据模型，然后对所得文档对象调用evaluate(Object item, QName returnType)。有关上下文项计算、变量、函数和 QName 解析，以及返回类型转换，请参阅 XPath 表达式的计算。
如果
returnType不是XPathConstants中定义的类型之一，则抛出IllegalArgumentException。如果
source或returnType为null，则抛出NullPointerException。- 参数：
source- 要对其计算的文档的InputSource。returnType- 所需的返回类型。- 返回：
- 计算表达式并将计算结果转换为
returnType所得到的结果Object。 - 抛出：
XPathExpressionException- 如果不能计算表达式。IllegalArgumentException- 如果returnType不是XPathConstants中定义的类型之一。NullPointerException- 如果source或returnType为null。
evaluate
String evaluate(InputSource source) throws XPathExpressionException
计算指定
InputSource上下文中编译后的 XPath 表达式并以String形式返回结果。此方法调用
evaluate(InputSource source, QName returnType)，其中returnType为XPathConstants.STRING。有关上下文项计算、变量、函数和 QName 解析，以及返回类型转换，请参阅 XPath 表达式的计算。
如果
source为null，则抛出NullPointerException。- 参数：
source- 要对其计算的文档的InputSource。- 返回：
- 计算表达式并将计算结果转换为
String所得到的结果String。 - 抛出：
XPathExpressionException- 如果不能计算表达式。NullPointerException- 如果source为null。
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。