Описание класса QXmlDefaultHandler
[модуль QtXml]

Класс QXmlDefaultHandler обеспечивает реализацию по умолчанию всех классов-обработчиков XML. Далее...

 #include <QXmlDefaultHandler>

Этот класс не является частью Выпуска GUI Framework Qt.

Inherits QXmlContentHandler, QXmlErrorHandler, QXmlDTDHandler, QXmlEntityResolver, QXmlLexicalHandler, and QXmlDeclHandler.

Замечание: Все функции в этом классе реентерабельны.

Список всех членов, включая унаследованные

Открытые функции

	QXmlDefaultHandler ()
virtual	~QXmlDefaultHandler ()

Вновь реализованные открытые функции

virtual bool	attributeDecl ( const QString & eName, const QString & aName, const QString & type, const QString & valueDefault, const QString & value )
virtual bool	characters ( const QString & ch )
virtual bool	comment ( const QString & ch )
virtual bool	endCDATA ()
virtual bool	endDTD ()
virtual bool	endDocument ()
virtual bool	endElement ( const QString & namespaceURI, const QString & localName, const QString & qName )
virtual bool	endEntity ( const QString & name )
virtual bool	endPrefixMapping ( const QString & prefix )
virtual bool	error ( const QXmlParseException & exception )
virtual QString	errorString () const
virtual bool	externalEntityDecl ( const QString & name, const QString & publicId, const QString & systemId )
virtual bool	fatalError ( const QXmlParseException & exception )
virtual bool	ignorableWhitespace ( const QString & ch )
virtual bool	internalEntityDecl ( const QString & name, const QString & value )
virtual bool	notationDecl ( const QString & name, const QString & publicId, const QString & systemId )
virtual bool	processingInstruction ( const QString & target, const QString & data )
virtual bool	resolveEntity ( const QString & publicId, const QString & systemId, QXmlInputSource & ret* )
virtual void	setDocumentLocator ( QXmlLocator * locator )
virtual bool	skippedEntity ( const QString & name )
virtual bool	startCDATA ()
virtual bool	startDTD ( const QString & name, const QString & publicId, const QString & systemId )
virtual bool	startDocument ()
virtual bool	startElement ( const QString & namespaceURI, const QString & localName, const QString & qName, const QXmlAttributes & atts )
virtual bool	startEntity ( const QString & name )
virtual bool	startPrefixMapping ( const QString & prefix, const QString & uri )
virtual bool	unparsedEntityDecl ( const QString & name, const QString & publicId, const QString & systemId, const QString & notationName )
virtual bool	warning ( const QXmlParseException & exception )

12 открытых функций, унаследованных от QXmlContentHandler
4 открытые функции, унаследованные от QXmlErrorHandler
3 открытые функции, унаследованные от QXmlDTDHandler
2 открытые функции, унаследованные от QXmlEntityResolver
8 открытых функций, унаследованных от QXmlLexicalHandler
4 открытые функции, унаследованные от QXmlDeclHandler

Подробное описание

Класс QXmlDefaultHandler обеспечивает реализацию по умолчанию всех классов-обработчиков XML.

Этот класс объединяет черты специализированных классов обработки, что делает его удобным отправным пунктом при реализации пользовательских обработчиков для подклассов QXmlReader, в частности, QXmlSimpleReader. Виртуальные функции каждого из базовых классов переопределены в этом классе, обеспечивая разумное поведение по умолчанию для многих случаев. Наследуя от этого класса и перегружая его функции, вы можете сконцентрироваться на изменении поведения тех частей обработчика, которые вам необходимы.

Читатель XML должен сообщать обработчику о событиях, которые случаются в процессе анализа. Это означает, что, хоть QXmlDefaultHandler и обеспечивает реализации по умолчанию для унаследованных от всех базовых классов функций, мы можем использовать специализированные обработчики для отдельных видов событий.

Например, QXmlDefaultHandler наследует от QXmlContentHandler и QXmlErrorHandler, и мы можем использовать одинаковые обработчики для обоих функций чтения:

     xmlReader.setContentHandler(handler);
     xmlReader.setErrorHandler(handler);

Поскольку читатель будет информировать обработчик об ошибках чтения, необходимо переопределить QXmlErrorHandler::fatalError(), если, например, мы хотим останавливать анализ при возникновении ошибок:

 bool Handler::fatalError (const QXmlParseException & exception)
 {
     qWarning() << "Fatal error on line" << exception.lineNumber()
                << ", column" << exception.columnNumber() << ":"
                << exception.message();

     return false;
 }

Функция выше возвращает false, что приводит к остановке анализа. Чтобы продолжать использовать тот же читатель, необходимо создать новый обработчик и установить читатель описанным выше способом.

Это полезно при изучении функций, унаследованных от QXmlDefaultHandler, а также при рассмотрении вопроса, почему они могут быть переопределены в пользовательском обработчике. Свои обработчики будут обычно переопределять QXmlContentHandler::startDocument() для подготовки обработчика к новому содержимому. Обработка элементов документа и текста в них может быть переопределена с помощью QXmlContentHandler::startElement(), QXmlContentHandler::endElement() и QXmlContentHandler::characters(). Вы можете захотеть переопределить QXmlContentHandler::endDocument() для совершения некоторых действий по завершению или для проверки содержимого после окончания чтения.

Описание функций-членов

QXmlDefaultHandler::QXmlDefaultHandler ()

Создаёт обработчик для использования в подклассах QXmlReader.