Spec-Zone.ru › OpenJDK 25

Класс 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 end element.
void endPrefixMapping(String prefix)
Адаптирует событие SAX2 end prefix mapping.
void ignorableWhitespace(char[] ch, int start, int length)
Адаптирует событие SAX2 ignorable whitespace.
void parse(String systemId)
Разбирает документ.
void parse(InputSource input)
Разбирает документ.
void processingInstruction(String target, String data)
Адаптирует событие SAX2 processing instruction.
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 skipped entity.
void startDocument()
Событие начала документа.
void startElement(String uri, String localName, String qName, Attributes atts)
Адаптирует событие SAX2 start element.
void startPrefixMapping(String prefix, String uri)
Адаптирует событие SAX2 start prefix mapping.

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

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

Методы, объявленные в интерфейсе 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(Locale)

setEntityResolver

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

setDTDHandler

public void setDTDHandler(DTDHandler handler)
Регистрирует обработчик событий DTD.
Определено в:
setDTDHandler в интерфейсе Parser
Параметры:
handler — новый обработчик событий DTD.
См. также:
  • Parser.setDTDHandler(DTDHandler)

setDocumentHandler

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

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

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

setErrorHandler

public void setErrorHandler(ErrorHandler handler)
Регистрирует обработчик ошибок.
Определено в:
setErrorHandler в интерфейсе Parser
Параметры:
handler — новый обработчик ошибок.
См. также:
  • Parser.setErrorHandler(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(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(String, String)

endPrefixMapping

public void endPrefixMapping(String prefix)
Адаптирует событие SAX2 end prefix mapping.
Определено в:
endPrefixMapping в интерфейсе ContentHandler
Параметры:
prefix — сопоставляемый префикс.
См. также:
  • ContentHandler.endPrefixMapping(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(String, String, 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 ignorable whitespace.
Определено в:
ignorableWhitespace в интерфейсе ContentHandler
Параметры:
ch — массив символов.
start — начальная позиция в массиве.
length — количество используемых символов.
Выбрасывает:
SAXException — клиент может вызвать исключение обработки.
См. также:
  • ContentHandler.ignorableWhitespace(char[], int, int)

processingInstruction

public void processingInstruction(String target, String data) throws SAXException
Адаптирует событие SAX2 processing instruction.
Определено в:
processingInstruction в интерфейсе ContentHandler
Параметры:
target — цель инструкции обработки.
data — оставшаяся часть инструкции обработки
Выбрасывает:
SAXException — клиент может вызвать исключение обработки.
См. также:
  • ContentHandler.processingInstruction(String, String)

skippedEntity

public void skippedEntity(String name) throws SAXException
Адаптирует событие SAX2 skipped entity.
Определено в:
skippedEntity в интерфейсе ContentHandler
Параметры:
name — имя пропущенной сущности.
Выбрасывает:
SAXException — выбрасывается подклассами.
См. также:
  • ContentHandler.skippedEntity(String)

Сообщить об ошибке или предложить улучшение
Дополнительные справочные материалы по API и документацию для разработчиков см. в разделе Документация Java SE, где содержатся более подробные описания для разработчиков, включая обзоры концепций, определения терминов, обходные решения и примеры работающего кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее дочерних компаний в США и других странах.
Авторское право © 1993, 2025, Oracle и/или ее дочерние компании, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.xml/org/xml/sax/helpers/XMLReaderAdapter.html

Spec-Zone.ru

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