Класс XMLReaderAdapter

java.lang.Object
- org.xml.sax.helpers.XMLReaderAdapter

Все реализованные интерфейсы:: ContentHandler, Parser

public class XMLReaderAdapter
extends Object
implements Parser, ContentHandler

Адаптирует SAX2 XMLReader как SAX1 Парсер.

Этот модуль, как исходный код, так и документация, находится в общественном достоянии и не имеет ГАРАНТИЙ. См. http://www.saxproject.org для получения дополнительной информации.

Этот класс оборачивает 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

Конструкторы

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)

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, 2020, 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/11/docs/api/java.xml/org/xml/sax/helpers/XMLReaderAdapter.html