Класс ParserAdapter

Все реализованные интерфейсы:
DocumentHandler, XMLReader 
public class ParserAdapter
extends Object
implements XMLReader, DocumentHandler

Адаптирует SAX1-парсер в качестве SAX2 XMLReader.

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

Этот класс оборачивает SAX1 Parser и заставляет его работать как SAX2 XMLReader с поддержкой функций, свойств и пространств имён. Обратите внимание, что невозможно сообщить о событиях skippedEntity, так как SAX1 не предоставляет эту информацию.

Этот адаптер не проверяет наличие дубликатов имён атрибутов с квалификацией пространства имён.

С:
1.4, SAX 2.0
См. также:
XMLReaderAdapter, XMLReader, Parser

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

Конструктор Описание
ParserAdapter()

Создаёт новый адаптер парсера.
ParserAdapter​(Parser parser)

Создаёт новый адаптер парсера.

Методы

Модификатор и тип Метод Описание
void characters​(char[] ch, int start, int length)

Метод реализации адаптера; не вызывать.
void endDocument()

Метод реализации адаптера; не вызывать.
void endElement​(String qName)

Метод реализации адаптера; не вызывать.
ContentHandler getContentHandler()

Возвращает текущий обработчик содержимого.
DTDHandler getDTDHandler()

Возвращает текущий обработчик DTD.
EntityResolver getEntityResolver()

Возвращает текущий разрешитель сущностей.
ErrorHandler getErrorHandler()

Возвращает текущий обработчик ошибок.
boolean getFeature​(String name)

Проверка флага функции парсера.
Object getProperty​(String name)

Получение свойства парсера.
void ignorableWhitespace​(char[] ch, int start, int length)

Метод реализации адаптера; не вызывать.
void parse​(String systemId)

Парсинг XML-документа.
void parse​(InputSource input)

Парсинг XML-документа.
void processingInstruction​(String target, String data)

Метод реализации адаптера; не вызывать.
void setContentHandler​(ContentHandler handler)

Установка обработчика содержимого.
void setDocumentLocator​(Locator locator)

Метод реализации адаптера; не вызывать.
void setDTDHandler​(DTDHandler handler)

Установка обработчика DTD.
void setEntityResolver​(EntityResolver resolver)

Установка разрешителя сущностей.
void setErrorHandler​(ErrorHandler handler)

Установка обработчика ошибок.
void setFeature​(String name, boolean value)

Установка флага функции для парсера.
void setProperty​(String name, Object value)

Установка свойства парсера.
void startDocument()

Метод реализации адаптера; не вызывать.
void startElement​(String qName, AttributeList qAtts)

Метод реализации адаптера; не вызывать.

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

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

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

ParserAdapter

public ParserAdapter()
              throws SAXException

Создаёт новый адаптер парсера.

Используйте свойство "org.xml.sax.parser" для поиска встроенного SAX1-драйвера.

Издаёт:
SAXException - Если встроенный драйвер не может быть создан или свойство org.xml.sax.parser не задано.

ParserAdapter

public ParserAdapter(Parser parser)

Создаёт новый адаптер парсера.

Обратите внимание, что встроенный парсер нельзя изменить после создания адаптера; для вставки другого парсера создайте новый ParserAdapter.

Параметры:
parser - SAX1-парсер для вставки.
Издаёт:
NullPointerException - Если параметр parser равен null.

Методы

setFeature

public void setFeature(String name,
                       boolean value)
                throws SAXNotRecognizedException,
                       SAXNotSupportedException

Установить флаг функции для анализатора.

Единственные распознаваемые функции — пространства имён и префиксы пространств имён.

Установлено:
setFeature в интерфейсе XMLReader
Параметры:
name — имя функции в виде полного URI.
value — требуемое значение функции.
Исключения:
SAXNotRecognizedException — если функцию нельзя назначить или получить.
SAXNotSupportedException — если функции нельзя назначить это значение.
См. также:
XMLReader.setFeature(java.lang.String, boolean)

getFeature

public boolean getFeature(String name)
                   throws SAXNotRecognizedException,
                          SAXNotSupportedException

Проверка флага функции анализатора.

