Класс XMLReaderAdapter

java.lang.Object

org.xml.sax.helpers.XMLReaderAdapter

Все реализуемые интерфейсы:: ContentHandler, Parser

public class XMLReaderAdapter extends Object implements Parser, ContentHandler

Адаптирует SAX2 XMLReader как парсер SAX1.

Этот класс оборачивает SAX2 XMLReader и заставляет его работать как SAX1 Parser. XMLReader должен поддерживать значение true для свойства http://xml.org/sax/features/namespace-prefixes, иначе разбор завершится ошибкой с исключением SAXException; если XMLReader поддерживает значение false для свойства http://xml.org/sax/features/namespaces, оно также будет использоваться для повышения эффективности.

Начиная с:

1.4, SAX 2.0

См. также:

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

Конструктор	Описание
`XMLReaderAdapter()`	Создает новый адаптер.
`XMLReaderAdapter(XMLReader xmlReader)`	Создает новый адаптер.

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

Модификатор и тип	Метод	Описание
`void`	`characters(char[] ch, int start, int length)`	Адаптирует событие символов SAX2.
`void`	`endDocument()`	Событие завершения документа.
`void`	`endElement(String uri, String localName, String qName)`	Адаптирует событие закрытия элемента SAX2.
`void`	`endPrefixMapping(String prefix)`	Адаптирует событие завершения сопоставления префикса SAX2.
`void`	`ignorableWhitespace(char[] ch, int start, int length)`	Адаптирует событие незначащих пробельных символов SAX2.
`void`	`parse(String systemId)`	Разбирает документ.
`void`	`parse(InputSource input)`	Разбирает документ.
`void`	`processingInstruction(String target, String data)`	Адаптирует событие инструкции по обработке SAX2.
`void`	`setDocumentHandler(DocumentHandler handler)`	Регистрирует обработчик событий документа SAX1.
`void`	`setDocumentLocator(Locator locator)`	Задает локатор документа.
`void`	`setDTDHandler(DTDHandler handler)`	Регистрирует обработчик событий DTD.
`void`	`setEntityResolver(EntityResolver resolver)`	Регистрирует разрешатель сущностей.
`void`	`setErrorHandler(ErrorHandler handler)`	Регистрирует обработчик событий ошибок.
`void`	`setLocale(Locale locale)`	Задает локаль для сообщений об ошибках.
`void`	`skippedEntity(String name)`	Адаптирует событие пропущенной сущности SAX2.
`void`	`startDocument()`	Событие начала документа.
`void`	`startElement(String uri, String localName, String qName, Attributes atts)`	Адаптирует событие открытия элемента SAX2.
`void`	`startPrefixMapping(String prefix, String uri)`	Адаптирует событие начала сопоставления префикса SAX2.

Методы, объявленные в классе 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, либо до истечения заданного промежутка реального времени.

Методы, объявленные в интерфейсе ContentHandler

declaration

Модификатор и тип	Метод	Описание
`default void`	`declaration(String version, String encoding, String standalone)`	Получает уведомление об объявлении XML.

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

XMLReaderAdapter

public XMLReaderAdapter() throws SAXException

Создает новый адаптер.

Используйте свойство "org.xml.sax.driver", чтобы найти встраиваемый драйвер SAX2.

Выбрасывает:: SAXException — если встроенный драйвер не удается создать или если свойство org.xml.sax.driver не задано.

XMLReaderAdapter

public XMLReaderAdapter(XMLReader xmlReader)

Создает новый адаптер.

Создает новый адаптер, оборачивающий SAX2 XMLReader. Адаптер заставляет XMLReader работать как парсер SAX1.

Параметры:: xmlReader — SAX2 XMLReader, который нужно обернуть.
Выбрасывает:: NullPointerException — если аргумент равен null.

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

setLocale

public void setLocale(Locale locale) throws SAXException

Задает локаль для сообщений об ошибках.

В SAX2 это не поддерживается, поэтому всегда будет выброшено исключение.

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

setLocale в интерфейсе Parser

Параметры:

locale — локаль для сообщений об ошибках.

Выбрасывает:

SAXException — выбрасывается, если метод не переопределен.

См. также:

setEntityResolver

public void setEntityResolver(EntityResolver resolver)

Регистрирует разрешатель сущностей.

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

setEntityResolver в интерфейсе Parser

Параметры:

resolver — новый разрешатель.

См. также:

setDTDHandler

public void setDTDHandler(DTDHandler handler)

