Класс 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 - Если параметр парсера равен null.

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

setFeature

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

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

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

Указано в:

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

Параметры:

name - Имя функции, как полный URI.

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

Исключения:

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

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

См. также:

getFeature

public boolean getFeature(String name) throws SAXNotRecognizedException, SAXNotSupportedException

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

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

Указано в:

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

Метод реализации адаптера; не вызывать. Адаптирует событие начала элемента 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, 2023, 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/21/docs/api/java.xml/org/xml/sax/helpers/ParserAdapter.html