Интерфейс 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, поддерживая реализации более сложных схем каталогов, например схемы, определенной спецификацией каталогов XML OASIS.

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

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