Класс XMLReaderAdapter
- Все реализуемые интерфейсы:
ContentHandler, Parser
public class XMLReaderAdapter extends Object implements Parser, ContentHandler
Этот класс оборачивает 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
- См. также:
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
XMLReaderAdapter() |
Создает новый адаптер. |
XMLReaderAdapter |
Создает новый адаптер. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
characters |
Адаптирует событие SAX2 characters. |
void |
endDocument() |
Событие окончания документа. |
void |
endElement |
Адаптирует событие SAX2 end element. |
void |
endPrefixMapping |
Адаптирует событие SAX2 end prefix mapping. |
void |
ignorableWhitespace |
Адаптирует событие SAX2 ignorable whitespace. |
void |
parse |
Разбирает документ. |
void |
parse |
Разбирает документ. |
void |
processingInstruction |
Адаптирует событие SAX2 processing instruction. |
void |
setDocumentHandler |
Регистрирует обработчик событий документа SAX1. |
void |
setDocumentLocator |
Задает локатор документа. |
void |
setDTDHandler |
Регистрирует обработчик событий DTD. |
void |
setEntityResolver |
Регистрирует разрешитель сущностей. |
void |
setErrorHandler |
Регистрирует обработчик ошибок. |
void |
setLocale |
Задает локаль для сообщений об ошибках. |
void |
skippedEntity |
Адаптирует событие SAX2 skipped entity. |
void |
startDocument() |
Событие начала документа. |
void |
startElement |
Адаптирует событие SAX2 start element. |
void |
startPrefixMapping |
Адаптирует событие 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— выбрасывается, если метод не переопределен. - См. также:
setEntityResolver
public void setEntityResolver(EntityResolver resolver)
- Определено в:
-
setEntityResolverв интерфейсеParser - Параметры:
-
resolver— новый разрешитель. - См. также:
setDTDHandler
public void setDTDHandler(DTDHandler handler)
- Определено в:
-
setDTDHandlerв интерфейсеParser - Параметры:
-
handler— новый обработчик событий DTD. - См. также:
setDocumentHandler
public void setDocumentHandler(DocumentHandler handler)
Обратите внимание, что обработчик документа SAX1 не поддерживает пространства имен.
- Определено в:
-
setDocumentHandlerв интерфейсеParser - Параметры:
-
handler— новый обработчик событий документа SAX1. - См. также:
setErrorHandler
public void setErrorHandler(ErrorHandler handler)
- Определено в:
-
setErrorHandlerв интерфейсеParser - Параметры:
-
handler— новый обработчик ошибок. - См. также:
parse
public void parse(String systemId) throws IOException, SAXException
Этот метод выбрасывает исключение, если встроенный XMLReader не поддерживает свойство http://xml.org/sax/features/namespace-prefixes.
- Определено в:
-
parseв интерфейсеParser - Параметры:
-
systemId— абсолютный URL документа. - Выбрасывает:
-
IOException— если возникла проблема при чтении исходного содержимого документа. -
SAXException— если возникла проблема при обработке документа. - См. также:
parse
public void parse(InputSource input) throws IOException, SAXException
Этот метод выбрасывает исключение, если встроенный XMLReader не поддерживает свойство http://xml.org/sax/features/namespace-prefixes.
- Определено в:
-
parseв интерфейсеParser - Параметры:
-
input— источник входных данных документа. - Выбрасывает:
-
IOException— если возникла проблема при чтении исходного содержимого документа. -
SAXException— если возникла проблема при обработке документа. - См. также:
setDocumentLocator
public void setDocumentLocator(Locator locator)
- Определено в:
-
setDocumentLocatorв интерфейсеContentHandler - Параметры:
-
locator— локатор документа. - См. также:
startDocument
public void startDocument() throws SAXException
- Определено в:
-
startDocumentв интерфейсеContentHandler - Выбрасывает:
-
SAXException— клиент может вызвать исключение обработки. - См. также:
endDocument
public void endDocument() throws SAXException
- Определено в:
-
endDocumentв интерфейсеContentHandler - Выбрасывает:
-
SAXException— клиент может вызвать исключение обработки. - См. также:
startPrefixMapping
public void startPrefixMapping(String prefix, String uri)
- Определено в:
-
startPrefixMappingв интерфейсеContentHandler - Параметры:
-
prefix— сопоставляемый префикс. -
uri— URI пространства имен, с которым выполняется сопоставление. - См. также:
endPrefixMapping
public void endPrefixMapping(String prefix)
- Определено в:
-
endPrefixMappingв интерфейсеContentHandler - Параметры:
-
prefix— сопоставляемый префикс. - См. также:
startElement
public void startElement(String uri, String localName, String qName, Attributes atts) throws SAXException
- Определено в:
-
startElementв интерфейсеContentHandler - Параметры:
-
uri— URI пространства имен. -
localName— локальное имя в пространстве имен. -
qName— квалифицированное имя (с префиксом). -
atts— атрибуты SAX2. - Выбрасывает:
-
SAXException— клиент может вызвать исключение обработки. - См. также:
endElement
public void endElement(String uri, String localName, String qName) throws SAXException
- Определено в:
-
endElementв интерфейсеContentHandler - Параметры:
-
uri— URI пространства имен. -
localName— локальное имя в пространстве имен. -
qName— квалифицированное имя (с префиксом). - Выбрасывает:
-
SAXException— клиент может вызвать исключение обработки. - См. также:
characters
public void characters(char[] ch, int start, int length) throws SAXException
- Определено в:
-
charactersв интерфейсеContentHandler - Параметры:
-
ch— массив символов. -
start— начальная позиция в массиве. -
length— количество используемых символов. - Выбрасывает:
-
SAXException— клиент может вызвать исключение обработки. - См. также:
ignorableWhitespace
public void ignorableWhitespace(char[] ch, int start, int length) throws SAXException
- Определено в:
-
ignorableWhitespaceв интерфейсеContentHandler - Параметры:
-
ch— массив символов. -
start— начальная позиция в массиве. -
length— количество используемых символов. - Выбрасывает:
-
SAXException— клиент может вызвать исключение обработки. - См. также:
processingInstruction
public void processingInstruction(String target, String data) throws SAXException
- Определено в:
-
processingInstructionв интерфейсеContentHandler - Параметры:
-
target— цель инструкции обработки. -
data— оставшаяся часть инструкции обработки - Выбрасывает:
-
SAXException— клиент может вызвать исключение обработки. - См. также:
skippedEntity
public void skippedEntity(String name) throws SAXException
- Определено в:
-
skippedEntityв интерфейсеContentHandler - Параметры:
-
name— имя пропущенной сущности. - Выбрасывает:
-
SAXException— выбрасывается подклассами. - См. также:
© 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