Класс 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.