Class XPathExpressionImpl
- java.lang.Object
-
- org.apache.xpath.jaxp.XPathExpressionImpl
-
- All Implemented Interfaces:
javax.xml.xpath.XPathExpression
public class XPathExpressionImpl extends java.lang.Object implements javax.xml.xpath.XPathExpression
The XPathExpression interface encapsulates a (compiled) XPath expression.- Version:
- $Revision: 1225277 $
- Author:
- Ramesh Mandava
-
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description java.lang.Object
eval(java.lang.Object item, javax.xml.namespace.QName returnType)
java.lang.String
evaluate(java.lang.Object item)
Evaluate the compiled XPath expression in the specified context and return the result as aString
.java.lang.Object
evaluate(java.lang.Object item, javax.xml.namespace.QName returnType)
Evaluate the compiled XPath expression in the specified context and return the result as the specified type.java.lang.String
evaluate(org.xml.sax.InputSource source)
Evaluate the compiled XPath expression in the context of the specifiedInputSource
and return the result as aString
.java.lang.Object
evaluate(org.xml.sax.InputSource source, javax.xml.namespace.QName returnType)
Evaluate the compiled XPath expression in the context of the specifiedInputSource
and return the result as the specified type.void
setXPath(XPath xpath)
-
-
-
Method Detail
-
setXPath
public void setXPath(XPath xpath)
-
eval
public java.lang.Object eval(java.lang.Object item, javax.xml.namespace.QName returnType) throws javax.xml.transform.TransformerException
- Throws:
javax.xml.transform.TransformerException
-
evaluate
public java.lang.Object evaluate(java.lang.Object item, javax.xml.namespace.QName returnType) throws javax.xml.xpath.XPathExpressionException
Evaluate the compiled XPath expression in the specified context and return the result as the specified type.
See "Evaluation of XPath Expressions" section of JAXP 1.3 spec for context item evaluation, variable, function and QName resolution and return type conversion.
If
returnType
is not one of the types defined inXPathConstants
, then anIllegalArgumentException
is thrown.If a
null
value is provided foritem
, an empty document will be used for the context. IfreturnType
isnull
, then aNullPointerException
is thrown.- Specified by:
evaluate
in interfacejavax.xml.xpath.XPathExpression
- Parameters:
item
- The starting context (node or node list, for example).returnType
- The desired return type.- Returns:
- The
Object
that is the result of evaluating the expression and converting the result toreturnType
. - Throws:
javax.xml.xpath.XPathExpressionException
- If the expression cannot be evaluated.java.lang.IllegalArgumentException
- IfreturnType
is not one of the types defined inXPathConstants
.java.lang.NullPointerException
- IfreturnType
isnull
.
-
evaluate
public java.lang.String evaluate(java.lang.Object item) throws javax.xml.xpath.XPathExpressionException
Evaluate the compiled XPath expression in the specified context and return the result as a
String
.This method calls
evaluate(Object item, QName returnType)
with areturnType
ofXPathConstants.STRING
.See "Evaluation of XPath Expressions" section of JAXP 1.3 spec for context item evaluation, variable, function and QName resolution and return type conversion.
If a
null
value is provided foritem
, an empty document will be used for the context.- Specified by:
evaluate
in interfacejavax.xml.xpath.XPathExpression
- Parameters:
item
- The starting context (node or node list, for example).- Returns:
- The
String
that is the result of evaluating the expression and converting the result to aString
. - Throws:
javax.xml.xpath.XPathExpressionException
- If the expression cannot be evaluated.
-
evaluate
public java.lang.Object evaluate(org.xml.sax.InputSource source, javax.xml.namespace.QName returnType) throws javax.xml.xpath.XPathExpressionException
Evaluate the compiled XPath expression in the context of the specified
InputSource
and return the result as the specified type.This method builds a data model for the
InputSource
and callsevaluate(Object item, QName returnType)
on the resulting document object.See "Evaluation of XPath Expressions" section of JAXP 1.3 spec for context item evaluation, variable, function and QName resolution and return type conversion.
If
returnType
is not one of the types defined inXPathConstants
, then anIllegalArgumentException
is thrown.If
source
orreturnType
isnull
, then aNullPointerException
is thrown.- Specified by:
evaluate
in interfacejavax.xml.xpath.XPathExpression
- Parameters:
source
- TheInputSource
of the document to evaluate over.returnType
- The desired return type.- Returns:
- The
Object
that is the result of evaluating the expression and converting the result toreturnType
. - Throws:
javax.xml.xpath.XPathExpressionException
- If the expression cannot be evaluated.java.lang.IllegalArgumentException
- IfreturnType
is not one of the types defined inXPathConstants
.java.lang.NullPointerException
- Ifsource
orreturnType
isnull
.
-
evaluate
public java.lang.String evaluate(org.xml.sax.InputSource source) throws javax.xml.xpath.XPathExpressionException
Evaluate the compiled XPath expression in the context of the specified
InputSource
and return the result as aString
.This method calls
evaluate(InputSource source, QName returnType)
with areturnType
ofXPathConstants.STRING
.See "Evaluation of XPath Expressions" section of JAXP 1.3 spec for context item evaluation, variable, function and QName resolution and return type conversion.
If
source
isnull
, then aNullPointerException
is thrown.- Specified by:
evaluate
in interfacejavax.xml.xpath.XPathExpression
- Parameters:
source
- TheInputSource
of the document to evaluate over.- Returns:
- The
String
that is the result of evaluating the expression and converting the result to aString
. - Throws:
javax.xml.xpath.XPathExpressionException
- If the expression cannot be evaluated.java.lang.NullPointerException
- Ifsource
isnull
.
-
-