Класс DefaultHandler2

public class DefaultHandler2
extends DefaultHandler
implements LexicalHandler, DeclHandler, EntityResolver2

Этот класс расширяет базовый класс обработчика SAX2 для поддержки расширений SAX2 LexicalHandler, DeclHandler и EntityResolver2. За исключением переопределения оригинального метода SAX1 resolveEntity(), добавленные методы обработчика просто возвращают значение. Подклассы могут переопределять каждый метод по отдельности.

Этот модуль, как исходный код, так и документация, находится в общественном достоянии и не несёт ГАРАНТИЙ.

Примечание: этот класс может ещё научиться тому, что вызов ContentHandler.setDocumentLocator() может принимать объект Locator2, а вызов ContentHandler.startElement() может принимать объект Attributes2.

Конструкторы

DefaultHandler2

public DefaultHandler2()

Создаёт обработчик, игнорирующий все события разбора.

Методы

startCDATA

public void startCDATA()
                throws SAXException

Описание скопировано из интерфейса: LexicalHandler

Определено в:

startCDATA в интерфейсе LexicalHandler

Исключение:

SAXException - Приложение может вызвать исключение.

См. также:

LexicalHandler.endCDATA()

endCDATA

public void endCDATA()
              throws SAXException

Описание скопировано из интерфейса: LexicalHandler

Сообщает о конце раздела CDATA.

Определено в:

endCDATA в интерфейсе LexicalHandler

Исключение:

SAXException - Приложение может вызвать исключение.

См. также:

LexicalHandler.startCDATA()

startDTD

public void startDTD(String name,
                     String publicId,
                     String systemId)
              throws SAXException

Описание скопировано из интерфейса: LexicalHandler

Определено в:

startDTD в интерфейсе LexicalHandler

Параметры:

name - Имя типа документа.

publicId - Объявленный общедоступный идентификатор для внешнего подмножества DTD, или null, если он не был объявлен.

systemId - Объявленный системный идентификатор для внешнего подмножества DTD, или null, если он не был объявлен. (Обратите внимание, что это не разрешается по отношению к URI базового документа.)

Исключение:

SAXException - Приложение может вызвать исключение.

См. также:

LexicalHandler.endDTD(), LexicalHandler.startEntity(java.lang.String)

endDTD

public void endDTD()
            throws SAXException

Описание скопировано из интерфейса: LexicalHandler

Определено в:

endDTD в интерфейсе LexicalHandler

Исключение:

SAXException - Приложение может вызвать исключение.

См. также:

LexicalHandler.startDTD(java.lang.String, java.lang.String, java.lang.String)

startEntity

public void startEntity(String name)
                 throws SAXException

Описание скопировано из интерфейса: LexicalHandler

Определено в:

startEntity в интерфейсе LexicalHandler

Параметры:

name - Имя сущности. Если это параметрическая сущность, имя будет начинаться с '%', а если это внешнее подмножество DTD, то это будет "[dtd]".

Исключение:

SAXException - Приложение может вызвать исключение.

См. также:

LexicalHandler.endEntity(java.lang.String), DeclHandler.internalEntityDecl(java.lang.String, java.lang.String), DeclHandler.externalEntityDecl(java.lang.String, java.lang.String, java.lang.String)

endEntity

public void endEntity(String name)
               throws SAXException

Описание скопировано из интерфейса: LexicalHandler

Сообщает об окончании сущности.

Определено в:

endEntity в интерфейсе LexicalHandler

Параметры:

name - Имя сущности, которая завершается.

Исключение:

SAXException - Приложение может вызвать исключение.

См. также:

LexicalHandler.startEntity(java.lang.String)

comment

public void comment(char[] ch,
                    int start,
                    int length)
             throws SAXException

Описание скопировано из интерфейса: LexicalHandler

Определено в:

comment в интерфейсе LexicalHandler

Параметры:

ch - Массив, содержащий символы в комментарии.

start - Начальная позиция в массиве.

length - Количество символов для использования из массива.

Исключение:

SAXException - Приложение может вызвать исключение.

attributeDecl

public void attributeDecl(String eName,
                          String aName,
                          String type,
                          String mode,
                          String value)
                   throws SAXException

Описание скопировано из интерфейса: DeclHandler

Определено в:

attributeDecl в интерфейсе DeclHandler

Параметры:

eName - Имя связанного элемента.

aName - Имя атрибута.

type - Строка, представляющая тип атрибута.

mode - Строка, представляющая режим настройки атрибута ("#IMPLIED", "#REQUIRED" или "#FIXED") или null, если ни один из них не применяется.

value - Строка, представляющая значение по умолчанию атрибута или null, если его нет.

