Class XMLInputSource


  • public class XMLInputSource
    extends java.lang.Object
    This class represents an input source for an XML document. The basic properties of an input source are the following:
    • public identifier
    • system identifier
    • byte stream or character stream
    • Field Summary

      Fields 
      Modifier and Type Field Description
      private java.lang.String baseSystemId_
      Base system identifier.
      private java.io.InputStream byteStream_
      Byte stream.
      private java.io.Reader charStream_
      Character stream.
      private java.lang.String encoding_
      Encoding.
      private java.lang.String publicId_
      Public identifier.
      private java.lang.String systemId_
      System identifier.
    • Constructor Summary

      Constructors 
      Constructor Description
      XMLInputSource​(java.lang.String publicId, java.lang.String systemId, java.lang.String baseSystemId)
      Constructs an input source from just the public and system identifiers, leaving resolution of the entity and opening of the input stream up to the caller.
      XMLInputSource​(java.lang.String publicId, java.lang.String systemId, java.lang.String baseSystemId, java.io.InputStream byteStream, java.lang.String encoding)
      Constructs an input source from a byte stream.
      XMLInputSource​(java.lang.String publicId, java.lang.String systemId, java.lang.String baseSystemId, java.io.Reader charStream, java.lang.String encoding)
      Constructs an input source from a character stream.
    • Field Detail

      • publicId_

        private java.lang.String publicId_
        Public identifier.
      • systemId_

        private java.lang.String systemId_
        System identifier.
      • baseSystemId_

        private java.lang.String baseSystemId_
        Base system identifier.
      • byteStream_

        private java.io.InputStream byteStream_
        Byte stream.
      • charStream_

        private java.io.Reader charStream_
        Character stream.
      • encoding_

        private java.lang.String encoding_
        Encoding.
    • Constructor Detail

      • XMLInputSource

        public XMLInputSource​(java.lang.String publicId,
                              java.lang.String systemId,
                              java.lang.String baseSystemId)
        Constructs an input source from just the public and system identifiers, leaving resolution of the entity and opening of the input stream up to the caller.
        Parameters:
        publicId - The public identifier, if known.
        systemId - The system identifier. This value should always be set, if possible, and can be relative or absolute. If the system identifier is relative, then the base system identifier should be set.
        baseSystemId - The base system identifier. This value should always be set to the fully expanded URI of the base system identifier, if possible.
      • XMLInputSource

        public XMLInputSource​(java.lang.String publicId,
                              java.lang.String systemId,
                              java.lang.String baseSystemId,
                              java.io.InputStream byteStream,
                              java.lang.String encoding)
        Constructs an input source from a byte stream.
        Parameters:
        publicId - The public identifier, if known.
        systemId - The system identifier. This value should always be set, if possible, and can be relative or absolute. If the system identifier is relative, then the base system identifier should be set.
        baseSystemId - The base system identifier. This value should always be set to the fully expanded URI of the base system identifier, if possible.
        byteStream - The byte stream.
        encoding - The encoding of the byte stream, if known.
      • XMLInputSource

        public XMLInputSource​(java.lang.String publicId,
                              java.lang.String systemId,
                              java.lang.String baseSystemId,
                              java.io.Reader charStream,
                              java.lang.String encoding)
        Constructs an input source from a character stream.
        Parameters:
        publicId - The public identifier, if known.
        systemId - The system identifier. This value should always be set, if possible, and can be relative or absolute. If the system identifier is relative, then the base system identifier should be set.
        baseSystemId - The base system identifier. This value should always be set to the fully expanded URI of the base system identifier, if possible.
        charStream - The character stream.
        encoding - The original encoding of the byte stream used by the reader, if known.
    • Method Detail

      • setPublicId

        public void setPublicId​(java.lang.String publicId)
        Sets the public identifier.
        Parameters:
        publicId - The new public identifier.
      • getPublicId

        public java.lang.String getPublicId()
        Returns:
        the public identifier.
      • setSystemId

        public void setSystemId​(java.lang.String systemId)
        Sets the system identifier.
        Parameters:
        systemId - The new system identifier.
      • getSystemId

        public java.lang.String getSystemId()
        Returns:
        the system identifier.
      • setBaseSystemId

        public void setBaseSystemId​(java.lang.String baseSystemId)
        Sets the base system identifier.
        Parameters:
        baseSystemId - The new base system identifier.
      • getBaseSystemId

        public java.lang.String getBaseSystemId()
        Returns:
        the base system identifier.
      • setByteStream

        public void setByteStream​(java.io.InputStream byteStream)
        Sets the byte stream. If the byte stream is not already opened when this object is instantiated, then the code that opens the stream should also set the byte stream on this object. Also, if the encoding is auto-detected, then the encoding should also be set on this object.
        Parameters:
        byteStream - The new byte stream.
      • getByteStream

        public java.io.InputStream getByteStream()
        Returns:
        the byte stream.
      • setCharacterStream

        public void setCharacterStream​(java.io.Reader charStream)
        Sets the character stream. If the character stream is not already opened when this object is instantiated, then the code that opens the stream should also set the character stream on this object. Also, the encoding of the byte stream used by the reader should also be set on this object, if known.
        Parameters:
        charStream - The new character stream.
        See Also:
        setEncoding(String)
      • getCharacterStream

        public java.io.Reader getCharacterStream()
        Returns:
        the character stream.
      • setEncoding

        public void setEncoding​(java.lang.String encoding)
        Sets the encoding of the stream.
        Parameters:
        encoding - The new encoding.
      • getEncoding

        public java.lang.String getEncoding()
        Returns:
        the encoding of the stream, or null if not known.