compact2, compact3

org.xml.sax.ext

Класс DefaultHandler2

java.lang. Объект

org.xml.sax.helpers. DefaultHandler

org.xml.sax.ext. DefaultHandler2

Все Реализованные Интерфейсы:

ContentHandler, DTDHandler, EntityResolver, ErrorHandler, DeclHandler, EntityResolver2, LexicalHandler

public class DefaultHandler2
extends DefaultHandler
implements LexicalHandler, DeclHandler, EntityResolver2

Этот class расширяет обработчик основы SAX2 class, чтобы поддерживать SAX2 LexicalHandler, DeclHandler, и EntityResolver2 расширения. За исключением переопределения оригинала SAX1 resolveEntity() метод добавленные методы обработчика только возвращается. Подклассификаторы могут переопределить все на основе метода методом.

Этот модуль, и исходный код и документация, находится в Общедоступном Домене, и прибывает без ГАРАНТИИ.

Отметьте: этот class мог бы все же узнать, что ContentHandler.setDocumentLocator () вызов можно было бы передать a Locator2 объект, и что ContentHandler.startElement () вызов можно было бы передать a Attributes2 объект.

С тех пор:

SAX 2.0 (расширения 1.1 альфы)

Сводка конструктора

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

Конструктор и Описание
DefaultHandler2() Создает обработчик, который игнорирует все события парсинга.

Сводка метода

Модификатор и Тип	Метод и Описание
void	attributeDecl(String eName, String aName, String type, String mode, String value) Сообщите об описании типа атрибута.
void	comment(char[] ch, int start, int length) Сообщите о XML-комментарии где угодно в документе.
void	elementDecl(String name, String model) Сообщите об описании типа элемента.
void	endCDATA() Сообщите о конце раздела CDATA.
void	endDTD() Сообщите о конце объявлений DTD.
void	endEntity(String name) Сообщите о конце объекта.
void	externalEntityDecl(String name, String publicId, String systemId) Сообщите о проанализированном внешнем объявлении объекта.
InputSource	getExternalSubset(String name, String baseURI) Говорит синтаксическому анализатору, что, если никакое внешнее подмножество не было объявлено в тексте документа, ни один не должен использоваться.
void	internalEntityDecl(String name, String value) Сообщите о внутреннем объявлении объекта.
InputSource	resolveEntity(String publicId, String systemId) Вызывает EntityResolver2.resolveEntity() с нулевым объектом называют и основной URI.
InputSource	resolveEntity(String name, String publicId, String baseURI, String systemId) Говорит синтаксическому анализатору разрешать systemId против baseURI и читать текст объекта из того получающегося абсолютного URI.
void	startCDATA() Сообщите о запуске раздела CDATA.
void	startDTD(String name, String publicId, String systemId) Сообщите о запуске объявлений DTD, если любой.
void	startEntity(String name) Сообщите о начале некоторых внутренних и внешних объектов XML.

Методы, наследованные от class org.xml.sax.helpers. DefaultHandler

characters, endDocument, endElement, endPrefixMapping, error, fatalError, ignorableWhitespace, notationDecl, processingInstruction, setDocumentLocator, skippedEntity, startDocument, startElement, startPrefixMapping, unparsedEntityDecl, warning

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

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

Деталь конструктора

DefaultHandler2

public DefaultHandler2()

Создает обработчик, который игнорирует все события парсинга.

Деталь метода

startCDATA

public void startCDATA()
                throws SAXException

Описание скопировало с интерфейса: LexicalHandler

Сообщите о запуске раздела CDATA.

О содержании раздела CDATA сообщат через постоянного клиента characters событие; это событие предназначается только, чтобы сообщить о границе.

Определенный:

startCDATA в интерфейсе LexicalHandler

Броски:

SAXException - Приложение может повысить исключение.

См. Также:

LexicalHandler.endCDATA()

endCDATA

public void endCDATA()
              throws SAXException

Описание скопировало с интерфейса: LexicalHandler

Сообщите о конце раздела CDATA.

