QXmlDefaultHandler Class

La classe QXmlDefaultHandler fournit une implémentation par défaut de toutes les classes de gestionnaires XML. Plus d'informations...

En-tête :	`#include <QXmlDefaultHandler>`
CMake :	`find_package(Qt6 REQUIRED COMPONENTS Core5Compat)` `target_link_libraries(mytarget PRIVATE Qt6::Core5Compat)`
qmake :	`QT += core5compat`
Hérite :	QXmlContentHandler, QXmlErrorHandler, QXmlDTDHandler, QXmlEntityResolver, QXmlLexicalHandler, et QXmlDeclHandler

Liste de tous les membres, y compris les membres hérités

Remarque : toutes les fonctions de cette classe sont réentrantes.

Fonctions publiques

	QXmlDefaultHandler()
virtual	~QXmlDefaultHandler()

Fonctions publiques réimplémentées

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

Description détaillée

Cette classe rassemble les caractéristiques des classes de gestionnaires spécialisés, ce qui en fait un point de départ pratique pour l'implémentation de gestionnaires personnalisés pour les sous-classes de QXmlReader, en particulier QXmlSimpleReader. Les fonctions virtuelles de chacune des classes de base sont réimplémentées dans cette classe, ce qui permet d'obtenir un comportement par défaut judicieux dans de nombreux cas courants. En sous-classant cette classe et en surchargeant ces fonctions, vous pouvez vous concentrer sur l'implémentation des parties du gestionnaire pertinentes pour votre application.

Le lecteur XML doit savoir quel gestionnaire utiliser pour les différents types d'événements au cours de l'analyse syntaxique. Cela signifie que, bien que QXmlDefaultHandler fournisse des implémentations par défaut de fonctions héritées de toutes ses classes de base, nous pouvons toujours utiliser des gestionnaires spécialisés pour des types d'événements particuliers.

Par exemple, QXmlDefaultHandler sous-classe à la fois QXmlContentHandler et QXmlErrorHandler, de sorte qu'en le sous-classant, nous pouvons utiliser le même gestionnaire pour les deux fonctions de lecture suivantes :

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

Étant donné que le lecteur informe le gestionnaire des erreurs d'analyse, il est nécessaire de réimplémenter QXmlErrorHandler::fatalError() si, par exemple, nous voulons arrêter l'analyse lorsqu'une telle erreur se produit :

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

La fonction ci-dessus renvoie false, ce qui indique au lecteur d'arrêter l'analyse. Pour continuer à utiliser le même lecteur, il est nécessaire de créer une nouvelle instance de gestionnaire et de configurer le lecteur pour qu'il l'utilise de la manière décrite ci-dessus.

Il est utile d'examiner certaines des fonctions héritées de QXmlDefaultHandler et de se demander pourquoi elles pourraient être réimplémentées dans un gestionnaire personnalisé. Les gestionnaires personnalisés réimplémentent généralement QXmlContentHandler::startDocument() pour préparer le gestionnaire à un nouveau contenu. Les éléments du document et le texte qu'ils contiennent peuvent être traités en réimplémentant QXmlContentHandler::startElement(), QXmlContentHandler::endElement() et QXmlContentHandler::characters(). Vous souhaiterez peut-être réimplémenter QXmlContentHandler::endDocument() pour effectuer une finalisation ou une validation du contenu une fois que le document a été entièrement lu.

Voir aussi QXmlDTDHandler, QXmlDeclHandler, QXmlContentHandler, QXmlEntityResolver, QXmlErrorHandler, et QXmlLexicalHandler.

Documentation des fonctions membres

QXmlDefaultHandler::QXmlDefaultHandler()

Construit un gestionnaire à utiliser avec les sous-classes de QXmlReader.

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

Détruit le gestionnaire.

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

Réimplémente : QXmlDeclHandler::attributeDecl(const QString &eName, const QString &aName, const QString &type, const QString &valueDefault, const QString &value).