org.w3c.dom.ls

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

public interface LSResourceResolver

LSResourceResolver обеспечивает путь к приложениям, чтобы перенаправить ссылки на внешние ресурсы.

Приложения, бывшие должные реализовывать пользовательскую обработку для внешних ресурсов, могут реализовать этот интерфейс и зарегистрировать их реализацию, устанавливая параметр "преобразователя ресурса" DOMConfiguration объекты, присоединенные к LSParser и LSSerializer. Это может также быть регистр на DOMConfiguration объекты, присоединенные к Document если функция "LS" поддерживается.

LSParser тогда позволит приложению прерывать любые внешние объекты, включая внешнее подмножество DTD и внешние объекты параметра, прежде включая их. Высокоуровневый объект документа никогда не передают к resolveResource метод.

Много приложений ДОМА не должны будут реализовать этот интерфейс, но для приложений что XML-документы сборки от баз данных или других специализированных входных источников, или для приложений то использование УРНЫ будет особенно полезно.

Отметьте: LSResourceResolver основано на SAX2 [SAX] EntityResolver интерфейс.

См. также Объектную модель документа (ДОМ) Загрузка Уровня 3 и Сохраните Спецификацию.

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

Методы

Модификатор и Тип	Метод и Описание
LSInput	resolveResource(String type, String namespaceURI, String publicId, String systemId, String baseURI) Позвольте приложению разрешать внешние ресурсы.

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

resolveResource

LSInput resolveResource(String type,
                      String namespaceURI,
                      String publicId,
                      String systemId,
                      String baseURI)

Позвольте приложению разрешать внешние ресурсы.
LSParser вызовет этот метод прежде, чем открыть любой внешний ресурс, включая внешнее подмножество DTD, внешние объекты, на которые ссылаются в пределах DTD, и внешние объекты, на которые ссылаются в пределах элемента документа (однако, высокоуровневый объект документа не передают к этому методу). Приложение может тогда запросить что LSParser разрешите внешний ресурс непосредственно, что он использует альтернативный URI, или что он использует полностью различный входной источник.
Писатели приложения могут использовать этот метод, чтобы перенаправить внешние системные идентификаторы, чтобы защитить и/или локальный URI, искать общедоступные идентификаторы в каталоге, или считать объект из базы данных или другого входного источника (включая, например, диалоговое окно).

Параметры:

type - Тип разрешаемого ресурса. Для XML [XML 1.0] ресурсы (то есть объекты), приложения должны использовать значение "http://www.w3.org/TR/REC-xml". Для XML-схемы [Часть 1 XML-схемы], приложения должны использовать значение "http://www.w3.org/2001/XMLSchema". Другие типы ресурсов выходят за рамки этой спецификации и поэтому должны рекомендовать абсолютный URI, чтобы использовать этот метод.

namespaceURI - Пространство имен разрешаемого ресурса, например, целевое пространство имен XML-схемы [Часть 1 XML-схемы], разрешая ресурсы XML-схемы.

publicId - Общедоступный идентификатор внешнего объекта, ссылаемого, или null если никакой общедоступный идентификатор не был предоставлен или если ресурс не является объектом.

systemId - Системный идентификатор, ссылка URI [IETF RFC 2396], внешнего ресурса, ссылаемого, или null если никакой системный идентификатор не был предоставлен.

baseURI - Абсолютный основной URI ресурса, проанализированного, или null если нет никакого основного URI.

Возвраты:

A LSInput объект, описывающий новый входной источник, или null запрашивать, чтобы синтаксический анализатор открыл регулярное соединение URI с ресурсом.