LSInput (Платформа Java SE 7)

```
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 будет отчет a DOMError с DOMError.type набор к "no-input-specified" и DOMError.severity набор к DOMError.SEVERITY_FATAL_ERROR.
LSInput объекты принадлежат приложению. Реализация ДОМА никогда не будет изменять их (хотя она может сделать копии и изменить копии, в случае необходимости).
См. также Объектную модель документа (ДОМ) Загрузка Уровня 3 и Сохраните Спецификацию.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`Строка`	`getBaseURI()` Основной URI, который будет использоваться (см. раздел 5.1.4 в [IETF RFC 2396]) для того, чтобы разрешить родственника `systemId` к абсолютному URI.
`InputStream`	`getByteStream()` Атрибут языка и связывающий зависимый тип, который представляет поток байтов.
`boolean`	`getCertifiedText()` Если установлено в истину, предположите, что ввод сертифицирован (см. раздел 2.13 в [XML 1.1]), анализируя [XML 1.1].
`Читатель`	`getCharacterStream()` Атрибут языка и связывающий зависимый тип, который представляет поток 16-разрядных модулей.
`Строка`	`getEncoding()` Кодировка символов, если известный.
`Строка`	`getPublicId()` Общедоступный идентификатор для этого входного источника.
`Строка`	`getStringData()` Строковые данные проанализировать.
`Строка`	`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)` Если установлено в истину, предположите, что ввод сертифицирован (см. раздел 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 (определенный в [Unicode] и в [ISO/IEC 10646]). Это не требование, чтобы иметь объявление XML при использовании символьных потоков. Если объявление XML будет присутствовать, то значение атрибута кодирования будет проигнорировано.
  - setCharacterStream
```
void setCharacterStream(Reader characterStream)
```
    Атрибут языка и связывающий зависимый тип, который представляет поток 16-разрядных модулей. Приложение должно закодировать поток, используя UTF-16 (определенный в [Unicode] и в [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 (см. раздел 5 в [IETF RFC 2396]), то реализация ДОМА попытается разрешить относительный URI с baseURI как основа, если это перестало работать, поведение является зависящим от реализации.
  - setSystemId
```
void setSystemId(String systemId)
```
    Системный идентификатор, ссылка URI [IETF RFC 2396], для этого входного источника. Системный идентификатор является дополнительным, если есть поток байтов, символьный поток, или строковые данные. Все еще полезно обеспечить один, так как приложение будет использовать это, чтобы разрешить любые относительные URI и может включать это в сообщения об ошибках и предупреждения. (LSParser только попытается выбрать ресурс, идентифицированный ссылкой URI, если не будет никакого другого ввода, доступного во входном источнике.)
    Если приложение знает кодировку символов объекта, на который указывает системный идентификатор, это может установить кодирование, используя encoding атрибут.
    Если указанный системный ID будет относительной ссылкой URI (см. раздел 5 в [IETF RFC 2396]), то реализация ДОМА попытается разрешить относительный URI с baseURI как основа, если это перестало работать, поведение является зависящим от реализации.
  - 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()
```
    Если установлено в истину, предположите, что ввод сертифицирован (см. раздел 2.13 в [XML 1.1]), анализируя [XML 1.1].
  - setCertifiedText
```
void setCertifiedText(boolean certifiedText)
```
    Если установлено в истину, предположите, что ввод сертифицирован (см. раздел 2.13 в [XML 1.1]), анализируя [XML 1.1].

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Интерфейсный LSInput

Сводка метода

Деталь метода

getCharacterStream

setCharacterStream

getByteStream

setByteStream

getStringData

setStringData

getSystemId

setSystemId

getPublicId

setPublicId

getBaseURI

setBaseURI

getEncoding

setEncoding

getCertifiedText

setCertifiedText