Class DocumentProvider

java.lang.Object
org.simpleframework.xml.stream.DocumentProvider
All Implemented Interfaces:
Provider

class DocumentProvider extends 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:
  • Field Details

    • factory

      private final DocumentBuilderFactory factory
      This is the factory that is used to create DOM parsers.
  • Constructor Details

    • 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 Details

    • provide

      public EventReader provide(InputStream source) throws 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:
      Exception
    • provide

      public EventReader provide(Reader source) throws 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:
      Exception
    • provide

      private EventReader provide(InputSource source) throws 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:
      Exception