Интерфейс DOMImplementationLS

public interface DOMImplementationLS

DOMImplementationLS содержит методы-фабрики для создания объектов Load и Save.

Ожидается, что экземпляр интерфейса DOMImplementationLS можно получить, используя методы приведения типов, специфичные для связывания, на экземпляре интерфейса DOMImplementation или, если Document поддерживает функцию "Core" версии "3.0", определенную в [DOM Level 3 Core], используя метод DOMImplementation.getFeature с параметрами "LS" (или "LS-Async") и "3.0" (соответственно).

См. также Спецификацию Document Object Model (DOM) Level 3 Load и Save.

Поля

MODE_SYNCHRONOUS

static final short MODE_SYNCHRONOUS

Создать синхронный LSParser.

См. также:

Значения константных полей

MODE_ASYNCHRONOUS

static final short MODE_ASYNCHRONOUS

Создать асинхронный LSParser.

См. также:

Значения константных полей

Методы

createLSParser

LSParser createLSParser(short mode,
                        String schemaType)
                 throws DOMException

Создать новый LSParser. Созданный анализатор можно настроить с помощью объекта DOMConfiguration и использовать для разбора документов с помощью метода parse.

Параметры:

mode - Аргумент mode может быть MODE_SYNCHRONOUS или MODE_ASYNCHRONOUS. Если mode равно MODE_SYNCHRONOUS, созданный LSParser будет работать в синхронном режиме; если равно MODE_ASYNCHRONOUS, созданный LSParser будет работать в асинхронном режиме.

schemaType - Абсолютный URI, представляющий тип языка схемы, используемого при загрузке Document с помощью только что созданного LSParser. Обратите внимание, что лексическая проверка абсолютного URI не выполняется. Для создания LSParser для любых типов схем (т. е. LSParser будет свободен использовать любую найденную схему), используйте значение null.

Примечание: Для W3C XML Schema [XML Schema Part 1] приложения должны использовать значение "http://www.w3.org/2001/XMLSchema". Для XML DTD [XML 1.0] приложения должны использовать значение "http://www.w3.org/TR/REC-xml". Другие языки схем находятся вне области применения W3C, и поэтому рекомендуется указать абсолютный URI для использования этого метода.

Возвращает:

Созданный объект LSParser . Этот LSParser является синхронным или асинхронным в зависимости от значения аргумента mode.

Примечание: По умолчанию, созданный LSParser не содержит DOMErrorHandler, т. е. значение параметра конфигурации "error-handler" равно null. Однако реализации могут предоставлять обработчик ошибок по умолчанию при создании. В этом случае начальное значение параметра конфигурации "error-handler" на новом объекте LSParser содержит ссылку на обработчик ошибок по умолчанию.

Исключения:

DOMException - NOT_SUPPORTED_ERR: Возникает, если запрашиваемый режим или тип схемы не поддерживаются.

createLSSerializer

LSSerializer createLSSerializer()

Создать новый объект LSSerializer.

Возвращает:

Созданный объект LSSerializer.

Примечание: По умолчанию у созданного объекта LSSerializer нет DOMErrorHandler, т. е. значение параметра конфигурации "error-handler" равно null. Однако реализации могут предоставлять обработчик ошибок по умолчанию при создании. В этом случае начальное значение параметра конфигурации "error-handler" на новом объекте LSSerializer содержит ссылку на обработчик ошибок по умолчанию.

createLSInput

LSInput createLSInput()

Создать новый пустой объект источника ввода, где LSInput.characterStream, LSInput.byteStream , LSInput.stringData LSInput.systemId, LSInput.publicId, LSInput.baseURI, и LSInput.encoding равны null, а LSInput.certifiedText равно false.

Возвращает:

Созданный объект ввода.

createLSOutput

LSOutput createLSOutput()

Создать новый пустой объект пункта назначения вывода, где LSOutput.characterStream, LSOutput.byteStream, LSOutput.systemId, LSOutput.encoding равны null.

Возвращает:

Созданный объект вывода.