Package com.bea.wli.sb.sources

Class DOMSource

java.lang.Object
com.bea.wli.sb.sources.DOMSource
All Implemented Interfaces:
Source
public final class DOMSource extends Object implements Source
Document Object Model (DOM) Source

A Source whose content comes from a DOM node. The referenced node may be a full-fledged org.w3c.dom.Document, but it may also be an internal node in a larger document.

The serialization representation is XML text with a particular chracter set encoding. The encoding used can be specified via TransformOptions.

  • Field Details

    • DOM_IMPL_LS

      public static final String DOM_IMPL_LS
      an optional transform option that tells the source/transformer to use the specified instance of org.w3c.dom.ls.DOMImplementationLS to for creation of DOM nodes e.g. 
         DOMImplementationRegistry registry = DOMImplementationRegistry.newInstance();
   DOMImplementationLS lsImpl = (DOMImplementationLS)registry.getDOMImplementation("LS");
       (or something like
           lsImpl = oracle.xml.parser.v2.XMLDOMImplementation()
       )
   options.put(DOMSource.DOM_IMPL_LS, lsImpl);
   DOMSource dom = ...getTransformer().transform(source, DOMSource.class, options);
      If not specified, the default platform DOM implementation LS will be used.
      See Also:

    • WRITE_XMLDECL

      public static final String WRITE_XMLDECL
      an optional transform option that tells the DOMSource writeTo method to write out XMLDECL when serializing the DOM object.
      See Also:

  • Constructor Details

    • DOMSource

      public DOMSource(Node node)

    • DOMSource

      public DOMSource(Node node, int size)
      Create a new input source with a DOM node, and with the system ID also passed in as the base URI.
      Parameters:
      node - The DOM node that will be this Source's content
      systemID - Specifies the base URI associated with node.

    • DOMSource

      public DOMSource(Node n, String id)

    • DOMSource

      public DOMSource(Node node, String systemID, int size)

  • Method Details

    • getNode

      public Node getNode()
      Get the underlying DOM node for this Source

    • getSystemId

      public String getSystemId()
      Get the base ID (URL or system ID)
      Returns:
      Base URL for this DOM tree.

    • getInputStream

      public InputStream getInputStream(TransformOptions options) throws IOException, TransformException
      Description copied from interface: Source
      Returns streaming byte-baseed representation of the Source's content. The representation of that serialization is entirely up to the Source. Note that this method may involve an internal transformation, although it should not in any way change the underlying content.
      Specified by:
      getInputStream in interface Source
      Parameters:
      options - Options used to affect the serialization
      Returns:
      an InputStream for retrieving the serialized content
      Throws:
      IOException
      TransformException

    • dumpTo

      public void dumpTo(OutputStream os, TransformOptions options) throws IOException, TransformException
      Throws:
      IOException
      TransformException

    • writeTo

      public void writeTo(OutputStream os, TransformOptions options) throws IOException, TransformException
      Description copied from interface: Source
      Serializes the Source's content to a byte-based stream. The representation of that serialization is entirely up to the Source. The Source is forbidden from closing the provided OutputStream, although it is allowed to flush it. However, flushing the stream should be left to the caller, if possible.

      Note that this method may involve an internal transformation, although it should not in any way change the underlying content.

      Specified by:
      writeTo in interface Source
      Parameters:
      os - the OutputStream to which serialized content will be written
      options - TransformOptions used to affect the serialization
      Throws:
      IOException
      TransformException