构造方法详细信息

• InputSource

  public InputSource()

  零参数默认构造函数。

  另请参见：

  setPublicId(java.lang.String) ， setSystemId(java.lang.String) ， setByteStream(java.io.InputStream) ， setCharacterStream(java.io.Reader) ， setEncoding(java.lang.String)

• InputSource

  public InputSource​(String systemId)

  使用系统标识符创建新的输入源。

  应用程序也可以使用setPublicId来包含公共标识符，或者使用setEncoding来指定字符编码（如果已知）。

  如果系统标识符是URL，则必须完全解析（可能不是相对URL）。

  参数

  systemId - 系统标识符（URI）。

  另请参见：

  setPublicId(java.lang.String) ， setSystemId(java.lang.String) ， setByteStream(java.io.InputStream) ， setEncoding(java.lang.String) ， setCharacterStream(java.io.Reader)

• InputSource

  public InputSource​(InputStream byteStream)

  使用字节流创建新的输入源。

  应用程序编写者应该使用setSystemId（）来提供解析相对URI的基础，可以使用setPublicId来包含公共标识符，并且可以使用setEncoding来指定对象的字符编码。

  参数

  byteStream - 包含文档的原始字节流。

  另请参见：

  setPublicId(java.lang.String) ， setSystemId(java.lang.String) ， setEncoding(java.lang.String) ， setByteStream(java.io.InputStream) ， setCharacterStream(java.io.Reader)

• InputSource

  public InputSource​(Reader characterStream)

  使用字符流创建新的输入源。

  应用程序编写者应该使用setSystemId（）来提供解析相对URI的基础，并且可以使用setPublicId来包含公共标识符。

  字符流不应包含字节顺序标记。

  另请参见：

  setPublicId(java.lang.String) ， setSystemId(java.lang.String) ， setByteStream(java.io.InputStream) ， setCharacterStream(java.io.Reader)

方法详细信息

• setPublicId

  public void setPublicId​(String publicId)

  设置此输入源的公共标识符。

  公共标识符始终是可选的：如果应用程序编写器包含一个，它将作为位置信息的一部分提供。

  参数

  publicId - 公共标识符作为字符串。

  另请参见：

  getPublicId() ， Locator.getPublicId() ， SAXParseException.getPublicId()

• getPublicId

  public String getPublicId()

  获取此输入源的公共标识符。

  结果

  公共标识符，如果没有提供，则为null。

  另请参见：

  setPublicId(java.lang.String)

• setSystemId

  public void setSystemId​(String systemId)

  设置此输入源的系统标识符。

  如果存在字节流或字符流，则系统标识符是可选的，但是提供一个字符串仍然很有用，因为应用程序可以使用它来解析相对URI并将其包含在错误消息和警告中（解析器将尝试仅在没有指定字节流或字符流时才打开与URI的连接。

  如果应用程序知道系统标识符指向的对象的字符编码，则它可以使用setEncoding方法注册编码。

  如果系统标识符是URL，则必须完全解析（可能不是相对URL）。

  参数

  systemId - 系统标识符为字符串。

  另请参见：

  setEncoding(java.lang.String) ， getSystemId() ， Locator.getSystemId() ， SAXParseException.getSystemId()

• getSystemId

  public String getSystemId()

  获取此输入源的系统标识符。

  getEncoding方法将返回指向的对象的字符编码，如果未知则返回null。

  如果系统ID是URL，则将完全解析。

  结果

  系统标识符，如果没有提供，则为null。

  另请参见：

  setSystemId(java.lang.String) ， getEncoding()

• setByteStream

  public void setByteStream​(InputStream byteStream)

  设置此输入源的字节流。

  如果还指定了字符流，SAX解析器将忽略它，但它将优先使用字节流来打开URI连接本身。

  如果应用程序知道字节流的字符编码，则应使用setEncoding方法设置它。

  参数

  byteStream - 包含XML文档或其他实体的字节流。

  另请参见：

  setEncoding(java.lang.String) ， getByteStream() ， getEncoding() ， InputStream

• getByteStream

  public InputStream getByteStream()

  获取此输入源的字节流。

  getEncoding方法将返回此字节流的字符编码，如果未知则返回null。

  结果

  字节流，如果没有提供，则为null。

  另请参见：

  getEncoding() ， setByteStream(java.io.InputStream)

• setEncoding

  public void setEncoding​(String encoding)

  设置字符编码（如果已知）。

  编码必须是XML编码声明可接受的字符串（请参阅XML 1.0建议的第4.3.3节）。

  当应用程序提供字符流时，此方法无效。

  参数

  encoding - 描述字符编码的字符串。

  另请参见：

  setSystemId(java.lang.String) ， setByteStream(java.io.InputStream) ， getEncoding()

• getEncoding

  public String getEncoding()

  获取字节流或URI的字符编码。 当应用程序提供字符流时，将忽略此值。

  结果

  编码，如果没有提供，则为null。

  另请参见：

  setByteStream(java.io.InputStream) ， getSystemId() ， getByteStream()

• setCharacterStream

  public void setCharacterStream​(Reader characterStream)

  设置此输入源的字符流。

  如果指定了字符流，SAX解析器将忽略任何字节流，并且不会尝试打开与系统标识符的URI连接。

  参数

  characterStream - 包含XML文档或其他实体的字符流。

  另请参见：

  getCharacterStream() ， Reader

• getCharacterStream

  public Reader getCharacterStream()

  获取此输入源的字符流。

  结果

  字符流，如果没有提供，则为null。

  另请参见：

  setCharacterStream(java.io.Reader)

• isEmpty

  public boolean isEmpty()

  指示InputSource对象是否为空。 Empty定义如下：

  • 所有输入源（包括公共标识符，系统标识符，字节流和字符流）均为null 。
  • 公共标识符和系统标识符为null ，字节和字符流为null或不包含字节或字符。

    请注意，如果提供了字节流，则此方法将重置字节流;如果未提供字节流，则此方法将重置字符流。

  如果在检查字节或字符流时出错，该方法将返回false以允许XML处理器处理错误。

  结果

  如果 InputSource对象为空，则返回true，否则返回false