Регистрирует обработчик событий DTD.

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

setDTDHandler в интерфейсе Parser

Параметры:

handler — новый обработчик событий DTD.

См. также:

setDocumentHandler

public void setDocumentHandler(DocumentHandler handler)

Регистрирует обработчик событий документа SAX1.

Обратите внимание, что обработчик документа SAX1 не поддерживает пространства имен.

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

setDocumentHandler в интерфейсе Parser

Параметры:

handler — новый обработчик событий документа SAX1.

См. также:

setErrorHandler

public void setErrorHandler(ErrorHandler handler)

Регистрирует обработчик событий ошибок.

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

setErrorHandler в интерфейсе Parser

Параметры:

handler — новый обработчик событий ошибок.

См. также:

parse

public void parse(String systemId) throws IOException, SAXException

Разбирает документ.

Этот метод выбрасывает исключение, если встроенный XMLReader не поддерживает свойство http://xml.org/sax/features/namespace-prefixes.

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

parse в интерфейсе Parser

Параметры:

systemId — абсолютный URL документа.

Выбрасывает:

IOException — если при чтении исходного содержимого документа возникает проблема.

SAXException — если при обработке документа возникает проблема.

См. также:

parse

public void parse(InputSource input) throws IOException, SAXException

Разбирает документ.

Этот метод выбрасывает исключение, если встроенный XMLReader не поддерживает свойство http://xml.org/sax/features/namespace-prefixes.

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

parse в интерфейсе Parser

Параметры:

input — источник входных данных для документа.

Выбрасывает:

IOException — если при чтении исходного содержимого документа возникает проблема.

SAXException — если при обработке документа возникает проблема.

См. также:

setDocumentLocator

public void setDocumentLocator(Locator locator)

Задает локатор документа.

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

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

Параметры:

locator — локатор документа.

См. также:

startDocument

public void startDocument() throws SAXException

Событие начала документа.

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

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

Выбрасывает:

SAXException — клиент может вызвать исключение обработки.

См. также:

endDocument

public void endDocument() throws SAXException

Событие завершения документа.

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

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

Выбрасывает:

SAXException — клиент может вызвать исключение обработки.

См. также:

startPrefixMapping

public void startPrefixMapping(String prefix, String uri)

Адаптирует событие начала сопоставления префикса SAX2.

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

startPrefixMapping в интерфейсе ContentHandler

Параметры:

prefix — сопоставляемый префикс.

uri — URI пространства имен, с которым выполняется сопоставление.

См. также:

endPrefixMapping

public void endPrefixMapping(String prefix)

Адаптирует событие завершения сопоставления префикса SAX2.

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

endPrefixMapping в интерфейсе ContentHandler

Параметры:

prefix — сопоставляемый префикс.

См. также:

startElement

public void startElement(String uri, String localName, String qName, Attributes atts) throws SAXException

Адаптирует событие открытия элемента SAX2.

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

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

Параметры:

uri — URI пространства имен.

localName — локальное имя в пространстве имен.

qName — полное имя (с префиксом).

atts — атрибуты SAX2.

Выбрасывает:

SAXException — клиент может вызвать исключение обработки.

См. также:

endElement

public void endElement(String uri, String localName, String qName) throws SAXException

Адаптирует событие закрытия элемента SAX2.

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

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

Параметры:

uri — URI пространства имен.

localName — локальное имя в пространстве имен.

qName — полное имя (с префиксом).

Выбрасывает:

SAXException — клиент может вызвать исключение обработки.

См. также:

characters

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

Адаптирует событие символов SAX2.

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

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

Параметры:

ch — массив символов.

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

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

Выбрасывает:

SAXException — клиент может вызвать исключение обработки.

См. также:

ignorableWhitespace

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

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

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

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

Параметры:

ch — массив символов.

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

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

Выбрасывает:

SAXException — клиент может вызвать исключение обработки.

См. также:

processingInstruction

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

Адаптирует событие инструкции по обработке SAX2.

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

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

Параметры:

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

data — оставшаяся часть инструкции по обработке

Выбрасывает:

SAXException — клиент может вызвать исключение обработки.

См. также:

skippedEntity

public void skippedEntity(String name) throws SAXException

Адаптирует событие пропущенной сущности SAX2.

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

skippedEntity в интерфейсе ContentHandler

Параметры:

name — имя пропущенной сущности.

Выбрасывает:

SAXException — выбрасывается подклассами.

См. также:

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