Spec-Zone.ru › OpenJDK 17

Класс XMLReaderAdapter

java.lang.Object
org.xml.sax.helpers.XMLReaderAdapter
Все реализуемые интерфейсы:
ContentHandler, Parser 
public class XMLReaderAdapter extends Object implements Parser, ContentHandler
Адаптирует SAX2 XMLReader в качестве SAX1 Parser.

Этот класс оборачивает SAX2 XMLReader и заставляет его действовать как SAX1 Parser. XMLReader должен поддерживать значение true для свойства http://xml.org/sax/features/namespace-prefixes, иначе разбор завершится ошибкой SAXException; если XMLReader поддерживает значение false для свойства http://xml.org/sax/features/namespaces, это также будет использоваться для повышения эффективности.

С тех пор:
1.4, SAX 2.0
См. также:
  • Parser
  • XMLReader

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

Конструктор Описание
XMLReaderAdapter()
Создать новый адаптер.
XMLReaderAdapter(XMLReader xmlReader)
Создать новый адаптер.

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

Модификатор и тип Метод Описание
void characters(char[] ch, int start, int length)
Адаптировать событие SAX2 characters.
void endDocument()
Событие окончания документа.
void endElement(String uri, String localName, String qName)
Адаптировать событие SAX2 окончания элемента.
void endPrefixMapping(String prefix)
Адаптировать событие SAX2 окончания сопоставления префиксов.
void ignorableWhitespace(char[] ch, int start, int length)
Адаптировать событие SAX2 игнорируемого пробела.
void parse(String systemId)
Обработать документ.
void parse(InputSource input)
Обработать документ.
void processingInstruction(String target, String data)
Адаптировать событие SAX2 инструкции обработки.
void setDocumentHandler(DocumentHandler handler)
Зарегистрировать обработчик событий документа SAX1.
void setDocumentLocator(Locator locator)
Установить локатор документа.
void setDTDHandler(DTDHandler handler)
Зарегистрировать обработчик событий DTD.
void setEntityResolver(EntityResolver resolver)
Зарегистрировать разрешитель сущностей.
void setErrorHandler(ErrorHandler handler)
Зарегистрировать обработчик событий ошибок.
void setLocale(Locale locale)
Установить локаль для отчетов об ошибках.
void skippedEntity(String name)
Адаптировать событие SAX2 пропущенной сущности.
void startDocument()
Событие начала документа.
void startElement(String uri, String localName, String qName, Attributes atts)
Адаптировать событие SAX2 начала элемента.
void startPrefixMapping(String prefix, String uri)
Адаптировать событие SAX2 начала сопоставления префиксов.

Методы, объявленные в классе java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Методы, объявленные в интерфейсе org.xml.sax.ContentHandler

declaration

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

XMLReaderAdapter

public XMLReaderAdapter() throws SAXException
Создать новый адаптер.

Используйте свойство "org.xml.sax.driver" для поиска SAX2-драйвера для встраивания.

Исключения:
SAXException - Если встроенный драйвер не может быть создан или свойство org.xml.sax.driver не указано.

XMLReaderAdapter

public XMLReaderAdapter(XMLReader xmlReader)
Создать новый адаптер.

Создать новый адаптер, обернутый вокруг SAX2 XMLReader. Адаптер заставит XMLReader действовать как SAX1-парсер.

Параметры:
xmlReader - SAX2 XMLReader для обёртывания.
Исключения:
NullPointerException - Если аргумент равен null.

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

setLocale

public void setLocale(Locale locale) throws SAXException
Установить локаль для отчётов об ошибках.

Это не поддерживается в SAX2 и всегда будет вызывать исключение.

Определено в:
setLocale в интерфейсе Parser
Параметры:
locale - локаль для отчётов об ошибках.
Исключения:
SAXException - Бросается, если не переопределено.
См. также:
  • Parser.setLocale(java.util.Locale)

setEntityResolver

public void setEntityResolver(EntityResolver resolver)
Зарегистрировать разрешитель сущностей.
Определено в:
setEntityResolver в интерфейсе Parser
Параметры:
resolver - Новый разрешитель.
См. также:
  • Parser.setEntityResolver(org.xml.sax.EntityResolver)

setDTDHandler

public void setDTDHandler(DTDHandler handler)
Зарегистрировать обработчик событий DTD.
Определено в:
setDTDHandler в интерфейсе Parser
Параметры:
handler - Новый обработчик событий DTD.
См. также:
  • Parser.setDTDHandler(org.xml.sax.DTDHandler)

setDocumentHandler

public void setDocumentHandler(DocumentHandler handler)
Зарегистрировать обработчик событий документа SAX1.

Обратите внимание, что обработчик документов SAX1 не поддерживает пространства имён.

Определено в:
setDocumentHandler в интерфейсе Parser
Параметры:
handler - Новый обработчик событий документа SAX1.
См. также:
  • Parser.setDocumentHandler(org.xml.sax.DocumentHandler)

setErrorHandler

public void setErrorHandler(ErrorHandler handler)
Зарегистрировать обработчик событий ошибок.
Определено в:
setErrorHandler в интерфейсе Parser
Параметры:
handler - Новый обработчик событий ошибок.
См. также:
  • Parser.setErrorHandler(org.xml.sax.ErrorHandler)

parse

public void parse(String systemId) throws IOException, SAXException
Обработать документ.

