Интерфейс EntityResolver2

InputSource getExternalSubset(String name, String baseURI) throws SAXException, IOException

Позволяет приложениям предоставлять внешнее подмножество для документов, которые не определяют его явно. Документы с объявлениями DOCTYPE, которые пропускают внешнее подмножество, таким образом могут дополнить доступные объявления для проверки, обработки сущностей и обработки атрибутов (нормализация, установка по умолчанию и отчет о типах, включая ID). Это дополнение отображается через метод startDTD(), как если бы текст документа изначально содержал внешнее подмножество; этот обратный вызов выполняется перед тем, как будут сообщены какие-либо внутренние данные подмножества или ошибки.

Этот метод также может использоваться с документами, у которых нет объявления DOCTYPE. Когда встречается корневой элемент, но объявление DOCTYPE не было встречено, вызывается этот метод. Если он возвращает значение для внешнего подмножества, этот корневой элемент объявляется корневым элементом, что даёт эффект вставки объявления DOCTYPE в конец пролога документа, который в противном случае не был бы корректным. Последовательность вызовов парсера в этом случае логически похожа на эту:

 ... comments and PIs from the prolog (as usual)
 startDTD ("rootName", source.getPublicId (), source.getSystemId ());
 startEntity ("[dtd]");
 ... declarations, comments, and PIs from the external subset
 endEntity ("[dtd]");
 endDTD ();
 ... then the rest of the document (as usual)
 startElement (..., "rootName", ...);
 

Обратите внимание, что InputSource не получает дальнейшего разрешения. Реализации этого метода могут захотеть вызвать resolveEntity() для получения преимуществ, таких как использование локальных кешей сущностей DTD. Также, этот метод никогда не будет использован процессором (не выполняющим проверку), который не включает внешние параметрические сущности.

Использование этого метода включает в себя облегчение проверки данных при взаимодействии с процессорами XML, которые всегда требовали бы нежелательных сетевых обращений к внешним сущностям или которые по другим причинам принимают политику «нет DTD». Нецели, связанные с проверкой, включают принудительное включение DTD в документы, чтобы атрибуты обрабатывались последовательно. Например, процессору XPath нужно знать, какие атрибуты имеют тип «ID», прежде чем он сможет обработать широко используемый тип ссылки.

Предупреждение: Возврат внешнего подмножества изменяет входной документ. Предоставляя определения для общих сущностей, это может сделать некорректный документ похожим на корректный.

InputSource resolveEntity(String name, String publicId, String baseURI, String systemId) throws SAXException, IOException

Позволяет приложениям сопоставлять ссылки на внешние сущности с источниками входных данных или указать парсеру использовать стандартное разрешение URI. Этот метод вызывается только для внешних сущностей, которые были правильно объявлены. Этот метод предоставляет большую гибкость, чем интерфейс EntityResolver, поддерживая реализации более сложных схем каталогов, таких как определённая спецификацией OASIS XML Catalogs.

Парсеры, настроенные на использование этого метода резольвера, будут вызывать его, чтобы определить источник входных данных, который нужно использовать для любой внешней сущности, включённой из-за ссылки в тексте XML. Это исключает сущность документа и любую внешнюю сущность, возвращаемую getExternalSubset(). Когда (не выполняющий проверку) процессор настроен на то, чтобы не включать класс сущностей (параметр или общий) с помощью флагов функций, этот метод не вызывается для таких сущностей.

Обратите внимание, что схема именования сущностей, используемая здесь, такая же, что используется в LexicalHandler или в методе ContentHandler.skippedEntity().