Единственные распознаваемые функции — пространства имён и префиксы пространств имён.

Установлено:
getFeature в интерфейсе XMLReader
Параметры:
name — имя функции в виде полного URI.
Возвращает:
Текущее значение функции.
Исключения:
SAXNotRecognizedException — если значение функции нельзя назначить или получить.
SAXNotSupportedException — если функция в настоящее время не читаема.
См. также:
XMLReader.setFeature(java.lang.String, boolean)

setProperty

public void setProperty(String name,
                        Object value)
                 throws SAXNotRecognizedException,
                        SAXNotSupportedException

Установить свойство анализатора.

В настоящее время не распознаются никакие свойства.

Установлено:
setProperty в интерфейсе XMLReader
Параметры:
name — имя свойства.
value — значение свойства.
Исключения:
SAXNotRecognizedException — если значение свойства нельзя назначить или получить.
SAXNotSupportedException — если свойству нельзя назначить это значение.
См. также:
XMLReader.setProperty(java.lang.String, java.lang.Object)

getProperty

public Object getProperty(String name)
                   throws SAXNotRecognizedException,
                          SAXNotSupportedException

Получить свойство анализатора.

В настоящее время не распознаются никакие свойства.

Установлено:
getProperty в интерфейсе XMLReader
Параметры:
name — имя свойства.
Возвращает:
Значение свойства.
Исключения:
SAXNotRecognizedException — если значение свойства нельзя назначить или получить.
SAXNotSupportedException — если значение свойства в настоящее время не доступно для чтения.
См. также:
XMLReader.getProperty(java.lang.String)

setEntityResolver

public void setEntityResolver(EntityResolver resolver)

Установить решатель сущностей.

Установлено:
setEntityResolver в интерфейсе XMLReader
Параметры:
resolver — новый решатель сущностей.
См. также:
XMLReader.setEntityResolver(org.xml.sax.EntityResolver)

getEntityResolver

public EntityResolver getEntityResolver()

Возвращает текущий решатель сущностей.

Установлено:
getEntityResolver в интерфейсе XMLReader
Возвращает:
Текущий решатель сущностей или null, если он не был предоставлен.
См. также:
XMLReader.getEntityResolver()

setDTDHandler

public void setDTDHandler(DTDHandler handler)

Установить обработчик DTD.

Установлено:
setDTDHandler в интерфейсе XMLReader
Параметры:
handler — новый обработчик DTD
См. также:
XMLReader.setEntityResolver(org.xml.sax.EntityResolver)

getDTDHandler

public DTDHandler getDTDHandler()

Возвращает текущий обработчик DTD.

Установлено:
getDTDHandler в интерфейсе XMLReader
Возвращает:
текущий обработчик DTD или null, если он не был предоставлен
См. также:
XMLReader.getEntityResolver()

setContentHandler

public void setContentHandler(ContentHandler handler)

Установить обработчик содержимого.

Установлено:
setContentHandler в интерфейсе XMLReader
Параметры:
handler — новый обработчик содержимого
См. также:
XMLReader.setEntityResolver(org.xml.sax.EntityResolver)

getContentHandler

public ContentHandler getContentHandler()

Возвращает текущий обработчик содержимого.

Установлено:
getContentHandler в интерфейсе XMLReader
Возвращает:
Текущий обработчик содержимого или null, если он не был предоставлен.
См. также:
XMLReader.getEntityResolver()

setErrorHandler

public void setErrorHandler(ErrorHandler handler)

Установить обработчик ошибок.

Установлено:
setErrorHandler в интерфейсе XMLReader
Параметры:
handler — новый обработчик ошибок.
См. также:
XMLReader.setEntityResolver(org.xml.sax.EntityResolver)

getErrorHandler

public ErrorHandler getErrorHandler()

Возвращает текущий обработчик ошибок.

Установлено:
getErrorHandler в интерфейсе XMLReader
Возвращает:
Текущий обработчик ошибок или null, если он не был предоставлен.
См. также:
XMLReader.getEntityResolver()

parse

public void parse(String systemId)
           throws IOException,
                  SAXException

Проанализировать XML-документ.

