Spec-Zone.ru › OpenJDK 24

Класс 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
См. также:
  • 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)
Устарело.
Получает объект 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.Object

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

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

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, возможно, обернутое другим исключением.
См. также:
  • EntityResolver.resolveEntity(java.lang.String, java.lang.String)

notationDecl

public void notationDecl(String name, String publicId, String systemId)
Устарело.
Получает уведомление о декларации нотации.

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

Определено в:
notationDecl в интерфейсе DTDHandler
Параметры:
name - Имя нотации.
publicId - Общедоступный идентификатор нотации или null, если он не доступен.
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 - Общедоступный идентификатор сущности или null, если он не доступен.
systemId - Системный идентификатор сущности.
notationName - Имя связанной нотации.
См. также:
  • DTDHandler.unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)

setDocumentLocator

public void setDocumentLocator(Locator 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)

characters

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)

обработкаИнструкции

public void processingInstruction(String target, String data) throws SAXException
Устарело.
Получить уведомление об обработке инструкции.

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

Указано в:
processingInstruction в интерфейсе DocumentHandler
Параметры:
target - Цель инструкции обработки.
data - Данные инструкции обработки, или null, если они не предоставлены.
Исключения:
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

критическаяОшибка

public void fatalError(SAXParseException e) throws SAXException
Устарело.
Сообщить о фатальной ошибке парсинга XML.

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

Указано в:
fatalError в интерфейсе ErrorHandler
Параметры:
e - Информация об ошибке, закодированная как исключение.
Исключения:
SAXException - Любое исключение SAX, возможно, обертывающее другое исключение.
См. также:
  • ErrorHandler.fatalError(org.xml.sax.SAXParseException)
  • SAXParseException

© 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.xml/org/xml/sax/HandlerBase.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API