QXmlDefaultHandler Class

Die Klasse „QXmlDefaultHandler“ bietet eine Standardimplementierung aller XML-Handler-Klassen. Mehr...

Kopfzeile:	`#include <QXmlDefaultHandler>`

CMake:	`find_package(Qt6 REQUIRED COMPONENTS Core5Compat)` `target_link_libraries(mytarget PRIVATE Qt6::Core5Compat)`
qmake:	`QT += core5compat`
Erbt von:	QXmlContentHandler, „ QXmlErrorHandler “, „ QXmlDTDHandler “, „ QXmlEntityResolver “, „ QXmlLexicalHandler “ und QXmlDeclHandler

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Hinweis: Alle Funktionen dieser Klasse sind reentrant.

Öffentliche Funktionen

	QXmlDefaultHandler()
virtual	~QXmlDefaultHandler()

Neu implementierte öffentliche Funktionen

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

Ausführliche Beschreibung

Diese Klasse vereint die Funktionen der spezialisierten Handler-Klassen und dient somit als praktischer Ausgangspunkt für die Implementierung benutzerdefinierter Handler für Unterklassen von ` QXmlReader`, insbesondere von ` QXmlSimpleReader`. Die virtuellen Funktionen der jeweiligen Basisklassen werden in dieser Klasse neu implementiert und bieten ein sinnvolles Standardverhalten für viele gängige Fälle. Indem Sie diese Klasse untervererben und diese Funktionen überschreiben, können Sie sich auf die Implementierung der für Ihre Anwendung relevanten Teile des Handlers konzentrieren.

Dem XML-Reader muss mitgeteilt werden, welcher Handler für verschiedene Arten von Ereignissen während der Analyse verwendet werden soll. Das bedeutet, dass wir, obwohl `QXmlDefaultHandler` Standardimplementierungen der von allen Basisklassen geerbten Funktionen bereitstellt, dennoch spezialisierte Handler für bestimmte Arten von Ereignissen verwenden können.

Beispielsweise ist `QXmlDefaultHandler` sowohl eine Unterklasse von ` QXmlContentHandler ` als auch von ` QXmlErrorHandler`. Durch die Erstellung einer Unterklasse davon können wir daher denselben Handler für die beiden folgenden Reader-Funktionen verwenden:

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

Da der Reader den Handler über Parsing-Fehler informiert, ist es notwendig, ` QXmlErrorHandler::fatalError()` neu zu implementieren, wenn wir beispielsweise das Parsing beenden möchten, sobald ein solcher Fehler auftritt:

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

    return false;
}

Die obige Funktion gibt ` false` zurück, was dem Reader signalisiert, das Parsen zu beenden. Um denselben Reader weiterhin zu verwenden, muss eine neue Handler-Instanz erstellt und der Reader so konfiguriert werden, dass er diese wie oben beschrieben nutzt.

Es ist hilfreich, einige der von `QXmlDefaultHandler` geerbten Funktionen zu untersuchen und zu überlegen, warum sie in einem benutzerdefinierten Handler neu implementiert werden könnten. Benutzerdefinierte Handler implementieren in der Regel ` QXmlContentHandler::startDocument()` neu, um den Handler auf neue Inhalte vorzubereiten. Dokumentelemente und der darin enthaltene Text können durch die Neuimplementierung von ` QXmlContentHandler::startElement()`, ` QXmlContentHandler::endElement()` und ` QXmlContentHandler::characters()` verarbeitet werden. Möglicherweise möchten Sie ` QXmlContentHandler::endDocument()` neu implementieren, um nach dem vollständigen Einlesen des Dokuments abschließende Maßnahmen oder eine Validierung des Inhalts durchzuführen.

Siehe auch QXmlDTDHandler, QXmlDeclHandler, QXmlContentHandler, QXmlEntityResolver, QXmlErrorHandler und QXmlLexicalHandler.

Dokumentation zu Member-Funktionen

QXmlDefaultHandler::QXmlDefaultHandler()

Erstellt einen Handler zur Verwendung mit Unterklassen von ` QXmlReader`.

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

Löscht den Handler.

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

Implementiert neu: ` QXmlDeclHandler::attributeDecl` (`const QString &eName, const QString &aName, const QString &type, const QString &valueDefault, const QString &value`).