Класс HandlerBase

java.lang.Object

org.xml.sax.HandlerBase

Все реализуемые интерфейсы:: DocumentHandler, DTDHandler, EntityResolver, ErrorHandler

@Deprecated(since="1.5") public class HandlerBase extends Object implements EntityResolver, DTDHandler, DocumentHandler, ErrorHandler

Устарело.

Этот класс работает с устаревшим интерфейсом DocumentHandler. Его заменил класс SAX2 DefaultHandler.

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

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

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

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

Начиная с:

1.4, SAX 1.0

См. также:

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

Конструктор	Описание
`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)`	Устарело. Получает объект Locator для событий документа.
`void`	`startDocument()`	Устарело. Получает уведомление о начале документа.
`void`	`startElement(String name, AttributeList attributes)`	Устарело. Получает уведомление о начале элемента.
`void`	`unparsedEntityDecl(String name, String publicId, String systemId, String notationName)`	Устарело. Получает уведомление об объявлении неразобранной сущности.
`void`	`warning(SAXParseException e)`	Устарело. Получает предупреждение парсера.

Методы, объявленные в классе Object

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли какой-либо другой объект этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удалён в будущей версии. Финализация объявлена устаревшей и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо пока не истечёт заданный промежуток реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо пока не истечёт заданный промежуток реального времени.

Подробное описание конструкторов

HandlerBase

public HandlerBase()

Устарело.

Создаёт HandlerBase.

Подробное описание методов

resolveEntity

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

Устарело.

Разрешает внешнюю сущность.

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

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

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

Параметры:

publicId — Публичный идентификатор или null, если он недоступен.

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

Возвращает:

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

Вызывает исключение:

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

См. также:

notationDecl

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

Устарело.

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

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

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

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

Параметры:

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

publicId — Публичный идентификатор нотации или null, если он недоступен.

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

См. также:

unparsedEntityDecl

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

Устарело.

Получает уведомление об объявлении неразобранной сущности.

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

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

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

Параметры:

name — Имя сущности.

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

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

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

См. также:

setDocumentLocator

public void setDocumentLocator(Locator locator)

Устарело.

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

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

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

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

Параметры:

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

См. также:

startDocument

public void startDocument() throws SAXException

Устарело.

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

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

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

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

Вызывает исключение:

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

См. также:

endDocument

public void endDocument() throws SAXException

Устарело.

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

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

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

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

Вызывает исключение:

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

См. также:

startElement

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

Устарело.

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

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

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

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

Параметры:

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

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

Вызывает исключение:

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

См. также:

endElement

public void endElement(String name) throws SAXException

Устарело.

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

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

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

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

Параметры:

name — Имя элемента

Вызывает исключение:

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

См. также:

characters

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

Устарело.

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

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

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

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

Параметры:

ch — Символы.

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

length — Количество символов, используемых из массива.

Вызывает исключение:

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

См. также:

ignorableWhitespace

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

Устарело.

Получает уведомление о незначащих пробельных символах в содержимом элемента.

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

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

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

Параметры:

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

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

length — Количество символов, используемых из массива.

Вызывает исключение:

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

См. также:

processingInstruction

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

Устарело.

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

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

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

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

Параметры:

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

data — Данные инструкции обработки или null, если они не указаны.

Вызывает исключение:

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

См. также:

warning

public void warning(SAXParseException e) throws SAXException

Устарело.

Получает предупреждение парсера.

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

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

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

Параметры:

e — Сведения о предупреждении, закодированные в виде исключения.

Вызывает исключение:

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

См. также:

error

public void error(SAXParseException e) throws SAXException

Устарело.

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

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

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

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

Параметры:

e — Сведения о предупреждении, закодированные в виде исключения.

Вызывает исключение:

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

См. также:

fatalError

public void fatalError(SAXParseException e) throws SAXException

Устарело.

Сообщает о фатальной ошибке разбора XML.

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

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

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

Параметры:

e — Сведения об ошибке, закодированные в виде исключения.

Вызывает исключение:

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

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.