Исключение:

SAXException - Приложение может вызвать исключение.

elementDecl

public void elementDecl(String name,
                        String model)
                 throws SAXException

Описание скопировано из интерфейса: DeclHandler

Определено в:

elementDecl в интерфейсе DeclHandler

Параметры:

name - Имя типа элемента.

model - Модель содержимого как нормализованная строка.

Исключение:

SAXException - Приложение может вызвать исключение.

externalEntityDecl

public void externalEntityDecl(String name,
                               String publicId,
                               String systemId)
                        throws SAXException

Описание скопировано из интерфейса: DeclHandler

Указано в:

externalEntityDecl в интерфейсе DeclHandler

Параметры:

name - Имя сущности. Если это параметр сущности, имя начинается с '%'.

publicId - Общедоступный идентификатор сущности или null, если он не был указан.

systemId - Системный идентификатор сущности.

Исключения:

SAXException - Приложение может вызвать исключение.

См. также:

DeclHandler.internalEntityDecl(java.lang.String, java.lang.String), DTDHandler.unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)

internalEntityDecl

public void internalEntityDecl(String name,
                               String value)
                        throws SAXException

Описание скопировано из интерфейса: DeclHandler

Указано в:

internalEntityDecl в интерфейсе DeclHandler

Параметры:

name - Имя сущности. Если это параметр сущности, имя начинается с '%'.

value - Текст замены сущности.

Исключения:

SAXException - Приложение может вызвать исключение.

См. также:

DeclHandler.externalEntityDecl(java.lang.String, java.lang.String, java.lang.String), DTDHandler.unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)

getExternalSubset

public InputSource getExternalSubset(String name,
                                     String baseURI)
                              throws SAXException,
                                     IOException

Сообщает парсеру, что если во входном документе не объявлено внешнее подмножество, оно не должно использоваться.

Указано в:

getExternalSubset в интерфейсе EntityResolver2

Параметры:

name - Идентифицирует корневой элемент документа. Это имя взято из объявления DOCTYPE (если оно доступно) или из фактического корневого элемента.

baseURI - Базовый URI документа, служащий дополнительным указанием для выбора внешнего подмножества. Это всегда абсолютный URI, если он не null, потому что XMLReader получил InputSource без него.

Возвращает:

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

Исключения:

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

IOException - Вероятно, указывает на ошибку создания нового InputStream или Reader или неверный URL.

resolveEntity

public InputSource resolveEntity(String name,
                                 String publicId,
                                 String baseURI,
                                 String systemId)
                          throws SAXException,
                                 IOException

Сообщает парсеру разрешить systemId относительно baseURI и прочитать текст сущности из полученного абсолютного URI. Обратите внимание, что из-за того, что более старая методика DefaultHandler.resolveEntity() переопределена для вызова данной, данный метод может иногда вызываться с null name и baseURI и с systemId, уже приведенным к абсолютному виду.

Указано в:

resolveEntity в интерфейсе EntityResolver2

Параметры:

name - Идентифицирует внешнюю сущность, которая разрешается. "[dtd]" для внешнего подмножества, или имя, начинающееся с '%', чтобы указать параметрическую сущность, или имя общей сущности. Никогда не равно null, когда вызывается SAX2-парсером.

publicId - Общедоступный идентификатор внешней сущности, на которую делается ссылка (нормализован как требуется спецификацией XML), или null, если он не был предоставлен.

baseURI - URI относительно которого интерпретируются относительные systemIDs. Это всегда абсолютный URI, если он не null (вероятно, потому что XMLReader получил InputSource без него). Этот URI определяется спецификацией XML как связанный с "<", начинающим соответствующее объявление.

systemId - Системный идентификатор внешней сущности, на которую делается ссылка; относительный или абсолютный URI. Никогда не равно null, когда вызывается SAX2-парсером; только объявленные сущности и любое внешнее подмножество разрешаются такими парсерами.

Возвращает:

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

Исключения:

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

IOException - Вероятно, указывает на ошибку создания нового InputStream или Reader или неверный URL.

resolveEntity

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

Вызывает EntityResolver2.resolveEntity() с null именем сущности и base URI. Вам нужно переопределить только этот метод, чтобы использовать этот класс.

Указано в:

resolveEntity в интерфейсе EntityResolver

Переопределяет:

resolveEntity в классе DefaultHandler

Параметры:

publicId - Общедоступный идентификатор или null, если он недоступен.

systemId - Системный идентификатор, предоставленный в документе XML.

Возвращает:

Новый источник ввода или null, чтобы потребовать стандартное поведение.

Исключения:

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

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

См. также:

EntityResolver.resolveEntity(java.lang.String, java.lang.String)