Определенный:

endCDATA в интерфейсе LexicalHandler

Броски:

SAXException - Приложение может повысить исключение.

См. Также:

LexicalHandler.startCDATA()

startDTD

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

Описание скопировало с интерфейса: LexicalHandler

Сообщите о запуске объявлений DTD, если любой.

Этот метод предназначается, чтобы сообщить о начале объявления DOCTYPE; если у документа не будет никакого объявления DOCTYPE, то этот метод не будет вызван.

Все объявления, о которых сообщают через DTDHandler или DeclHandler события должны появиться между startDTD и endDTD события. Объявления, как предполагается, принадлежат внутреннему подмножеству DTD, если они не появляются между startEntity и endEntity события. О комментариях и инструкциях обработки от DTD нужно также сообщить между startDTD и endDTD событиями в их первоначальном заказе (логического) возникновения; они не обязаны появляться в их корректных расположениях относительно событий DTDHANDLER ИЛИ DECLHANDLER, как бы то ни было.

Отметьте, что start/endDTD события появятся в пределах start/endDocument событий от ContentHandler и перед первым startElement событие.

Определенный:

startDTD в интерфейсе LexicalHandler

Параметры:

name - Имя типа документа.

publicId - Объявленный общедоступный идентификатор для внешнего подмножества DTD, или нуль, если ни один не был объявлен.

systemId - Объявленный системный идентификатор для внешнего подмножества DTD, или нуль, если ни один не был объявлен. (Отметьте, что это не разрешается против URI основы документа.)

Броски:

SAXException - Приложение может повысить исключение.

См. Также:

LexicalHandler.endDTD(), LexicalHandler.startEntity(java.lang.String)

endDTD

public void endDTD()
            throws SAXException

Описание скопировало с интерфейса: LexicalHandler

Сообщите о конце объявлений DTD.

Этот метод предназначается, чтобы сообщить о конце объявления DOCTYPE; если у документа не будет никакого объявления DOCTYPE, то этот метод не будет вызван.

Определенный:

endDTD в интерфейсе LexicalHandler

Броски:

SAXException - Приложение может повысить исключение.

См. Также:

LexicalHandler.startDTD(java.lang.String, java.lang.String, java.lang.String)

startEntity

public void startEntity(String name)
                 throws SAXException

Описание скопировало с интерфейса: LexicalHandler

Сообщите о начале некоторых внутренних и внешних объектов XML.

Создание отчетов объектов параметра (включая внешнее подмножество DTD) является дополнительными, и драйверами SAX2, которые сообщают, что события LexicalHandler, возможно, не реализуют это; можно использовать http://xml.org/sax/features/lexical-handler/parameter-entities функция, чтобы запросить или управлять созданием отчетов объектов параметра.

Об общих объектах сообщают с их регулярными именами, объектам параметра предварительно ожидали '%' к их именам, и у внешнего подмножества DTD есть имя псевдообъекта" [дата]".

Когда драйвер SAX2 обеспечивает эти события, все другие события должны быть должным образом вложены в пределах, запускают/заканчиваются события объекта. Нет никакого дополнительного требования этого события от DeclHandler или DTDHandler должным образом упорядочить.

Отметьте, что о пропущенных объектах сообщат через skippedEntity событие, которое является частью интерфейса ContentHandler.

Из-за модели событий потоковой передачи, которую использует SAX, о некоторых границах объекта нельзя сообщить ни при каких обстоятельствах:

• общие объекты в пределах значений атрибута
• объекты параметра в пределах объявлений

Они будут тихо расширены без индикации относительно того, где исходные границы объекта были.

Отметьте также, что о границах символьных ссылок (которые не являются действительно объектами так или иначе) не сообщают.

Все start/endEntity события должны быть должным образом вложены.

Определенный:

startEntity в интерфейсе LexicalHandler

Параметры:

name - Имя объекта. Если это будет объект параметра, то имя начнется 'с %', и если это будет внешнее подмножество DTD, то это будет" [дата]".

