Класс QXmlDefaultHandler

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

Заголовок:	#include <QXmlDefaultHandler>
CMake:	find_package(Qt6 COMPONENTS Core5Compat REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Core5Compat)
qmake:	QT += core5compat
Наследуется от:	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) override
virtual bool	characters(const QString &ch) override
virtual bool	comment(const QString &ch) override
virtual bool	endCDATA() override
virtual bool	endDTD() override
virtual bool	endDocument() override
virtual bool	endElement(const QString &namespaceURI, const QString &localName, const QString &qName) override
virtual bool	endEntity(const QString &name) override
virtual bool	endPrefixMapping(const QString &prefix) override
virtual bool	error(const QXmlParseException &exception) override
virtual QString	errorString() const override
virtual bool	externalEntityDecl(const QString &name, const QString &publicId, const QString &systemId) override
virtual bool	fatalError(const QXmlParseException &exception) override
virtual bool	ignorableWhitespace(const QString &ch) override
virtual bool	internalEntityDecl(const QString &name, const QString &value) override
virtual bool	notationDecl(const QString &name, const QString &publicId, const QString &systemId) override
virtual bool	processingInstruction(const QString &target, const QString &data) override
virtual bool	resolveEntity(const QString &publicId, const QString &systemId, QXmlInputSource &ret*) override
virtual void	setDocumentLocator(QXmlLocator *locator) override
virtual bool	skippedEntity(const QString &name) override
virtual bool	startCDATA() override
virtual bool	startDTD(const QString &name, const QString &publicId, const QString &systemId) override
virtual bool	startDocument() override
virtual bool	startElement(const QString &namespaceURI, const QString &localName, const QString &qName, const QXmlAttributes &atts) override
virtual bool	startEntity(const QString &name) override
virtual bool	startPrefixMapping(const QString &prefix, const QString &uri) override
virtual bool	unparsedEntityDecl(const QString &name, const QString &publicId, const QString &systemId, const QString &notationName) override
virtual bool	warning(const QXmlParseException &exception) override

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

Этот класс объединяет возможности специализированных классов обработчиков, что делает его удобной отправной точкой при реализации пользовательских обработчиков для подклассов 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.

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

QXmlDefaultHandler::QXmlDefaultHandler()

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

`[virtual]` QXmlDefaultHandler::~QXmlDefaultHandler()

Уничтожает обработчик.

`[override virtual]` bool QXmlDefaultHandler::attributeDecl(const QString &eName, const QString &aName, const QString &type, const QString &valueDefault, const QString &value)

Переопределяет: QXmlDeclHandler::attributeDecl(const QString &eName, const QString &aName, const QString &type, const QString &valueDefault, const QString &value).