Класс ParserAdapter

public class ParserAdapter
extends Object
implements XMLReader, DocumentHandler

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

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

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

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

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

ParserAdapter

public ParserAdapter()
              throws SAXException

Исключения:

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

ParserAdapter

public ParserAdapter(Parser parser)

Параметры:

parser - Встраиваемый парсер SAX1.

Исключения:

NullPointerException - Если параметр парсера равен 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 в интерфейсе DocumentHandler

Параметры:

qName - Квалифицированное (с префиксом) имя.

qAtts - Список XML-атрибутов (с qnames).

Исключения:

SAXException - Клиент может вызвать исключение обработки.

См. также:

DocumentHandler.endElement(java.lang.String), AttributeList

endElement

public void endElement(String qName)
                throws SAXException

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

Указано в:

endElement в интерфейсе DocumentHandler

Параметры:

qName - Квалифицированное (с префиксом) имя.

Исключения:

SAXException - Клиент может вызвать исключение обработки.

См. также:

DocumentHandler.endElement(java.lang.String)

characters

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

Метод реализации адаптера; не вызывать. Адаптировать событие characters 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)