Package org.simpleframework.xml.stream

Class DocumentProvider

  • All Implemented Interfaces:
    Provider
    class DocumentProvider
extends java.lang.Object
implements Provider
    The DocumentProvider object is used to provide event reader implementations for DOM. Wrapping the mechanics of the DOM framework within a Provider ensures that it can be plugged in without any dependencies. This allows other parsers to be swapped in should there be such a requirement.
    See Also:
    DocumentProvider

    • Field Summary

      Fields 
      Modifier and Type Field Description
      private javax.xml.parsers.DocumentBuilderFactory factory
      This is the factory that is used to create DOM parsers.

    • Constructor Summary

      Constructors 
      Constructor Description
      DocumentProvider()
      Constructor for the DocumentProvider object.

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      EventReader provide​(java.io.InputStream source)
      This provides an EventReader that will read from the specified input stream.
      EventReader provide​(java.io.Reader source)
      This provides an EventReader that will read from the specified reader.
      private EventReader provide​(org.xml.sax.InputSource source)
      This provides an EventReader that will read from the specified source.

      • Methods inherited from class java.lang.Object

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

    • Field Detail

      • factory

        private final javax.xml.parsers.DocumentBuilderFactory factory
        This is the factory that is used to create DOM parsers.

    • Constructor Detail

      • DocumentProvider

        public DocumentProvider()
        Constructor for the DocumentProvider object. This is used to instantiate a parser factory that will be used to create parsers when requested. Instantiating the factory up front also checks that the framework is fully supported.

    • Method Detail

      • provide

        public EventReader provide​(java.io.InputStream source)
                    throws java.lang.Exception
        This provides an EventReader that will read from the specified input stream. When reading from an input stream the character encoding should be taken from the XML prolog or it should default to the UTF-8 character encoding.
        Specified by:
        provide in interface Provider
        Parameters:
        source - this is the stream to read the document with
        Returns:
        this is used to return the event reader implementation
        Throws:
        java.lang.Exception

      • provide

        public EventReader provide​(java.io.Reader source)
                    throws java.lang.Exception
        This provides an EventReader that will read from the specified reader. When reading from a reader the character encoding should be the same as the source XML document.
        Specified by:
        provide in interface Provider
        Parameters:
        source - this is the reader to read the document with
        Returns:
        this is used to return the event reader implementation
        Throws:
        java.lang.Exception

      • provide

        private EventReader provide​(org.xml.sax.InputSource source)
                     throws java.lang.Exception
        This provides an EventReader that will read from the specified source. When reading from a source the character encoding should be the same as the source XML document.
        Parameters:
        source - this is the source to read the document with
        Returns:
        this is used to return the event reader implementation
        Throws:
        java.lang.Exception