|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
javax.xml.xpath
接口 XPathExpression
-
public interface XPathExpression
XPathExpression
提供了对编译后的 XPath 表达式的访问。
XPath 表达式的计算。 | |
---|---|
上下文 | 如果在没有上下文项的情况下请求计算表达式,则将使用一个空文档节点作为上下文。为计算 XPath 表达式,应将 DocumentFragment 视为 Document 节点。 |
变量 | 如果表达式包含变量引用,则其值将通过 XPathVariableResolver 找到。如果变量解析器未定义或解析器为变量返回 null ,则引发 XPathExpressionException 。在任何单个计算过程中,变量的值必须是不可变的。 |
函数 | 如果表达式包含函数引用,则函数将通过 XPathFunctionResolver 找到。如果函数解析器未定义或解析器为函数返回 null ,则引发 XPathExpressionException 。 |
QNames | 表达式中的 QNames 根据 XPath 名称空间上下文来解析。 |
结果 | 将计算表达式的结果转换为所需的返回类型的实例。XPathConstants 中定义了有效的返回类型。到返回类型的转换遵守 XPath 转换规则。 |
- 从以下版本开始:
- 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 解析,以及返回类型转换,请参阅 Evaluation of XPath Expressions。
如果
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
形式的结果。此方法通过
XPathConstants.STRING
的returnType
调用evaluate(Object item, QName returnType)
。有关上下文项计算、变量、函数和 QName 解析,以及返回类型转换,请参阅 Evaluation of XPath Expressions。
如果为
item
提供了null
值,则将使用一个空文档作为上下文。 -
- 参数:
item
- 开始上下文(例如节点或节点列表)。- 返回:
-
计算表达式并将计算结果转换为
String
所得到的结果String
。 - 抛出:
XPathExpressionException
- 如果不能计算表达式。
evaluate
Object evaluate(InputSource source, QName returnType) throws XPathExpressionException
-
计算指定
InputSource
上下文中编译后的 XPath 表达式并返回指定类型的结果。此方法构建
InputSource
的数据模型并调用得到的文档对象上的evaluate(Object item, QName returnType)
。有关上下文项计算、变量、函数和 QName 解析,以及返回类型转换,请参阅 Evaluation of XPath Expressions。
如果
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
形式的结果。此方法通过
XPathConstants.STRING
的returnType
调用evaluate(InputSource source, QName returnType)
。有关上下文项计算、变量、函数和 QName 解析,以及返回类型转换,请参阅 Evaluation of XPath Expressions。
如果
source
为null
,则抛出NullPointerException
。 -
- 参数:
source
- 要对其计算的文档的InputSource
。- 返回:
-
计算表达式并将计算结果转换为
String
所得到的结果String
。 - 抛出:
XPathExpressionException
- 如果不能计算表达式。NullPointerException
- 如果source
为null
。
所有类
|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |