compact2, compact3

org.xml.sax

Класс HandlerBase

java.lang. Объект

org.xml.sax. HandlerBase

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

DocumentHandler, DTDHandler, EntityResolver, ErrorHandler

Осуждаемый.

Этот class работает с осуждаемым DocumentHandler интерфейс. Это было заменено SAX2 DefaultHandler class.

public class HandlerBase
extends Object
implements EntityResolver, DTDHandler, DocumentHandler, ErrorHandler

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

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

Этот class реализует поведение значения по умолчанию для четырех интерфейсов SAX1: EntityResolver, DTDHandler, DocumentHandler, и ErrorHandler. Это является теперь устаревшим, но включается в SAX2, чтобы поддерживать наследство приложения SAX1. Приложения SAX2 должны использовать DefaultHandler class вместо этого.

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

Отметьте, что использование этого class является дополнительным.

С тех пор:

SAX 1.0

См. Также:

EntityResolver, DTDHandler, DocumentHandler, ErrorHandler

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

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

Конструктор и Описание
HandlerBase() Осуждаемый.

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

Модификатор и Тип	Метод и Описание
void	characters(char[] ch, int start, int length) Осуждаемый. Получите уведомление о символьных данных в элементе.
void	endDocument() Осуждаемый. Получите уведомление о конце документа.
void	endElement(String name) Осуждаемый. Получите уведомление о конце элемента.
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	startDocument() Осуждаемый. Получите уведомление о начале документа.
void	startElement(String name, AttributeList attributes) Осуждаемый. Получите уведомление о запуске элемента.
void	unparsedEntityDecl(String name, String publicId, String systemId, String notationName) Осуждаемый. Получите уведомление о непроанализированном объявлении объекта.
void	warning(SAXParseException e) Осуждаемый. Получите уведомление о предупреждении синтаксического анализатора.

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

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

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

HandlerBase

public HandlerBase()

Осуждаемый.

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

resolveEntity

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

Осуждаемый.

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

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

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

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

Параметры:

publicId - Общественность identifer, или нуль, если ни один не доступен.

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

Возвраты:

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

Броски:

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

См. Также:

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

notationDecl

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

Осуждаемый.

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

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

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

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

Параметры:

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

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

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

См. Также:

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

unparsedEntityDecl

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

Осуждаемый.

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

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

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

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

Параметры:

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

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

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

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

См. Также:

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

setDocumentLocator

public void setDocumentLocator(Locator locator)

Осуждаемый.

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

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

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

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

Параметры:

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

См. Также:

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

startDocument

public void startDocument()
                   throws SAXException

Осуждаемый.

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

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

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

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

Броски:

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

См. Также:

DocumentHandler.startDocument()

endDocument

public void endDocument()
                 throws SAXException

Осуждаемый.

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

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

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

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

Броски:

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

См. Также:

DocumentHandler.endDocument()

startElement

public void startElement(String name,
                         AttributeList attributes)
                  throws SAXException

Осуждаемый.

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

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

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

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

Параметры:

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

attributes - Указанное или принимало значение по умолчанию атрибуты.

Броски:

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

См. Также:

DocumentHandler.startElement(java.lang.String, org.xml.sax.AttributeList)

endElement

public void endElement(String name)
                throws SAXException

Осуждаемый.

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

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

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

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

Параметры:

name - имя элемента

Броски:

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

См. Также:

DocumentHandler.endElement(java.lang.String)

символы

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

Осуждаемый.

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

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

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

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

Параметры:

ch - Символы.

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

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

Броски:

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

См. Также:

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

ignorableWhitespace

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

Осуждаемый.

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

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

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

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

Параметры:

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

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

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

Броски:

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

См. Также:

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

processingInstruction

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

Осуждаемый.

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

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

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

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

Параметры:

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

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

Броски:

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

См. Также:

DocumentHandler.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