Интерфейс LSResourceResolver

Все известные подинтерфейсы:: CatalogResolver

public interface LSResourceResolver

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

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

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

Многим приложениям DOM не нужно реализовывать этот интерфейс, но он будет особенно полезен для приложений, которые строят XML-документы из баз данных или других специализированных источников ввода, или для приложений, использующих URN.

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

См. также Спецификацию загрузки и сохранения документа DOM уровня 3.

С:: 1.5

Методы

Модификатор и тип	Метод	Описание
`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 Schema [XML Schema Part 1] приложения должны использовать значение "http://www.w3.org/2001/XMLSchema". Другие типы ресурсов не входят в область действия этой спецификации и, следовательно, должны рекомендовать абсолютный URI для использования этого метода.; namespaceURI - Пространство имен разрешаемого ресурса, например, целевое пространство имен XML Schema [XML Schema Part 1] при разрешении XML Schema ресурсов.; publicId - Общедоступный идентификатор внешней сущности, на которую имеется ссылка, или null если общедоступный идентификатор не был указан или если ресурс не является сущностью.; systemId - Идентификатор системы, URI ссылка [IETF RFC 2396] на внешний ресурс, на который имеется ссылка, или null если идентификатор системы не был указан.; baseURI - Абсолютный базовый URI ресурса, который анализируется, или null если нет базового URI.
Возвращает:: Объект LSInput , описывающий новый источник ввода, или null для запроса, чтобы анализатор открыл обычное подключение URI к ресурсу.