Установлено:
parse в интерфейсе XMLReader
Параметры:
systemId — абсолютный URL документа.
Исключения:
IOException — если есть проблема с чтением исходного содержимого документа.
SAXException — если есть проблема с обработкой документа.
См. также:
parse(org.xml.sax.InputSource), Parser.parse(java.lang.String)

parse

public void parse(InputSource input)
           throws IOException,
                  SAXException

Проанализировать XML-документ.

Установлено:
parse в интерфейсе XMLReader
Параметры:
input — источник данных для документа.
Исключения:
IOException — если есть проблема с чтением исходного содержимого документа.
SAXException — если есть проблема с обработкой документа.
См. также:
parse(java.lang.String), Parser.parse(org.xml.sax.InputSource)

setDocumentLocator

public void setDocumentLocator(Locator locator)

Метод адаптера; не вызывать. Адаптировать событие локализации документа SAX1.

Установлено:
setDocumentLocator в интерфейсе DocumentHandler
Параметры:
locator — локатор документа.
См. также:
ContentHandler.setDocumentLocator(org.xml.sax.Locator)

startDocument

public void startDocument()
                   throws SAXException

Метод адаптера; не вызывать. Адаптировать событие начала документа SAX1.

Установлено:
startDocument в интерфейсе DocumentHandler
Исключения:
SAXException — клиент может вызвать исключение обработки.
См. также:
DocumentHandler.startDocument()

endDocument

public void endDocument()
                 throws SAXException

Метод адаптера; не вызывать. Адаптировать событие окончания документа SAX1.

Установлено:
endDocument в интерфейсе DocumentHandler
Исключения:
SAXException — клиент может вызвать исключение обработки.
См. также:
DocumentHandler.endDocument()

startElement

public void startElement(String qName,
                         AttributeList qAtts)
                  throws SAXException

Метод адаптера; не вызывать. Адаптировать событие startElement SAX1.

При необходимости выполнить обработку пространства имён.

Установлено:
startElement в интерфейсе DocumentHandler
Параметры:
qName — квалифицированное (с префиксом) имя.
qAtts — список атрибутов XML (с qname).
Исключения:
SAXException — клиент может вызвать исключение обработки.
См. также:
DocumentHandler.endElement(java.lang.String), AttributeList

endElement

public void endElement(String qName)
                throws SAXException

Метод адаптера; не вызывать. Адаптировать событие окончания элемента SAX1.

Установлено:
endElement в интерфейсе DocumentHandler
Параметры:
qName — квалифицированное (с префиксом) имя.
Исключения:
SAXException — клиент может вызвать исключение обработки.
См. также:
DocumentHandler.endElement(java.lang.String)

characters

public void characters(char[] ch,
                       int start,
                       int length)
                throws SAXException

Метод адаптера; не вызывать. Адаптировать событие символов SAX1.

Установлено:
characters в интерфейсе DocumentHandler
Параметры:
ch — массив символов.
start — начальная позиция в массиве.
length — количество символов для использования.
Исключения:
SAXException — клиент может вызвать исключение обработки.
См. также:
DocumentHandler.characters(char[], int, int)

ignorableWhitespace

public void ignorableWhitespace(char[] ch,
                                int start,
                                int length)
                         throws SAXException

Метод адаптера; не вызывать. Адаптировать событие игнорируемых пробелов SAX1.

Указано:
ignorableWhitespace в интерфейсе DocumentHandler
Параметры:
ch - Массив символов.
start - Начальная позиция в массиве.
length - Количество символов для использования.
Исключения:
SAXException - Клиент может вызвать исключение обработки.
См. также:
DocumentHandler.ignorableWhitespace(char[], int, int)

processingInstruction

public void processingInstruction(String target,
                                  String data)
                           throws SAXException

Метод адаптера; не вызывать. Адаптирует событие обработки инструкции SAX1.

Указано:
processingInstruction в интерфейсе DocumentHandler
Параметры:
target - Цель инструкции обработки.
data - Остальная часть инструкции обработки
Исключения:
SAXException - Клиент может вызвать исключение обработки.
См. также:
DocumentHandler.processingInstruction(java.lang.String, 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/ParserAdapter.html

Spec-Zone .ru
спецификации, руководства, описания, API