Класс ParserAdapter

java.lang.Object

org.xml.sax.helpers.ParserAdapter

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

public class ParserAdapter extends Object implements XMLReader, DocumentHandler

Адаптирует анализатор SAX1 как XMLReader SAX2.

Этот класс оборачивает Parser SAX1 и заставляет его работать как XMLReader SAX2, поддерживая функции, свойства и пространства имен. Обратите внимание, что сообщать о событиях skippedEntity невозможно, поскольку SAX1 не предоставляет эту информацию.

Этот адаптер не проверяет наличие дублирующихся имен атрибутов, квалифицированных пространствами имен.

С версии:

1.4, SAX 2.0

См. также:

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

Конструктор	Описание
`ParserAdapter()`	Создает новый адаптер анализатора.
`ParserAdapter(Parser parser)`	Создает новый адаптер анализатора.

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

Модификатор и тип	Метод	Описание
`void`	`characters(char[] ch, int start, int length)`	Метод реализации адаптера; не вызывайте его.
`void`	`endDocument()`	Метод реализации адаптера; не вызывайте его.
`void`	`endElement(String qName)`	Метод реализации адаптера; не вызывайте его.
`ContentHandler`	`getContentHandler()`	Возвращает текущий обработчик содержимого.
`DTDHandler`	`getDTDHandler()`	Возвращает текущий обработчик DTD.
`EntityResolver`	`getEntityResolver()`	Возвращает текущий обработчик сущностей.
`ErrorHandler`	`getErrorHandler()`	Возвращает текущий обработчик ошибок.
`boolean`	`getFeature(String name)`	Проверяет флаг функции анализатора.
`Object`	`getProperty(String name)`	Получает свойство анализатора.
`void`	`ignorableWhitespace(char[] ch, int start, int length)`	Метод реализации адаптера; не вызывайте его.
`void`	`parse(String systemId)`	Разбирает XML-документ.
`void`	`parse(InputSource input)`	Разбирает XML-документ.
`void`	`processingInstruction(String target, String data)`	Метод реализации адаптера; не вызывайте его.
`void`	`setContentHandler(ContentHandler handler)`	Устанавливает обработчик содержимого.
`void`	`setDocumentLocator(Locator locator)`	Метод реализации адаптера; не вызывайте его.
`void`	`setDTDHandler(DTDHandler handler)`	Устанавливает обработчик DTD.
`void`	`setEntityResolver(EntityResolver resolver)`	Устанавливает обработчик сущностей.
`void`	`setErrorHandler(ErrorHandler handler)`	Устанавливает обработчик ошибок.
`void`	`setFeature(String name, boolean value)`	Устанавливает флаг функции анализатора.
`void`	`setProperty(String name, Object value)`	Устанавливает свойство анализатора.
`void`	`startDocument()`	Метод реализации адаптера; не вызывайте его.
`void`	`startElement(String qName, AttributeList qAtts)`	Метод реализации адаптера; не вызывайте его.

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

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

ParserAdapter

public ParserAdapter() throws SAXException

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

Для поиска встроенного драйвера SAX1 используется свойство "org.xml.sax.parser".

Вызывает исключение:: SAXException — если не удается создать экземпляр встроенного драйвера или свойство org.xml.sax.parser не задано.

ParserAdapter

public ParserAdapter(Parser parser)

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

Обратите внимание, что после создания адаптера встроенный анализатор нельзя заменить; чтобы встроить другой анализатор, создайте новый ParserAdapter.

Параметры:: parser — анализатор SAX1 для встраивания.
Вызывает исключение:: NullPointerException — если параметр parser равен null.

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

setFeature

public void setFeature(String name, boolean value) throws SAXNotRecognizedException, SAXNotSupportedException

Устанавливает флаг функции анализатора.

Распознаются только функции namespaces и namespace-prefixes.

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

setFeature в интерфейсе XMLReader

Параметры:

name — имя функции в виде полного URI.

value — запрошенное значение функции.

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

SAXNotRecognizedException — если значение функции нельзя установить или получить.

SAXNotSupportedException — если функции нельзя присвоить это значение.

См. также:

getFeature

public boolean getFeature(String name) throws SAXNotRecognizedException, SAXNotSupportedException

Проверяет флаг функции анализатора.

Распознаются только функции namespaces и namespace-prefixes.

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

getFeature в интерфейсе XMLReader

Параметры:

name — имя функции в виде полного URI.

Возвращает:

Текущее значение функции.

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

SAXNotRecognizedException — если значение функции нельзя установить или получить.

