Класс DefaultHandler

public class DefaultHandler
extends Object
implements EntityResolver, DTDHandler, ContentHandler, ErrorHandler

Базовый класс по умолчанию для обработчиков событий SAX2.

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

Этот класс доступен как удобный базовый класс для приложений SAX2: он предоставляет реализации по умолчанию для всех обратных вызовов в четырёх основных классах обработчиков SAX2:

• EntityResolver
• DTDHandler
• ContentHandler
• ErrorHandler

Разработчики приложений могут расширить этот класс, когда им нужно реализовать только часть интерфейса; разработчики парсеров могут создать экземпляр этого класса для предоставления обработчиков по умолчанию, когда приложение не предоставило собственных.

Этот класс заменяет устаревший класс SAX1 HandlerBase.

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

DefaultHandler

public DefaultHandler()

Методы

resolveEntity

public InputSource resolveEntity(String publicId,
                                 String systemId)
                          throws IOException,
                                 SAXException

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

resolveEntity в интерфейсе EntityResolver

Параметры:

publicId - Публичный идентификатор или null, если он недоступен.

systemId - Системный идентификатор, предоставленный в документе XML.

Возвращает:

Новый источник ввода или null, чтобы потребовать поведение по умолчанию.

Исключения:

IOException - Если возникла ошибка при настройке нового источника ввода.

SAXException - Любое исключение SAX, возможно, обернутое другим исключением.

См. также:

EntityResolver.resolveEntity(java.lang.String, java.lang.String)

notationDecl

public void notationDecl(String name,
                         String publicId,
                         String systemId)
                  throws SAXException

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

notationDecl в интерфейсе DTDHandler

Параметры:

name - Имя обозначения.

publicId - Публичный идентификатор обозначения или null, если он не доступен.

systemId - Системный идентификатор обозначения.

Исключения:

SAXException - Любое исключение SAX, возможно, обернутое другим исключением.

См. также:

DTDHandler.notationDecl(java.lang.String, java.lang.String, java.lang.String)

unparsedEntityDecl

public void unparsedEntityDecl(String name,
                               String publicId,
                               String systemId,
                               String notationName)
                        throws SAXException

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

unparsedEntityDecl в интерфейсе DTDHandler

Параметры:

name - Имя сущности.

publicId - Публичный идентификатор сущности или null, если он не доступен.

systemId - Системный идентификатор сущности.

notationName - Имя связанного обозначения.

Исключения:

SAXException - Любое исключение SAX, возможно, обернутое другим исключением.

См. также:

DTDHandler.unparsedEntityDecl(java.lang.String, java.lang.String, java.lang.String, java.lang.String)

setDocumentLocator

public void setDocumentLocator(Locator locator)

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

setDocumentLocator в интерфейсе ContentHandler

Параметры:

locator - Локатор для всех событий SAX документа.

См. также:

ContentHandler.setDocumentLocator(org.xml.sax.Locator), Locator

startDocument

public void startDocument()
                   throws SAXException

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

startDocument в интерфейсе ContentHandler

Исключения:

SAXException - Любое исключение SAX, возможно, обернутое другим исключением.

См. также:

ContentHandler.startDocument()

endDocument

public void endDocument()
                 throws SAXException

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

endDocument в интерфейсе ContentHandler

Исключения:

SAXException - Любое исключение SAX, возможно, обернутое другим исключением.

См. также:

ContentHandler.endDocument()

startPrefixMapping

public void startPrefixMapping(String prefix,
                               String uri)
                        throws SAXException

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

startPrefixMapping в интерфейсе ContentHandler

Параметры:

prefix - Префикс пространства имен, который объявляется.

uri - URI пространства имен, сопоставленный с префиксом.

Исключения:

SAXException - Любое исключение SAX, возможно, обернутое другим исключением.

См. также:

ContentHandler.startPrefixMapping(java.lang.String, java.lang.String)

endPrefixMapping

public void endPrefixMapping(String prefix)
                      throws SAXException

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

endPrefixMapping в интерфейсе ContentHandler

Параметры:

prefix - Префикс пространства имен, который объявляется.

Исключения:

