org.xml.sax.helpers

Класс DefaultHandler

java.lang. Объект

org.xml.sax.helpers. DefaultHandler

Все Реализованные Интерфейсы:

ContentHandler, DTDHandler, EntityResolver, ErrorHandler

Прямые Известные Подклассы:

DefaultHandler2

public class DefaultHandler
extends Object
implements EntityResolver, DTDHandler, ContentHandler, ErrorHandler

Базовый класс по умолчанию для обработчиков событий SAX2.

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

Этот класс доступен как базовый класс удобства для приложений SAX2: это обеспечивает реализации по умолчанию для всех обратных вызовов в четырех базовых классах обработчика SAX2:

• EntityResolver
• DTDHandler
• ContentHandler
• ErrorHandler

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

Этот класс заменяет осуждаемый SAX1 HandlerBase класс.

С тех пор:

SAX 2.0

См. Также:

EntityResolver, DTDHandler, ContentHandler, ErrorHandler

Сводка конструктора

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

Конструктор и Описание
DefaultHandler()

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	characters(char[] ch, int start, int length) Получите уведомление о символьных данных в элементе.
void	endDocument() Получите уведомление о конце документа.
void	endElement(String uri, String localName, String qName) Получите уведомление о конце элемента.
void	endPrefixMapping(String prefix) Получите уведомление о конце отображения Пространства имен.
void	error(SAXParseException e) Получите уведомление о восстанавливаемой ошибке синтаксического анализатора.
void	fatalError(SAXParseException e) Сообщите о фатальном XML, анализирующем ошибку.
void	ignorableWhitespace(char[] ch, int start, int length) Получите уведомление об игнорируемом пробеле в контенте элемента.
void	notationDecl(String name, String publicId, String systemId) Получите уведомление об объявлении нотации.
void	processingInstruction(String target, String data) Получите уведомление об инструкции обработки.
InputSource	resolveEntity(String publicId, String systemId) Разрешите внешний объект.
void	setDocumentLocator(Locator locator) Получите объект Локатора для событий документа.
void	skippedEntity(String name) Получите уведомление о пропущенном объекте.
void	startDocument() Получите уведомление о начале документа.
void	startElement(String uri, String localName, String qName, Attributes attributes) Получите уведомление о запуске элемента.
void	startPrefixMapping(String prefix, String uri) Получите уведомление о запуске отображения Пространства имен.
void	unparsedEntityDecl(String name, String publicId, String systemId, String notationName) Получите уведомление о непроанализированном объявлении объекта.
void	warning(SAXParseException e) Получите уведомление о предупреждении синтаксического анализатора.

Методы java.lang унаследованный от класса. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

DefaultHandler

public DefaultHandler()

Деталь метода

resolveEntity

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

Разрешите внешний объект.

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

Определенный:

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

Параметры:

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

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

Возвраты:

Новый входной источник, или нуль, чтобы потребовать поведения по умолчанию.

Броски:

IOException - Если есть ошибка, устанавливая новый входной источник.

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

См. Также:

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

notationDecl

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

Получите уведомление об объявлении нотации.

По умолчанию ничего не сделайте. Писатели приложения могут переопределить этот метод в подклассе, если они хотят отследить нотации, объявленные в документе.

Определенный:

notationDecl в интерфейсе DTDHandler

Параметры:

name - Имя нотации.

publicId - Идентификатор общественности нотации, или нуль, если не доступный.

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

Броски:

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

См. Также:

DTDHandler.notationDecl(java.lang.String, java.lang.String, java.lang.String)

unparsedEntityDecl

public void unparsedEntityDecl(String name,
                      String publicId,
                      String systemId,
                      String notationName)
                        throws SAXException

Получите уведомление о непроанализированном объявлении объекта.

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

Определенный:

unparsedEntityDecl в интерфейсе DTDHandler

Параметры:

name - Имя объекта.

publicId - Идентификатор общественности объекта, или нуль, если не доступный.

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

notationName - Имя связанной нотации.

Броски:

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

См. Также:

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

setDocumentLocator

public void setDocumentLocator(Locator locator)

Получите объект Локатора для событий документа.

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

Определенный:

setDocumentLocator в интерфейсе ContentHandler

Параметры:

locator - Локатор для всех событий документа SAX.

См. Также:

ContentHandler.setDocumentLocator(org.xml.sax.Locator), Locator

startDocument

public void startDocument()
                   throws SAXException

Получите уведомление о начале документа.

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

Определенный:

startDocument в интерфейсе ContentHandler

Броски:

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

См. Также:

ContentHandler.startDocument()

endDocument

public void endDocument()
                 throws SAXException

Получите уведомление о конце документа.

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

Определенный:

endDocument в интерфейсе ContentHandler

Броски:

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

См. Также:

ContentHandler.endDocument()

startPrefixMapping

public void startPrefixMapping(String prefix,
                      String uri)
                        throws SAXException

