org.apache.camel.builder.xml
Class XPathBuilder

java.lang.Object
  org.apache.camel.builder.xml.XPathBuilder

All Implemented Interfaces:

Expression, Predicate, NamespaceAware

public class XPathBuilder
extends Object
implements Expression, Predicate, NamespaceAware

Creates an XPath expression builder which creates a nodeset result by default. If you want to evaluate a String expression then call stringResult()

Version:

$Revision: 769448 $

See Also:

XPathConstants.NODESET

Constructor Summary

XPathBuilder(String text)

Method Summary

void	assertMatches(String text, Exchange exchange)
XPathBuilder	booleanResult() Sets the expression result type to boolean
protected XPathFunctionResolver	createDefaultFunctionResolver(XPathFunctionResolver parent)
protected XPathExpression	createXPathExpression()
Object	evaluate(Exchange exchange)
<T> T	evaluate(Exchange exchange, Class<T> type) Returns the value of the expression on the given exchange
protected Object	evaluateAs(Exchange exchange, QName resultQName) Evaluates the expression as the given result type
XPathBuilder	functionResolver(XPathFunctionResolver functionResolver) Sets the XPathFunctionResolver instance to use on these XPath expressions
XPathFunction	getBodyFunction()
protected Object	getDocument(Exchange exchange) Strategy method to extract the document from the exchange
Class	getDocumentType()
XPathExpression	getExpression()
XPathFunctionResolver	getFunctionResolver()
XPathFunction	getHeaderFunction()
DefaultNamespaceContext	getNamespaceContext()
XPathFunction	getOutBodyFunction()
XPathFunction	getOutHeaderFunction()
QName	getResultQName()
Class	getResultType()
String	getText()
XPathFactory	getXPathFactory()
boolean	matches(Exchange exchange) Evaluates the predicate on the message exchange and returns true if this exchange matches the predicate
XPathBuilder	namespace(String prefix, String uri) Registers the namespace prefix and URI with the builder so that the prefix can be used in XPath expressions
XPathBuilder	namespaces(Namespaces namespaces) Registers namespaces with the builder so that the registered prefixes can be used in XPath expressions
XPathBuilder	nodeResult() Sets the expression result type to boolean
XPathBuilder	nodeSetResult() Sets the expression result type to boolean
XPathBuilder	numberResult() Sets the expression result type to boolean
XPathBuilder	objectModel(String uri) Sets the object model URI to use
protected void	populateDefaultNamespaces(DefaultNamespaceContext context) Lets populate a number of standard prefixes if they are not already there
XPathBuilder	resultType(Class<?> resultType) Sets the expression result type to boolean
void	setBodyFunction(XPathFunction bodyFunction)
void	setDocumentType(Class documentType)
void	setFunctionResolver(XPathFunctionResolver functionResolver)
void	setHeaderFunction(XPathFunction headerFunction)
void	setNamespaceContext(DefaultNamespaceContext namespaceContext)
protected void	setNamespaceIfNotPresent(DefaultNamespaceContext context, String prefix, String uri)
void	setNamespaces(Map<String,String> namespaces) Injects the XML Namespaces of prefix -> uri mappings
void	setOutBodyFunction(XPathFunction outBodyFunction)
void	setOutHeaderFunction(XPathFunction outHeaderFunction)
void	setResultQName(QName resultQName)
void	setResultType(Class resultType)
void	setXPathFactory(XPathFactory xpathFactory)
XPathBuilder	stringResult() Sets the expression result type to boolean
String	toString()
XPathBuilder	variable(String name, Object value) Registers a variable (in the global namespace) which can be referred to from XPath expressions
static XPathBuilder	xpath(String text)
static XPathBuilder	xpath(String text, Class resultType)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

XPathBuilder

public XPathBuilder(String text)

Method Detail

xpath

public static XPathBuilder xpath(String text)

xpath

public static XPathBuilder xpath(String text,
                                 Class resultType)

toString

public String toString()

Overrides:

toString in class Object

matches

public boolean matches(Exchange exchange)

Description copied from interface: Predicate

Evaluates the predicate on the message exchange and returns true if this exchange matches the predicate

Specified by:

matches in interface Predicate

Parameters:

exchange - the message exchange

Returns:

true if the predicate matches

assertMatches

public void assertMatches(String text,
                          Exchange exchange)
                   throws AssertionError

Throws:

AssertionError

evaluate

public Object evaluate(Exchange exchange)

evaluate

public <T> T evaluate(Exchange exchange,
                      Class<T> type)

Description copied from interface: Expression

Returns the value of the expression on the given exchange

Specified by:

evaluate in interface Expression

Parameters:

