Spec-Zone.ru › OpenJDK 24

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

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

ignorableWhitespace

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

processingInstruction

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

skippedEntity

public void skippedEntity(String name) throws SAXException
Адаптировать событие SAX2 пропущенного сущности.
Определено:
skippedEntity в интерфейсе ContentHandler
Параметры:
name - Имя пропущенной сущности.
Исключения:
SAXException - Исключение, генерируемое подклассами.
См. также:
  • ContentHandler.skippedEntity(java.lang.String)

© 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/XMLReaderAdapter.html

Spec-Zone.ru

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