Класс XMLReaderAdapter

public class XMLReaderAdapter
extends Object
implements Parser, ContentHandler

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

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

Этот класс оборачивает SAX2 XMLReader и заставляет его действовать как SAX1 Parser. XMLReader должен поддерживать истинное значение для свойства http://xml.org/sax/features/namespace-prefixes, иначе разбор завершится ошибкой SAXException; если XMLReader поддерживает ложное значение для свойства http://xml.org/sax/features/namespaces, это также будет использовано для повышения эффективности.

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

XMLReaderAdapter

public XMLReaderAdapter()
                 throws SAXException

Возбуждает:

SAXException - Если встроенный драйвер не может быть создан или свойство org.xml.sax.driver не указано.

XMLReaderAdapter

public XMLReaderAdapter(XMLReader xmlReader)

Параметры:

xmlReader - SAX2 XMLReader для обертывания.

Возбуждает:

NullPointerException - Если аргумент равен null.

Методы

setLocale

public void setLocale(Locale locale)
               throws SAXException

Определено в:

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)

Определено в:

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

Определено в:

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

Определено в:

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)