Получите уведомление о запуске отображения Пространства имен.

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

Определенный:

startPrefixMapping в интерфейсе ContentHandler

Параметры:

prefix - Объявляемый префикс Пространства имен.

uri - URI Пространства имен, отображенный на префикс.

Броски:

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

См. Также:

ContentHandler.startPrefixMapping(java.lang.String, java.lang.String)

endPrefixMapping

public void endPrefixMapping(String prefix)
                      throws SAXException

Получите уведомление о конце отображения Пространства имен.

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

Определенный:

endPrefixMapping в интерфейсе ContentHandler

Параметры:

prefix - Объявляемый префикс Пространства имен.

Броски:

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

См. Также:

ContentHandler.endPrefixMapping(java.lang.String)

startElement

public void startElement(String uri,
                String localName,
                String qName,
                Attributes attributes)
                  throws SAXException

Получите уведомление о запуске элемента.

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

Определенный:

startElement в интерфейсе ContentHandler

Параметры:

uri - URI Пространства имен, или пустая строка, если у элемента нет никакого URI Пространства имен или если обработка Пространства имен не выполняется.

localName - Локальное имя (без префикса), или пустая строка, если обработка Пространства имен не выполняется.

qName - Полностью определенное имя (с префиксом), или пустая строка, если полностью определенные имена не доступны.

attributes - Атрибуты, присоединенные к элементу. Если не будет никаких атрибутов, то это должен быть пустой объект Атрибутов.

Броски:

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

См. Также:

ContentHandler.startElement(java.lang.String, java.lang.String, java.lang.String, org.xml.sax.Attributes)

endElement

public void endElement(String uri,
              String localName,
              String qName)
                throws SAXException

Получите уведомление о конце элемента.

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

Определенный:

endElement в интерфейсе ContentHandler

Параметры:

uri - URI Пространства имен, или пустая строка, если у элемента нет никакого URI Пространства имен или если обработка Пространства имен не выполняется.

localName - Локальное имя (без префикса), или пустая строка, если обработка Пространства имен не выполняется.

qName - Полностью определенное имя (с префиксом), или пустая строка, если полностью определенные имена не доступны.

Броски:

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

См. Также:

ContentHandler.endElement(java.lang.String, java.lang.String, java.lang.String)

символы

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

Получите уведомление о символьных данных в элементе.

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

Определенный:

characters в интерфейсе ContentHandler

Параметры:

ch - Символы.

start - Позиция запуска в символьном массиве.

length - Число символов, чтобы использовать от символьного массива.

Броски:

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

См. Также:

ContentHandler.characters(char[], int, int)

ignorableWhitespace

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

Получите уведомление об игнорируемом пробеле в контенте элемента.

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

Определенный:

ignorableWhitespace в интерфейсе ContentHandler

Параметры:

ch - Пробельные символы.

start - Позиция запуска в символьном массиве.

length - Число символов, чтобы использовать от символьного массива.

Броски:

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

См. Также:

ContentHandler.ignorableWhitespace(char[], int, int)

processingInstruction

public void processingInstruction(String target,
                         String data)
                           throws SAXException

Получите уведомление об инструкции обработки.

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

Определенный:

processingInstruction в интерфейсе ContentHandler

Параметры:

target - Цель инструкции обработки.

data - Данные инструкции обработки, или нуль, если ни один не предоставляется.

Броски:

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

См. Также:

ContentHandler.processingInstruction(java.lang.String, java.lang.String)

skippedEntity

public void skippedEntity(String name)
                   throws SAXException

Получите уведомление о пропущенном объекте.

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

Определенный:

skippedEntity в интерфейсе ContentHandler

Параметры:

name - Имя пропущенного объекта.

Броски:

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

См. Также:

ContentHandler.processingInstruction(java.lang.String, java.lang.String)

предупреждение

public void warning(SAXParseException e)
             throws SAXException

Получите уведомление о предупреждении синтаксического анализатора.

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

Определенный:

warning в интерфейсе ErrorHandler

Параметры:

e - Информация о предупреждении, закодированная как исключение.

Броски:

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

См. Также:

ErrorHandler.warning(org.xml.sax.SAXParseException), SAXParseException

ошибка

public void error(SAXParseException e)
           throws SAXException

Получите уведомление о восстанавливаемой ошибке синтаксического анализатора.

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

Определенный:

error в интерфейсе ErrorHandler

Параметры:

e - Информация об ошибке, закодированная как исключение.

Броски:

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

См. Также:

ErrorHandler.warning(org.xml.sax.SAXParseException), SAXParseException

fatalError

public void fatalError(SAXParseException e)
                throws SAXException

Сообщите о фатальном XML, анализирующем ошибку.

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

Определенный:

fatalError в интерфейсе ErrorHandler

Параметры:

e - Информация об ошибке, закодированная как исключение.

Броски:

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

См. Также:

ErrorHandler.fatalError(org.xml.sax.SAXParseException), SAXParseException