Класс ParserAdapter

java.lang.Object

org.xml.sax.helpers.ParserAdapter

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

public class ParserAdapter extends Object implements XMLReader, DocumentHandler

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

Этот класс оборачивает SAX1 Parser и заставляет его действовать как SAX2 XMLReader с поддержкой функций, свойств и пространств имён. Обратите внимание, что невозможно сообщить события 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)`	Метод реализации адаптера; не вызывать.

Методы, объявленные в классе java.lang.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 - Если параметр 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)

Метод реализации адаптера; не вызывать. Адаптирует событие локетора XML-документа 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

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

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

Указано в:

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

Параметры:

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

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

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

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

Метод реализации адаптера; не вызывать. Адаптирует событие символов 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.xml/org/xml/sax/helpers/ParserAdapter.html