Package com.adaptris.core.services.splitter

Class XpathDocumentCopier

  • All Implemented Interfaces:
    MessageSplitter
    public class XpathDocumentCopier
extends MessageCopier

    Implementation of MessageSplitter which creates multiple instances of the same XML document based on an XPath.

    The split messages will always contain the entire document, the XPath evaluation simply provides information on how many documents to produce and should always return an integer.

    Given the following input document

     
 <envelope>
   <document>one</document>
   <document>two</document>
   <document>three</document>
 </envelope>

    You could use the xpath count(/envelope/document) to split into 3 documents; each of which contains the whole XML document.

    If the DocumentBuilderFactoryBuilder has been explicitly set to be not namespace aware and the document does in fact contain namespaces, then Saxon can cause merry havoc in the sense that //NonNamespaceXpath doesn't work if the document has namespaces in it. We have included a shim so that behaviour can be toggled based on what you have configured.

    See Also:
    XPath.newXPathInstance(DocumentBuilderFactoryBuilder, NamespaceContext)

    In the adapter configuration file this class is aliased as xpath-document-copier which is the preferred alternative to the fully qualified classname when building your configuration.

    • Constructor Detail

      • XpathDocumentCopier

        public XpathDocumentCopier()

      • XpathDocumentCopier

        public XpathDocumentCopier​(java.lang.String xpath)

    • Method Detail

      • splitMessage

        public CloseableIterable<AdaptrisMessage> splitMessage​(AdaptrisMessage msg)
                                                throws CoreException
        Description copied from interface: MessageSplitter

        Splits an AdaptrisMessage into some number of AdaptrisMessage objects. Preservation of metadata is down to the implementation.

        If this method returns a com.adaptris.core.util.CloseableIterable, it must be closed by the caller! This contract cannot be clearly expressed in Java code without breaking the API in uncomfortable ways for things just returning a List, which is why this method is only declared to return Iterable.

        Parameters:
        msg - the msg to split
        Returns:
        an Iterable of AdaptrisMessage
        Throws:
        CoreException - wrapping any other exception

      • setXpath

        public void setXpath​(java.lang.String xp)
        Set the XPath to use to extract the individual messages
        Parameters:
        xp - the XPath

      • getXpath

        public java.lang.String getXpath()
        Get the XPath to use to extract the individual messages.
        Returns:
        the XPath as a String

      • getNamespaceContext

        public KeyValuePairSet getNamespaceContext()
        Returns:
        the namespaceContext