exchange - the message exchange on which to evaluate the expression

type - the expected type of the evaluation result

Returns:

the value of the expression

booleanResult

public XPathBuilder booleanResult()

Sets the expression result type to boolean

Returns:

the current builder

nodeResult

public XPathBuilder nodeResult()

Sets the expression result type to boolean

Returns:

the current builder

nodeSetResult

public XPathBuilder nodeSetResult()

Sets the expression result type to boolean

Returns:

the current builder

numberResult

public XPathBuilder numberResult()

Sets the expression result type to boolean

Returns:

the current builder

stringResult

public XPathBuilder stringResult()

Sets the expression result type to boolean

Returns:

the current builder

resultType

public XPathBuilder resultType(Class<?> resultType)

Sets the expression result type to boolean

Returns:

the current builder

objectModel

public XPathBuilder objectModel(String uri)

Sets the object model URI to use

Returns:

the current builder

functionResolver

public XPathBuilder functionResolver(XPathFunctionResolver functionResolver)

Sets the XPathFunctionResolver instance to use on these XPath expressions

Returns:

the current builder

namespace

public XPathBuilder namespace(String prefix,
                              String uri)

Registers the namespace prefix and URI with the builder so that the prefix can be used in XPath expressions

Parameters:

prefix - is the namespace prefix that can be used in the XPath expressions

uri - is the namespace URI to which the prefix refers

Returns:

the current builder

namespaces

public XPathBuilder namespaces(Namespaces namespaces)

Registers namespaces with the builder so that the registered prefixes can be used in XPath expressions

Parameters:

namespaces - is namespaces object that should be used in the XPath expression

Returns:

the current builder

variable

public XPathBuilder variable(String name,
                             Object value)

Registers a variable (in the global namespace) which can be referred to from XPath expressions

getXPathFactory

public XPathFactory getXPathFactory()
                             throws XPathFactoryConfigurationException

Throws:

XPathFactoryConfigurationException

setXPathFactory

public void setXPathFactory(XPathFactory xpathFactory)

getDocumentType

public Class getDocumentType()

setDocumentType

public void setDocumentType(Class documentType)

getText

public String getText()

getResultQName

public QName getResultQName()

setResultQName

public void setResultQName(QName resultQName)

getNamespaceContext

public DefaultNamespaceContext getNamespaceContext()

setNamespaceContext

public void setNamespaceContext(DefaultNamespaceContext namespaceContext)

getFunctionResolver

public XPathFunctionResolver getFunctionResolver()

setFunctionResolver

public void setFunctionResolver(XPathFunctionResolver functionResolver)

getExpression

public XPathExpression getExpression()
                              throws XPathFactoryConfigurationException,
                                     XPathExpressionException

Throws:

XPathFactoryConfigurationException

XPathExpressionException

setNamespaces

public void setNamespaces(Map<String,String> namespaces)

Description copied from interface: NamespaceAware

Injects the XML Namespaces of prefix -> uri mappings

Specified by:

setNamespaces in interface NamespaceAware

Parameters:

namespaces - the XML namespaces with the key of prefixes and the value the URIs

getBodyFunction

public XPathFunction getBodyFunction()

setBodyFunction

public void setBodyFunction(XPathFunction bodyFunction)

getHeaderFunction

public XPathFunction getHeaderFunction()

setHeaderFunction

public void setHeaderFunction(XPathFunction headerFunction)

getOutBodyFunction

public XPathFunction getOutBodyFunction()

setOutBodyFunction

public void setOutBodyFunction(XPathFunction outBodyFunction)

getOutHeaderFunction

public XPathFunction getOutHeaderFunction()

setOutHeaderFunction

public void setOutHeaderFunction(XPathFunction outHeaderFunction)

getResultType

public Class getResultType()

setResultType

public void setResultType(Class resultType)

evaluateAs

protected Object evaluateAs(Exchange exchange,
                            QName resultQName)

Evaluates the expression as the given result type

createXPathExpression

protected XPathExpression createXPathExpression()
                                         throws XPathExpressionException,
                                                XPathFactoryConfigurationException

Throws:

XPathExpressionException

XPathFactoryConfigurationException

populateDefaultNamespaces

protected void populateDefaultNamespaces(DefaultNamespaceContext context)

Lets populate a number of standard prefixes if they are not already there

setNamespaceIfNotPresent

protected void setNamespaceIfNotPresent(DefaultNamespaceContext context,
                                        String prefix,
                                        String uri)

createDefaultFunctionResolver

protected XPathFunctionResolver createDefaultFunctionResolver(XPathFunctionResolver parent)

getDocument

protected Object getDocument(Exchange exchange)

Strategy method to extract the document from the exchange