SAXException - Любое исключение SAX, возможно, обернутое другим исключением.

См. также:

ContentHandler.endPrefixMapping(java.lang.String)

startElement

public void startElement(String uri,
                         String localName,
                         String qName,
                         Attributes attributes)
                  throws SAXException

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

startElement в интерфейсе ContentHandler

Параметры:

uri - URI пространства имен или пустая строка, если у элемента нет URI пространства имен или если обработка пространства имен не выполняется.

localName - Местное имя (без префикса) или пустая строка, если обработка пространства имен не выполняется.

qName - Полное имя (с префиксом) или пустая строка, если полные имена недоступны.

attributes - Атрибуты, прикрепленные к элементу. Если атрибутов нет, это будет пустой объект Attributes.

Исключения:

SAXException - Любое исключение SAX, возможно, обернутое другим исключением.

См. также:

ContentHandler.startElement(java.lang.String, java.lang.String, java.lang.String, org.xml.sax.Attributes)

endElement

public void endElement(String uri,
                       String localName,
                       String qName)
                throws SAXException

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

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

Параметры:

uri - URI пространства имен или пустая строка, если у элемента нет URI пространства имен или если обработка пространства имен не выполняется.

localName - Местное имя (без префикса) или пустая строка, если обработка пространства имен не выполняется.

qName - Полное имя (с префиксом) или пустая строка, если полные имена недоступны.

Исключения:

SAXException - Любое исключение SAX, возможно, обернутое другим исключением.

См. также:

ContentHandler.endElement(java.lang.String, java.lang.String, java.lang.String)

characters

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

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

characters в интерфейсе ContentHandler

Параметры:

ch - Символы.

start - Начальная позиция в массиве символов.

length - Количество символов для использования из массива символов.

Исключения:

SAXException - Любое исключение SAX, возможно, обернутое другим исключением.

См. также:

ContentHandler.characters(char[], int, int)

ignorableWhitespace

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

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

ignorableWhitespace в интерфейсе ContentHandler

Параметры:

ch - Пробельные символы.

start - Начальная позиция в массиве символов.

length - Количество символов для использования из массива символов.

Исключения:

SAXException - Любое исключение SAX, возможно, обернутое другим исключением.

См. также:

ContentHandler.ignorableWhitespace(char[], int, int)

processingInstruction

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

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

processingInstruction в интерфейсе ContentHandler

Параметры:

target - Цель инструкции обработки.

data - Данные инструкции обработки, или null, если они не предоставлены.

Исключение:

SAXException - Любое исключение SAX, возможно, обертывающее другое исключение.

См. также:

ContentHandler.processingInstruction(java.lang.String, java.lang.String)

skippedEntity

public void skippedEntity(String name)
                   throws SAXException

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

skippedEntity в интерфейсе ContentHandler

Параметры:

name - Имя пропущенного элемента.

Исключение:

SAXException - Любое исключение SAX, возможно, обертывающее другое исключение.

См. также:

ContentHandler.processingInstruction(java.lang.String, java.lang.String)

warning

public void warning(SAXParseException e)
             throws SAXException

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

warning в интерфейсе ErrorHandler

Параметры:

e - Информация о предупреждении, закодированная как исключение.

Исключение:

SAXException - Любое исключение SAX, возможно, обертывающее другое исключение.

См. также:

ErrorHandler.warning(org.xml.sax.SAXParseException), SAXParseException

error

public void error(SAXParseException e)
           throws SAXException

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

error в интерфейсе ErrorHandler

Параметры:

e - Информация об ошибке, закодированная как исключение.

Исключение:

SAXException - Любое исключение SAX, возможно, обертывающее другое исключение.

См. также:

ErrorHandler.warning(org.xml.sax.SAXParseException), SAXParseException

fatalError

public void fatalError(SAXParseException e)
                throws SAXException

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

fatalError в интерфейсе ErrorHandler

Параметры:

e - Информация об ошибке, закодированная как исключение.

Исключение:

SAXException - Любое исключение SAX, возможно, обертывающее другое исключение.

См. также:

ErrorHandler.fatalError(org.xml.sax.SAXParseException), SAXParseException