LSInput (Java Platform SE 8 )

```
public interface LSInput
```
此接口表示数据的输入源。
这个接口允许应用程序封装在一个对象的一个输入源的信息，其中可能包括一个公共标识符，系统标识符，一个字节流（可能有一个指定的编码），基URI和/或字符流。

一个字节流和一个字符流的确切定义是绑定依赖的。

该应用程序预计将提供对象，实现这个接口时，这样的对象是必要的。应用程序可以提供它自己的对象实现这个接口，也可以使用通用的工厂方法DOMImplementationLS.createLSInput()创造实现此接口的对象。

的LSParser将使用LSInput对象来确定如何读取数据。的LSParser将按以下顺序知道读哪一个在LSInput指定不同的输入，第一个是不空，不空字符串将被使用：
1. LSInput.characterStream
2. LSInput.byteStream
3. LSInput.stringData
4. LSInput.systemId
5. LSInput.publicId
如果所有的输入都是无效的，这LSParser将报告其DOMError.type设置"no-input-specified"及其DOMError.severity设置DOMError.SEVERITY_FATAL_ERROR DOMError。

LSInput对象属于应用。DOM实现，不会修改（尽管它可以复制和修改的副本，如果必要的话）。

又见Document Object Model (DOM) Level 3 Load and Save Specification。

方法摘要