SAXNotSupportedException — если функция в данный момент недоступна для чтения.

См. также:

setProperty

public void setProperty(String name, Object value) throws SAXNotRecognizedException, SAXNotSupportedException

Устанавливает свойство анализатора.

В настоящее время свойства не распознаются.

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

setProperty в интерфейсе XMLReader

Параметры:

name — имя свойства.

value — значение свойства.

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

SAXNotRecognizedException — если значение свойства нельзя установить или получить.

SAXNotSupportedException — если свойству нельзя присвоить это значение.

См. также:

getProperty

public Object getProperty(String name) throws SAXNotRecognizedException, SAXNotSupportedException

Получает свойство анализатора.

В настоящее время свойства не распознаются.

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

getProperty в интерфейсе XMLReader

Параметры:

name — имя свойства.

Возвращает:

Значение свойства.

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

SAXNotRecognizedException — если значение свойства нельзя установить или получить.

SAXNotSupportedException — если значение свойства в данный момент недоступно для чтения.

См. также:

setEntityResolver

public void setEntityResolver(EntityResolver resolver)

Устанавливает обработчик сущностей.

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

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

Параметры:

resolver — новый обработчик сущностей.

См. также:

getEntityResolver

public EntityResolver getEntityResolver()

Возвращает текущий обработчик сущностей.

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

getEntityResolver в интерфейсе XMLReader

Возвращает:

Текущий обработчик сущностей или null, если он не задан.

См. также:

setDTDHandler

public void setDTDHandler(DTDHandler handler)

Устанавливает обработчик DTD.

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

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

Параметры:

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

См. также:

getDTDHandler

public DTDHandler getDTDHandler()

Возвращает текущий обработчик DTD.

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

getDTDHandler в интерфейсе XMLReader

Возвращает:

текущий обработчик DTD или null, если он не задан

См. также:

setContentHandler

public void setContentHandler(ContentHandler handler)

Устанавливает обработчик содержимого.

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

setContentHandler в интерфейсе XMLReader

Параметры:

handler — новый обработчик содержимого

См. также:

getContentHandler

public ContentHandler getContentHandler()

Возвращает текущий обработчик содержимого.

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

getContentHandler в интерфейсе XMLReader

Возвращает:

Текущий обработчик содержимого или null, если он не задан.

См. также:

setErrorHandler

public void setErrorHandler(ErrorHandler handler)

Устанавливает обработчик ошибок.

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

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

Параметры:

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

См. также:

getErrorHandler

public ErrorHandler getErrorHandler()

Возвращает текущий обработчик ошибок.

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

getErrorHandler в интерфейсе XMLReader

Возвращает:

Текущий обработчик ошибок или null, если он не задан.

См. также:

parse

public void parse(String systemId) throws IOException, SAXException

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

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

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

Параметры:

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

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

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

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

См. также:

parse

public void parse(InputSource input) throws IOException, SAXException

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

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

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

Параметры:

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

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

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

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

См. также:

setDocumentLocator

public void setDocumentLocator(Locator locator)

Метод реализации адаптера; не вызывайте его. Адаптирует событие локатора документа SAX1.

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

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

Параметры:

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

См. также:

startDocument

public void startDocument() throws SAXException

Метод реализации адаптера; не вызывайте его. Адаптирует событие начала документа SAX1.

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

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

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

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

См. также:

endDocument

public void endDocument() throws SAXException

Метод реализации адаптера; не вызывайте его. Адаптирует событие окончания документа SAX1.

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

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

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

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

См. также:

startElement

public void startElement(String qName, AttributeList qAtts) throws SAXException

Метод реализации адаптера; не вызывайте его. Адаптирует событие startElement SAX1.

При необходимости выполняет обработку пространств имен.

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

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

Параметры:

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

qAtts — список атрибутов XML (с именами qname).

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

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

См. также:

endElement

public void endElement(String qName) throws SAXException

Метод реализации адаптера; не вызывайте его. Адаптирует событие окончания элемента SAX1.

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

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

Параметры:

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

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

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

См. также:

characters

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

Метод реализации адаптера; не вызывайте его. Адаптирует событие characters SAX1.

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

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

Параметры:

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

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

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

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

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

См. также:

ignorableWhitespace

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

Метод реализации адаптера; не вызывайте его. Адаптирует событие игнорируемых пробельных символов SAX1.

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

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

Параметры:

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

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

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

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

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

См. также:

processingInstruction

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

Метод реализации адаптера; не вызывайте его. Адаптирует событие инструкции обработки SAX1.

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

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

Параметры:

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

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

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

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.