HandlerBase (Платформа Java SE 7)

java.lang. Объект
- org.xml.sax. HandlerBase

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

DocumentHandler, DTDHandler, EntityResolver, ErrorHandler

Осуждаемый.
Этот класс работает с осуждаемым DocumentHandler интерфейс. Это было заменено SAX2 DefaultHandler класс.
```
public class HandlerBase
extends Object
implements EntityResolver, DTDHandler, DocumentHandler, ErrorHandler
```
Базовый класс по умолчанию для обработчиков.
Этот модуль, и исходный код и документация, находится в Общедоступном Домене, и прибывает без ГАРАНТИИ. См. http://www.saxproject.org для дополнительной информации.

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

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

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

С тех пор:

SAX 1.0

См. Также:
EntityResolver, DTDHandler, DocumentHandler, ErrorHandler

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

Конструкторы
Конструктор и Описание

HandlerBase()
Осуждаемый.

Конструкторы
Конструктор и Описание
`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)` Осуждаемый. Получите уведомление о предупреждении синтаксического анализатора.

Методы 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

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс HandlerBase

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

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

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

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

HandlerBase

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

resolveEntity

notationDecl

unparsedEntityDecl

setDocumentLocator

startDocument

endDocument

startElement

endElement

символы

ignorableWhitespace

processingInstruction

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

ошибка

fatalError