所有方法接口方法抽象方法
Modifier and Type	Method and Description
`String`	`getBaseURI()` 的基URI被使用（见第5.1.4在[ IETF RFC 2396 ]）为解决相对 `systemId`到绝对URI。
`InputStream`	`getByteStream()` 表示一个字节流的语言和绑定依赖类型的属性。
`boolean`	`getCertifiedText()` 如果设置为true，假设输入的认证（见第2.13 XML 1.1 ] [解析] [ XML 1.1）。
`Reader`	`getCharacterStream()` 表示一个表示16位单元的流的语言和绑定依赖类型的属性。
`String`	`getEncoding()` 字符编码，如果已知。
`String`	`getPublicId()` 用于此输入源的公共标识符。
`String`	`getStringData()` 字符串数据解析。
`String`	`getSystemId()` 系统标识符URI引用[ IETF RFC 2396 ]，这个输入源。
`void`	`setBaseURI(String baseURI)` 的基URI被使用（见第5.1.4在[ IETF RFC 2396 ]）为解决相对 `systemId`到绝对URI。
`void`	`setByteStream(InputStream byteStream)` 表示一个字节流的语言和绑定依赖类型的属性。
`void`	`setCertifiedText(boolean certifiedText)` 如果设置为true，假设输入的认证（见第2.13 XML 1.1 ] [解析] [ XML 1.1）。
`void`	`setCharacterStream(Reader characterStream)` 表示一个表示16位单元的流的语言和绑定依赖类型的属性。
`void`	`setEncoding(String encoding)` 字符编码，如果已知。
`void`	`setPublicId(String publicId)` 用于此输入源的公共标识符。
`void`	`setStringData(String stringData)` 字符串数据解析。
`void`	`setSystemId(String systemId)` 系统标识符URI引用[ IETF RFC 2396 ]，这个输入源。

- 方法详细信息
  - getCharacterStream
```
Reader getCharacterStream()
```
    表示一个表示16位单元的流的语言和绑定依赖类型的属性。应用程序必须使用UTF-16编码流（在[UNICDOE]和ISO / IEC 10646定义[ ]）。使用字符流时有一个XML声明不是一个要求。如果一个XML声明是存在的，编码属性的值将被忽略。
  - setCharacterStream
```
void setCharacterStream(Reader characterStream)
```
    表示一个表示16位单元的流的语言和绑定依赖类型的属性。应用程序必须使用UTF-16编码流（在[UNICDOE]和ISO / IEC 10646定义[ ]）。使用字符流时有一个XML声明不是一个要求。如果一个XML声明是存在的，编码属性的值将被忽略。
  - getByteStream
```
InputStream getByteStream()
```
    表示一个字节流的语言和绑定依赖类型的属性。
    如果应用程序知道字节流的字符编码，应设置编码属性。在这种方式中设置编码将覆盖数据中的XML声明中指定的任何编码。
  - setByteStream
```
void setByteStream(InputStream byteStream)
```
    表示一个字节流的语言和绑定依赖类型的属性。
    如果应用程序知道字节流的字符编码，应设置编码属性。在这种方式中设置编码将覆盖数据中的XML声明中指定的任何编码。
  - getStringData
```
String getStringData()
```
    字符串数据解析。如果提供，这将一直被视为一个序列的16位单元（UTF-16编码字符）。它不是一个要求有一个XML声明时使用 stringData。如果一个XML声明是存在的，编码属性的值将被忽略。
  - setStringData
```
void setStringData(String stringData)
```
    字符串数据解析。如果提供，这将一直被视为一个序列的16位单元（UTF-16编码字符）。它不是一个要求有一个XML声明时使用 stringData。如果一个XML声明是存在的，编码属性的值将被忽略。
  - getSystemId
```
String getSystemId()
```
    系统标识符URI引用[ IETF RFC 2396 ]，这个输入源。如果有一个字节流、一个字符流或字符串数据，则系统标识符是可选的。它提供了一个有用的仍然是，因为应用程序将使用它来解决任何相对URI，它包括在错误信息和警告。（这lsparser只会尝试如果没有其他输入的输入源。可获取资源的URI引用确定）
    如果应用程序知道对象的字符编码所指向的系统标识符，它可以设置编码使用 encoding属性。
    如果指定的系统ID是一个相对URI引用（见[ IETF RFC 2396 ] 5段），DOM实现将尝试解决与 baseURI为基础的相对URI，如果失败，该行为是依赖于实现的。
  - setSystemId
```
void setSystemId(String systemId)
```
    系统标识符URI引用[ IETF RFC 2396 ]，这个输入源。如果有一个字节流、一个字符流或字符串数据，则系统标识符是可选的。它提供了一个有用的仍然是，因为应用程序将使用它来解决任何相对URI，它包括在错误信息和警告。（这lsparser只会尝试如果没有其他输入的输入源。可获取资源的URI引用确定）
    如果应用程序知道对象的字符编码所指向的系统标识符，它可以设置编码使用 encoding属性。
    如果指定的系统ID是一个相对URI引用（见[ IETF RFC 2396 ] 5段），DOM实现将尝试解决与 baseURI为基础的相对URI，如果失败，该行为是依赖于实现的。
  - getPublicId
```
String getPublicId()
```
    用于此输入源的公共标识符。这可能被映射到一个输入源，使用依赖于实现的机制（如目录或其他映射）。公共标识符，如果指定的，也可以报告作为位置信息的一部分，当错误报告。
  - setPublicId
```
void setPublicId(String publicId)
```
    用于此输入源的公共标识符。这可能被映射到一个输入源，使用依赖于实现的机制（如目录或其他映射）。公共标识符，如果指定的，也可以报告作为位置信息的一部分，当错误报告。
  - getBaseURI
```
String getBaseURI()
```
    的基URI被使用（见第5.1.4在[ IETF RFC 2396 ]）为解决相对 systemId到绝对URI。
    如果使用时的基URI本身是一个相对URI，空字符串，或者为空，行为是依赖于实现的。
  - setBaseURI
```
void setBaseURI(String baseURI)
```
    的基URI被使用（见第5.1.4在[ IETF RFC 2396 ]）为解决相对 systemId到绝对URI。
    如果使用时的基URI本身是一个相对URI，空字符串，或者为空，行为是依赖于实现的。
  - getEncoding
```
String getEncoding()
```
    字符编码，如果已知。编码必须是一个可接受的XML编码声明字符串（[ XML 1.0 ]第4.3.3”实体中的字符编码”）。
    这个属性不起作用时，应用程序提供了一个字符或字符串数据流。其他来源的输入，编码通过此属性指定将覆盖任何编码的XML声明或文本中指定的声明，或编码从较高级别的协议，例如HTTP [ IETF RFC 2616 ]。
  - setEncoding
```
void setEncoding(String encoding)
```
    字符编码，如果已知。编码必须是一个可接受的XML编码声明字符串（[ XML 1.0 ]第4.3.3”实体中的字符编码”）。
    这个属性不起作用时，应用程序提供了一个字符或字符串数据流。其他来源的输入，编码通过此属性指定将覆盖任何编码的XML声明或文本中指定的声明，或编码从较高级别的协议，例如HTTP [ IETF RFC 2616 ]。
  - getCertifiedText
```
boolean getCertifiedText()
```
    如果设置为true，假设输入的认证（见第2.13 XML 1.1 ] [解析] [ XML 1.1）。
  - setCertifiedText
```
void setCertifiedText(boolean certifiedText)
```
    如果设置为true，假设输入的认证（见第2.13 XML 1.1 ] [解析] [ XML 1.1）。

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Interface LSInput

方法摘要

方法详细信息

getCharacterStream

setCharacterStream

getByteStream

setByteStream

getStringData

setStringData

getSystemId

setSystemId

getPublicId

setPublicId

getBaseURI

setBaseURI

getEncoding

setEncoding

getCertifiedText

setCertifiedText