Класс QXmlDefaultHandler

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

Заголовок:	#include <QXmlDefaultHandler>
qmake:	QT += xml
Наследуется от:	QXmlContentHandler, QXmlErrorHandler, QXmlDTDHandler, QXmlEntityResolver, QXmlLexicalHandler и 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() для выполнения некоторой финализации или проверки содержимого после полного прочтения документа.

См. также QXmlDTDHandler, QXmlDeclHandler, QXmlContentHandler, QXmlEntityResolver, QXmlErrorHandler, QXmlLexicalHandler и Введение в SAX2.

Документация по членам-функциям

QXmlDefaultHandler::QXmlDefaultHandler()

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