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