Класс ParserAdapter

java.lang.Object

org.xml.sax.helpers.ParserAdapter

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

public class ParserAdapter extends Object implements XMLReader, DocumentHandler

Адаптирует SAX1 Parser как 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

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

Распознаются только функции пространств имен и префиксов пространств имен.

Установлено:

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

Параметры:

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

value - Требуемое значение функции.

Исключение:

SAXNotRecognizedException - Если функция не может быть назначена или получена.

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

См. также:

XMLReader.setFeature(java.lang.String, boolean)

getFeature

public boolean getFeature(String name) throws SAXNotRecognizedException, SAXNotSupportedException

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

Распознаются только функции пространств имен и префиксов пространств имен.

Установлено:

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

Параметры:

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

Возвращает:

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

Исключение:

SAXNotRecognizedException - Если значение функции не может быть назначено или получено.

SAXNotSupportedException - Если функция в данный момент не может быть прочитана.

См. также:

XMLReader.setFeature(java.lang.String, boolean)

setProperty

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

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

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

Установлено:

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

Параметры:

name - Название свойства.

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

Исключение:

SAXNotRecognizedException - Если значение свойства не может быть назначено или получено.

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

См. также:

XMLReader.setProperty(java.lang.String, java.lang.Object)

getProperty

public Object getProperty(String name) throws SAXNotRecognizedException, SAXNotSupportedException

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

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

Установлено:

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

Параметры:

name - Название свойства.

Возвращает:

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

Исключение:

SAXNotRecognizedException - Если значение свойства не может быть назначено или получено.

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

См. также:

XMLReader.getProperty(java.lang.String)

setEntityResolver

public void setEntityResolver(EntityResolver resolver)

Установить решатель сущностей.

Установлено:

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

Параметры:

resolver - Новый решатель сущностей.

См. также:

XMLReader.setEntityResolver(org.xml.sax.EntityResolver)

getEntityResolver

public EntityResolver getEntityResolver()

Возвратить текущего решателя сущностей.

Установлено:

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

Возвращает:

Текущий решатель сущностей или null, если он не был предоставлен.

См. также:

XMLReader.getEntityResolver()

setDTDHandler

public void setDTDHandler(DTDHandler handler)

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

Установлено:

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

Параметры:

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

См. также:

XMLReader.setEntityResolver(org.xml.sax.EntityResolver)

getDTDHandler

public DTDHandler getDTDHandler()

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

Установлено:

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

Возвращает:

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

См. также:

XMLReader.getEntityResolver()

setContentHandler

public void setContentHandler(ContentHandler handler)

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

Установлено:

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

Параметры:

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

См. также:

XMLReader.setEntityResolver(org.xml.sax.EntityResolver)

getContentHandler

public ContentHandler getContentHandler()

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

Установлено:

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

Возвращает:

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

См. также:

XMLReader.getEntityResolver()

setErrorHandler

public void setErrorHandler(ErrorHandler handler)

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

Установлено:

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

Параметры:

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

См. также:

XMLReader.setEntityResolver(org.xml.sax.EntityResolver)

getErrorHandler

public ErrorHandler getErrorHandler()

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

Установлено:

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

Возвращает:

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

См. также:

XMLReader.getEntityResolver()

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 - Локатор документа.

См. также:

ContentHandler.setDocumentLocator(org.xml.sax.Locator)

startDocument

public void startDocument() throws SAXException

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

Установлено:

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

Исключение:

SAXException - Клиент может поднять исключение обработки.

См. также:

DocumentHandler.startDocument()

endDocument

public void endDocument() throws SAXException

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

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

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

Исключение:

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

См. также:

DocumentHandler.endDocument()

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 - Клиент может вызвать исключение обработки.

См. также:

DocumentHandler.endElement(java.lang.String)

characters

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

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

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

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

Параметры:

ch - Массив символов.

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

length - Количество символов для использования.

Исключение:

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

См. также:

DocumentHandler.characters(char[], int, int)

ignorableWhitespace

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

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

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

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

Параметры:

ch - Массив символов.

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

length - Количество символов для использования.

Исключение:

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

См. также:

DocumentHandler.ignorableWhitespace(char[], int, int)

processingInstruction

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

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

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

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

Параметры:

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

data - Остальная часть инструкции обработки

Исключение:

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

См. также:

DocumentHandler.processingInstruction(java.lang.String, java.lang.String)

© 1993, 2021, 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/17/docs/api/java.xml/org/xml/sax/helpers/ParserAdapter.html