Интерфейс 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().