Spec-Zone.ru › OpenJDK 21

Класс 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 должен поддерживать истинное значение для свойства http://xml.org/sax/features/namespace-prefixes, иначе разбор завершится ошибкой SAXException; если XMLReader поддерживает ложное значение для свойства 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 start prefix mapping.
Определено в:
startPrefixMapping в интерфейсе ContentHandler
Параметры:
prefix - Префикс, который сопоставляется.
uri - URI пространства имён, к которому производится сопоставление.
См. также:
  • ContentHandler.startPrefixMapping(java.lang.String, java.lang.String)

endPrefixMapping

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

startElement

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

endElement

public void endElement(String uri, String localName, String qName) throws SAXException
Адаптировать событие SAX2 end element.
Определено в:
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)

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

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

Spec-Zone.ru

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