Броски:

SAXException - Приложение может повысить исключение.

См. Также:

LexicalHandler.endEntity(java.lang.String), DeclHandler.internalEntityDecl(java.lang.String, java.lang.String), DeclHandler.externalEntityDecl(java.lang.String, java.lang.String, java.lang.String)

endEntity

public void endEntity(String name)
               throws SAXException

Описание скопировало с интерфейса: LexicalHandler

Сообщите о конце объекта.

Определенный:

endEntity в интерфейсе LexicalHandler

Параметры:

name - Имя объекта, который заканчивается.

Броски:

SAXException - Приложение может повысить исключение.

См. Также:

LexicalHandler.startEntity(java.lang.String)

комментарий

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

Описание скопировало с интерфейса: LexicalHandler

Сообщите о XML-комментарии где угодно в документе.

Этот обратный вызов будет использоваться для комментариев внутри или снаружи элемента документа, включая комментарии во внешнем подмножестве DTD (если считано). Комментарии в DTD должны быть должным образом вложены внутри start/endDTD и start/endEntity события (если использующийся).

Определенный:

comment в интерфейсе LexicalHandler

Параметры:

ch - Массив, содержащий символы в комментарии.

start - Стартовая позиция в массиве.

length - Число символов, чтобы использовать от массива.

Броски:

SAXException - Приложение может повысить исключение.

attributeDecl

public void attributeDecl(String eName,
                          String aName,
                          String type,
                          String mode,
                          String value)
                   throws SAXException

Описание скопировало с интерфейса: DeclHandler

Сообщите об описании типа атрибута.

Только об эффективном (первом) объявлении для атрибута сообщат. Тип будет одной из строк "CDATA", "ID", "IDREF", "IDREFS", "NMTOKEN", "NMTOKENS", "ОБЪЕКТ", "ОБЪЕКТЫ", заключенная в скобки маркерная группа с разделителем "|" и весь пробел, удаленный, или слово "НОТАЦИЯ", сопровождаемая пространством, сопровождаемым заключенной в скобки маркерной группой со всем удаленным пробелом.

Значение будет значением как сообщающийся приложениям, соответственно нормализованным и с объектом и символьными расширенными ссылками.

Определенный:

attributeDecl в интерфейсе DeclHandler

Параметры:

eName - Имя связанного элемента.

aName - Имя атрибута.

type - Строка, представляющая тип атрибута.

mode - Строка, представляющая атрибут, принимающий значение по умолчанию режим ("#IMPLIED", "#REQUIRED", или "#FIXED") или нуль, если ни один из них не применяется.

value - Строка, представляющая значение по умолчанию атрибута, или нуль, если нет ни одного.

Броски:

SAXException - Приложение может повысить исключение.

elementDecl

public void elementDecl(String name,
                        String model)
                 throws SAXException

Описание скопировало с интерфейса: DeclHandler

Сообщите об описании типа элемента.

Модель контента будет состоять из "ПУСТОЙ" строки, строка "ЛЮБОЙ", или заключенная в скобки группа, дополнительно сопровождаемая индикатором возникновения. Модель будет нормализована так, чтобы все объекты параметра были полностью разрешены, и весь пробел удаляется, и будет включать круглые скобки включения. Другая нормализация (такая как раскрытие избыточных скобок или упрощение индикаторов возникновения) на усмотрение синтаксического анализатора.

Определенный:

elementDecl в интерфейсе DeclHandler

Параметры:

name - Имя типа элемента.

model - Модель контента как нормализованная строка.

Броски:

SAXException - Приложение может повысить исключение.

externalEntityDecl

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

Описание скопировало с интерфейса: DeclHandler

Сообщите о проанализированном внешнем объявлении объекта.

Только об эффективном (первом) объявлении для каждого объекта сообщат.

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

Определенный:

externalEntityDecl в интерфейсе DeclHandler

Параметры:

name - Имя объекта. Если это будет объект параметра, то имя начнется 'с %'.

