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

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

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