org.apache.camel.model.language

Class XPathExpression

java.lang.Object

org.apache.camel.model.language.ExpressionDefinition

org.apache.camel.model.language.NamespaceAwareExpression

org.apache.camel.model.language.XPathExpression

All Implemented Interfaces:

org.apache.camel.Expression, org.apache.camel.ExpressionFactory, org.apache.camel.Predicate, org.apache.camel.spi.NamespaceAware

@Metadata(firstVersion="1.1.0",
          label="language,core,xml",
          title="XPath")
public class XPathExpression
extends NamespaceAwareExpression

To use XPath (XML) in Camel expressions or predicates.

Constructor Summary

Constructors

Constructor and Description
XPathExpression()
XPathExpression(org.apache.camel.Expression expression)
XPathExpression(String expression)

Method Summary

Modifier and Type	Method and Description
Class<?>	getDocumentType()
String	getDocumentTypeName()
String	getFactoryRef()
String	getHeaderName()
String	getLanguage()
String	getLogNamespaces()
String	getObjectModel()
Class<?>	getResultType()
String	getResultTypeName()
String	getSaxon()
String	getThreadSafety()
XPathFactory	getXPathFactory()
void	setDocumentType(Class<?> documentType) Class for document type to use The default value is org.w3c.dom.Document
void	setDocumentTypeName(String documentTypeName) Name of class for document type The default value is org.w3c.dom.Document
void	setFactoryRef(String factoryRef) References to a custom XPathFactory to lookup in the registry
void	setHeaderName(String headerName) Name of header to use as input, instead of the message body
void	setLogNamespaces(String logNamespaces) Whether to log namespaces which can assist during trouble shooting
void	setObjectModel(String objectModel) The XPath object model to use
void	setResultType(Class<?> resultType) Sets the class of the result type (type from output).
void	setResultTypeName(String resultTypeName) Sets the class name of the result type (type from output) The default result type is NodeSet
void	setSaxon(String saxon) Whether to use Saxon.
void	setThreadSafety(String threadSafety) Whether to enable thread-safety for the returned result of the xpath expression.
void	setXPathFactory(XPathFactory xpathFactory)

Methods inherited from class org.apache.camel.model.language.NamespaceAwareExpression

getNamespaces, setNamespaces

Methods inherited from class org.apache.camel.model.language.ExpressionDefinition

createExpression, evaluate, getExpression, getExpressionType, getExpressionValue, getId, getLabel, getLabel, getPredicate, getTrim, matches, setExpression, setExpressionType, setExpressionValue, setId, setTrim, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

XPathExpression

public XPathExpression()

XPathExpression

public XPathExpression(String expression)

XPathExpression

public XPathExpression(org.apache.camel.Expression expression)

Method Detail

getLanguage

public String getLanguage()

Overrides:

getLanguage in class ExpressionDefinition

getDocumentType

public Class<?> getDocumentType()

setDocumentType

public void setDocumentType(Class<?> documentType)

Class for document type to use

The default value is org.w3c.dom.Document

getDocumentTypeName

public String getDocumentTypeName()

setDocumentTypeName

public void setDocumentTypeName(String documentTypeName)

Name of class for document type

The default value is org.w3c.dom.Document

getResultType

public Class<?> getResultType()

setResultType

public void setResultType(Class<?> resultType)

Sets the class of the result type (type from output).

The default result type is NodeSet

getResultTypeName

public String getResultTypeName()

setResultTypeName

public void setResultTypeName(String resultTypeName)

Sets the class name of the result type (type from output)

The default result type is NodeSet

setSaxon

public void setSaxon(String saxon)

Whether to use Saxon.

getSaxon

public String getSaxon()

setFactoryRef

public void setFactoryRef(String factoryRef)

References to a custom XPathFactory to lookup in the registry

getFactoryRef

public String getFactoryRef()

setObjectModel

public void setObjectModel(String objectModel)

The XPath object model to use

getObjectModel

public String getObjectModel()

setLogNamespaces

public void setLogNamespaces(String logNamespaces)

Whether to log namespaces which can assist during trouble shooting

getLogNamespaces

public String getLogNamespaces()

getHeaderName

public String getHeaderName()

setHeaderName

public void setHeaderName(String headerName)

Name of header to use as input, instead of the message body

getXPathFactory

public XPathFactory getXPathFactory()

setXPathFactory

public void setXPathFactory(XPathFactory xpathFactory)

getThreadSafety

public String getThreadSafety()

setThreadSafety

public void setThreadSafety(String threadSafety)

Whether to enable thread-safety for the returned result of the xpath expression. This applies to when using NODESET as the result type, and the returned set has multiple elements. In this situation there can be thread-safety issues if you process the NODESET concurrently such as from a Camel Splitter EIP in parallel processing mode. This option prevents concurrency issues by doing defensive copies of the nodes.

It is recommended to turn this option on if you are using camel-saxon or Saxon in your application. Saxon has thread-safety issues which can be prevented by turning this option on.