publicId - Общедоступный идентификатор объекта, или нуль, если ни один не был дан.

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

Броски:

SAXException - Приложение может повысить исключение.

См. Также:

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

internalEntityDecl

public void internalEntityDecl(String name,
                               String value)
                        throws SAXException

Описание скопировало с интерфейса: DeclHandler

Сообщите о внутреннем объявлении объекта.

Только об эффективном (первом) объявлении для каждого объекта сообщат. Все объекты параметра в значении будут расширены, но общие объекты не будут.

Определенный:

internalEntityDecl в интерфейсе DeclHandler

Параметры:

name - Имя объекта. Если это будет объект параметра, то имя начнется 'с %'.

value - Заменяющий текст объекта.

Броски:

SAXException - Приложение может повысить исключение.

См. Также:

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

getExternalSubset

public InputSource getExternalSubset(String name,
                                     String baseURI)
                              throws SAXException,
                                     IOException

Говорит синтаксическому анализатору, что, если никакое внешнее подмножество не было объявлено в тексте документа, ни один не должен использоваться.

Определенный:

getExternalSubset в интерфейсе EntityResolver2

Параметры:

name - Идентифицирует корневой элемент документа. Это название происходит от объявления DOCTYPE (где доступный) или от фактического корневого элемента.

baseURI - Основной URI документа, служа дополнительной подсказкой для того, чтобы выбрать внешнее подмножество. Это всегда - абсолютный URI, если это не нуль, потому что XMLReader дали InputSource без одного.

Возвраты:

Описание объекта InputSource нового внешнего подмножества, которое будет использоваться синтаксическим анализатором, или нулем, чтобы указать, что никакое внешнее подмножество не обеспечивается.

Броски:

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

IOException - Вероятно, указывая на отказ создать новый InputStream или Читателя, или недопустимый URL.

resolveEntity

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

Говорит синтаксическому анализатору разрешать systemId против baseURI и читать текст объекта из того получающегося абсолютного URI. Отметьте это потому что более старое DefaultHandler.resolveEntity(), метод переопределяется, чтобы вызвать этого, этот метод может иногда вызываться с нулевым именем и baseURI, и с systemId, уже абсолютизируемым.

Определенный:

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

Параметры:

name - Идентифицирует внешний разрешаемый объект. Или" [дата]" для внешнего подмножества, или имя, начинающее с "%" указать на объект параметра, или иначе имя общего объекта. Это никогда не нуль когда вызвано синтаксическим анализатором SAX2.

publicId - Общедоступный идентификатор внешнего ссылаемого объекта (нормализованный как требуется спецификацией XML), или нуль, если ни один не был предоставлен.

baseURI - URI, относительно которого интерпретируются относительные systemIDs. Это всегда - абсолютный URI, если это не нуль (вероятно, потому что XMLReader дали InputSource без одного). Этот URI определяется спецификацией XML, чтобы быть тем, связанным с" <" запуск соответствующего объявления.

systemId - Системный идентификатор внешнего ссылаемого объекта; или относительный или абсолютный URI. Это никогда не нуль когда вызвано синтаксическим анализатором SAX2; только объявленные объекты, и любое внешнее подмножество, разрешаются такими синтаксическими анализаторами.

Возвраты:

Объект InputSource описание нового входного источника, который будет использоваться синтаксическим анализатором. Возврат нуля направляет синтаксический анализатор, чтобы разрешить системный ID против основного URI и открыть соединение с получающимся URI.

Броски:

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

IOException - Вероятно, указывая на отказ создать новый InputStream или Читателя, или недопустимый URL.

resolveEntity

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

Вызывает EntityResolver2.resolveEntity() с нулевым объектом называют и основной URI. Вы только должны переопределить тот метод, чтобы использовать этот class.

Определенный:

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

Переопределения:

resolveEntity в class DefaultHandler

Параметры:

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

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

Возвраты:

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

Броски:

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

IOException - Специфичное для Java исключение IO, возможно результат создания нового InputStream или Читателя для InputSource.

См. Также:

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