Интерфейс EntityResolver

public interface EntityResolver

Основной интерфейс для разрешения сущностей.

Этот модуль, как исходный код, так и документация, находится в общественном достоянии и не имеет ГАРАНТИИ. См. http://www.saxproject.org для получения дополнительной информации.

Если приложению SAX требуется реализовать пользовательскую обработку внешних сущностей, оно должно реализовать этот интерфейс и зарегистрировать экземпляр с драйвером SAX с помощью метода setEntityResolver.

Затем XML-читатель позволит приложению перехватить любые внешние сущности (включая внешний подмножество DTD и внешние параметрические сущности, если таковые имеются) перед их включением.

Многим приложениям SAX не нужно реализовывать этот интерфейс, но он будет особенно полезен для приложений, которые создают XML-документы из баз данных или других специализированных источников ввода, или для приложений, которые используют типы URI, отличные от URL.

Следующий разрешитель предоставит приложению специальный поток символов для сущности с идентификатором системы "http://www.myhost.com/today":

import org.xml.sax.EntityResolver;
 import org.xml.sax.InputSource;

 public class MyResolver implements EntityResolver {
   public InputSource resolveEntity (String publicId, String systemId)
   {
     if (systemId.equals("http://www.myhost.com/today")) {
              // return a special input source
       MyReader reader = new MyReader();
       return new InputSource(reader);
     } else {
              // use the default behaviour
       return null;
     }
   }
 }

Приложение также может использовать этот интерфейс для перенаправления идентификаторов систем на локальные URI или для поиска замещений в каталоге (возможно, с помощью публичного идентификатора).

Методы

resolveEntity

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

Параметры:

publicId - Публичный идентификатор внешней сущности, на которую делается ссылка, или null, если он не был предоставлен.

systemId - Идентификатор системы внешней сущности, на которую делается ссылка.

Возвращает:

Объект InputSource, описывающий новый источник ввода, или null, чтобы запросить, чтобы парсер открыл обычное подключение URI к идентификатору системы.

Исключения:

SAXException - Любое SAX-исключение, возможно, обертывающее другое исключение.

IOException - Java-специфическое исключение IO, возможно, результат создания нового InputStream или Reader для InputSource.

См. также:

InputSource