Этот метод выбросит исключение, если встроенный XMLReader не поддерживает свойство http://xml.org/sax/features/namespace-prefixes.

Определено в:
parse в интерфейсе Parser
Параметры:
systemId - Абсолютный URL документа.
Исключения:
IOException - Если есть проблема с чтением исходного содержимого документа.
SAXException - Если есть проблема с обработкой документа.
См. также:
  • parse(org.xml.sax.InputSource)
  • Parser.parse(java.lang.String)

parse

public void parse(InputSource input) throws IOException, SAXException
Обработать документ.

Этот метод выбросит исключение, если встроенный XMLReader не поддерживает свойство http://xml.org/sax/features/namespace-prefixes.

Определено в:
parse в интерфейсе Parser
Параметры:
input - Источник ввода для документа.
Исключения:
IOException - Если есть проблема с чтением исходного содержимого документа.
SAXException - Если есть проблема с обработкой документа.
См. также:
  • parse(java.lang.String)
  • Parser.parse(org.xml.sax.InputSource)

setDocumentLocator

public void setDocumentLocator(Locator locator)
Установить локатор документа.
Определено в:
setDocumentLocator в интерфейсе ContentHandler
Параметры:
locator - Локатор документа.
См. также:
  • ContentHandler.setDocumentLocator(org.xml.sax.Locator)

startDocument

public void startDocument() throws SAXException
Начать событие документа.
Определено в:
startDocument в интерфейсе ContentHandler
Исключения:
SAXException - Клиент может вызвать исключение обработки.
См. также:
  • ContentHandler.startDocument()

endDocument

public void endDocument() throws SAXException
Завершить событие документа.
Определено в:
endDocument в интерфейсе ContentHandler
Исключения:
SAXException - Клиент может вызвать исключение обработки.
См. также:
  • ContentHandler.endDocument()

startPrefixMapping

public void startPrefixMapping(String prefix, String uri)
Адаптировать событие SAX2 начала сопоставления префиксов.
Определено в:
startPrefixMapping в интерфейсе ContentHandler
Параметры:
prefix - Префикс, который сопоставляется.
uri - URI пространства имён, к которому сопоставляется.
См. также:
  • ContentHandler.startPrefixMapping(java.lang.String, java.lang.String)

endPrefixMapping

public void endPrefixMapping(String prefix)
Адаптировать событие SAX2 окончания сопоставления префиксов.
Определено в:
endPrefixMapping в интерфейсе ContentHandler
Параметры:
prefix - Префикс, который сопоставляется.
См. также:
  • ContentHandler.endPrefixMapping(java.lang.String)

startElement

public void startElement(String uri, String localName, String qName, Attributes atts) throws SAXException
Адаптировать событие SAX2 начала элемента.
Определено в:
startElement в интерфейсе ContentHandler
Параметры:
uri - URI пространства имён.
localName - Локальное имя пространства имён.
qName - Полное (префиксное) имя.
atts - SAX2 атрибуты.
Исключения:
SAXException - Клиент может вызвать исключение обработки.
См. также:
  • ContentHandler.endDocument()

endElement

public void endElement(String uri, String localName, String qName) throws SAXException
Адаптировать событие SAX2 окончания элемента.
Определено в:
endElement в интерфейсе ContentHandler
Параметры:
uri - URI пространства имён.
localName - Локальное имя пространства имён.
qName - Полное (префиксное) имя.
Исключения:
SAXException - Клиент может вызвать исключение обработки.
См. также:
  • ContentHandler.endElement(java.lang.String, java.lang.String, java.lang.String)

characters

public void characters(char[] ch, int start, int length) throws SAXException
Адаптировать событие SAX2 символов.
Определено в:
characters в интерфейсе ContentHandler
Параметры:
ch - Массив символов.
start - Начальная позиция в массиве.
length - Количество символов для использования.
Исключения:
SAXException - Клиент может вызвать исключение обработки.
См. также:
  • ContentHandler.characters(char[], int, int)

Пробелы, игнорируемые при обработке

public void ignorableWhitespace(char[] ch, int start, int length) throws SAXException
Адаптирует событие SAX2 игнорируемых пробелов.
Указано в:
ignorableWhitespace в интерфейсе ContentHandler
Параметры:
ch - Массив символов.
start - Начальная позиция в массиве.
length - Количество символов для использования.
Исключения:
SAXException - Клиент может вызвать исключение обработки.
См. также:
  • ContentHandler.ignorableWhitespace(char[], int, int)

Обработка инструкции

public void processingInstruction(String target, String data) throws SAXException
Адаптирует событие SAX2 обработки инструкции.
Указано в:
processingInstruction в интерфейсе ContentHandler
Параметры:
target - Цель инструкции по обработке.
data - Остальная часть инструкции по обработке
Исключения:
SAXException - Клиент может вызвать исключение обработки.
См. также:
  • ContentHandler.processingInstruction(java.lang.String, java.lang.String)

Пропущенный сущность

public void skippedEntity(String name) throws SAXException
Адаптирует событие SAX2 пропущенной сущности.
Указано в:
skippedEntity в интерфейсе ContentHandler
Параметры:
name - Имя пропущенной сущности.
Исключения:
SAXException - Исключение, выбрасываемое подклассами.
См. также:
  • ContentHandler.skippedEntity(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/XMLReaderAdapter.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API