Class XPathExpression

All Implemented Interfaces:
org.apache.camel.Expression, org.apache.camel.ExpressionFactory, HasExpressionType, org.apache.camel.Predicate, org.apache.camel.PredicateFactory, org.apache.camel.spi.ExpressionFactoryAware, org.apache.camel.spi.NamespaceAware, org.apache.camel.spi.PredicateFactoryAware

@Metadata(firstVersion="1.1.0", label="language,core,xml", title="XPath") public class XPathExpression extends NamespaceAwareExpression
Evaluates an XPath expression against an XML payload.
  • Constructor Details

    • XPathExpression

      public XPathExpression()
    • XPathExpression

      public XPathExpression(String expression)
    • XPathExpression

      public XPathExpression(org.apache.camel.Expression expression)
  • Method Details

    • 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

    • getResultQName

      public String getResultQName()
    • setResultQName

      public void setResultQName(String resultQName)
      Sets the output type supported by XPath.
    • 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 troubleshooting
    • getLogNamespaces

      public String getLogNamespaces()
    • 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.

    • getPreCompile

      public String getPreCompile()
    • setPreCompile

      public void setPreCompile(String preCompile)
      Whether to enable pre-compiling the xpath expression during initialization phase. pre-compile is enabled by default.

      This can be used to turn off, for example in cases the compilation phase is desired at the starting phase, such as if the application is ahead of time compiled (for example with camel-quarkus) which would then load the xpath factory of the built operating system, and not a JVM runtime.