Класс 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

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

ParserAdapter

public ParserAdapter() throws SAXException

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

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

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

ParserAdapter

public ParserAdapter(Parser parser)

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

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

Параметры:: parser — анализатор SAX1 для встраивания.
Выбрасывает:: NullPointerException — если параметр анализатора равен 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

Метод реализации адаптера; не вызывайте его. Адаптирует событие ignorable whitespace 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.xml/org/xml/sax/helpers/ParserAdapter.html