Интерфейс 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-соединения с ресурсом.

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://download.java.net/java/early_access/jdk24/docs/api/java.xml/org/w3c/dom/ls/LSResourceResolver.html