QAbstractItemModelTester Class

Detaillierte Beschreibung

Die Klasse QAbstractItemModelTester ist eine Utility-Klasse zum Testen von Item-Modellen.

Bei der Implementierung eines Elementmodells (d.h. einer konkreten QAbstractItemModel Unterklasse) müssen sehr strenge Regeln beachtet werden, die die Konsistenz für die Benutzer des Modells (Ansichten, Proxy-Modelle usw.) sicherstellen.

Zum Beispiel muss die Neuimplementierung eines Modells von hasChildren() für einen bestimmten Index mit den von rowCount() und columnCount() zurückgegebenen Werten übereinstimmen.

QAbstractItemModelTester hilft dabei, die häufigsten Fehler in benutzerdefinierten Elementmodellklassen zu finden. Durch die Durchführung einer Reihe von Tests wird versucht zu überprüfen, ob der Status des Modells zu jeder Zeit konsistent ist. Die Tests werden jedes Mal automatisch wiederholt, wenn das Modell geändert wird.

QAbstractItemModelTester führt nicht-destruktive Tests durch, die typischerweise darin bestehen, Daten und Metadaten aus einem gegebenen Elementmodell auszulesen. QAbstractItemModelTester versucht auch illegale Modifikationen des Modells. In Modellen, die ordnungsgemäß implementiert sind, sollten solche Versuche zurückgewiesen werden, und es sollten infolgedessen keine Daten geändert werden.

Verwendung

Die Verwendung von QAbstractItemModelTester ist sehr einfach. In einem Testfall reicht es aus, eine Instanz zu erzeugen und das zu testende Modell an den Konstruktor zu übergeben:

MyModel *modelToBeTested = ...;
auto tester = new QAbstractItemModelTester(modelToBeTested);

QAbstractItemModelTester meldet Testfehler über die Qt Test Logging-Mechanismen.

Es ist auch möglich, QAbstractItemModelTester außerhalb eines Testfalls zu verwenden. So kann es beispielsweise nützlich sein, ein von einer Anwendung verwendetes Elementmodell zu testen, ohne dass ein expliziter Unit-Test für ein solches Modell erstellt werden muss (was eine Herausforderung darstellen könnte). Um QAbstractItemModelTester außerhalb eines Testfalls zu verwenden, übergeben Sie einen der QAbstractItemModelTester::FailureReportingMode Enumeratoren an seinen Konstruktor und legen damit fest, wie Fehler protokolliert werden sollen.

QAbstractItemModelTester kann auch zusätzliche Debugging-Informationen als Logging-Meldungen unter der Kategorie qt.modeltest logging ausgeben. Dieses Debugging ist standardmäßig deaktiviert; lesen Sie in der QLoggingCategory Dokumentation nach, wie Sie es aktivieren können.