Базовый класс по умолчанию для обработчиков событий SAX2.
Этот модуль, и исходный код и документация, находится в Общедоступном Домене, и прибывает без ГАРАНТИИ. См. http://www.saxproject.org для дополнительной информации.
Этот класс доступен как базовый класс удобства для приложений SAX2: это обеспечивает реализации по умолчанию для всех обратных вызовов в четырех базовых классах обработчика SAX2:
Писатели приложения могут расширить этот класс, когда они должны реализовать только часть интерфейса; писатели синтаксического анализатора могут инстанцировать этого класса, чтобы обеспечить обработчики по умолчанию, когда приложение не предоставило свое собственное.
Этот класс заменяет осуждаемый SAX1 HandlerBase класс.
Всегда возвращайте нуль, так, чтобы синтаксический анализатор использовал системный идентификатор, обеспеченный в XML-документе. Этот метод реализует поведение значения по умолчанию SAX: писатели приложения могут переопределить это в подклассе, чтобы сделать специальные преобразования, такие как поиски каталога или перенаправление URI.
По умолчанию ничего не сделайте. Писатели приложения могут переопределить этот метод в подклассе, если они хотят отследить нотации, объявленные в документе.
Получите уведомление о непроанализированном объявлении объекта.
По умолчанию ничего не сделайте. Писатели приложения могут переопределить этот метод в подклассе, чтобы отследить непроанализированные объекты, объявленные в документе.
По умолчанию ничего не сделайте. Писатели приложения могут переопределить этот метод в подклассе, если они хотят сохранить локатор для использования с другими событиями документа.
По умолчанию ничего не сделайте. Писатели приложения могут переопределить этот метод в подклассе, чтобы предпринять определенные меры в начале документа (такие как выделение корневого узла дерева или создания выходного файла).
По умолчанию ничего не сделайте. Писатели приложения могут переопределить этот метод в подклассе, чтобы предпринять определенные меры в конце документа (такие как завершение дерева или закрытие выходного файла).
Получите уведомление о запуске отображения Пространства имен.
По умолчанию ничего не сделайте. Писатели приложения могут переопределить этот метод в подклассе, чтобы предпринять определенные меры в начале каждого контекста префикса Пространства имен (такие как хранение отображения префикса).
Получите уведомление о конце отображения Пространства имен.
По умолчанию ничего не сделайте. Писатели приложения могут переопределить этот метод в подклассе, чтобы предпринять определенные меры в конце каждого префиксного отображения.
По умолчанию ничего не сделайте. Писатели приложения могут переопределить этот метод в подклассе, чтобы предпринять определенные меры в начале каждого элемента (такие как выделение нового древовидного узла или запись вывода к файлу).
uri - URI Пространства имен, или пустая строка, если у элемента нет никакого URI Пространства имен или если обработка Пространства имен не выполняется.
localName - Локальное имя (без префикса), или пустая строка, если обработка Пространства имен не выполняется.
qName - Полностью определенное имя (с префиксом), или пустая строка, если полностью определенные имена не доступны.
attributes - Атрибуты, присоединенные к элементу. Если не будет никаких атрибутов, то это должен быть пустой объект Атрибутов.
Броски:
SAXException - Любое исключение SAX, возможно обертывая другое исключение.
По умолчанию ничего не сделайте. Писатели приложения могут переопределить этот метод в подклассе, чтобы предпринять определенные меры в конце каждого элемента (такие как завершение древовидного узла или запись вывода к файлу).
uri - URI Пространства имен, или пустая строка, если у элемента нет никакого URI Пространства имен или если обработка Пространства имен не выполняется.
localName - Локальное имя (без префикса), или пустая строка, если обработка Пространства имен не выполняется.
qName - Полностью определенное имя (с префиксом), или пустая строка, если полностью определенные имена не доступны.
Броски:
SAXException - Любое исключение SAX, возможно обертывая другое исключение.
public void characters(char[] ch,
int start,
int length)
throws SAXException
Получите уведомление о символьных данных в элементе.
По умолчанию ничего не сделайте. Писатели приложения могут переопределить этот метод, чтобы предпринять определенные меры для каждого блока символьных данных (такие как добавление данных к узлу или буферу, или печати этого к файлу).
public void ignorableWhitespace(char[] ch,
int start,
int length)
throws SAXException
Получите уведомление об игнорируемом пробеле в контенте элемента.
По умолчанию ничего не сделайте. Писатели приложения могут переопределить этот метод, чтобы предпринять определенные меры для каждого блока игнорируемого пробела (такие как добавляющие данные к узлу или буферу, или печати этого к файлу).
По умолчанию ничего не сделайте. Писатели приложения могут переопределить этот метод в подклассе, чтобы предпринять определенные меры для каждой инструкции обработки, такие как установка переменных состояния или вызов других методов.
По умолчанию ничего не сделайте. Писатели приложения могут переопределить этот метод в подклассе, чтобы предпринять определенные меры для каждой инструкции обработки, такие как установка переменных состояния или вызов других методов.
Получите уведомление о предупреждении синтаксического анализатора.
Реализация по умолчанию ничего не делает. Писатели приложения могут переопределить этот метод в подклассе, чтобы предпринять определенные меры для каждого предупреждения, такие как вставка сообщения в файле журнала или печати этого к консоли.
Получите уведомление о восстанавливаемой ошибке синтаксического анализатора.
Реализация по умолчанию ничего не делает. Писатели приложения могут переопределить этот метод в подклассе, чтобы предпринять определенные меры для каждой ошибки, такие как вставка сообщения в файле журнала или печати этого к консоли.
Реализация по умолчанию бросает SAXParseException. Писатели приложения могут переопределить этот метод в подклассе, если они должны предпринять определенные меры для каждой фатальной ошибки (такие как сбор всех ошибок в единственный отчет): в любом случае приложение должно остановить всю регулярную обработку, когда этот метод вызывается, так как документ больше не надежен, и синтаксический анализатор больше, возможно, не сообщает о событиях парсинга.