QAbstractItemModelTester Class

Description détaillée

La classe QAbstractItemModelTester est une classe utilitaire permettant de tester les modèles d'éléments.

Lors de l'implémentation d'un modèle d'élément (c'est-à-dire une sous-classe concrète de QAbstractItemModel ), il faut respecter un ensemble de règles très strictes qui garantissent la cohérence pour les utilisateurs du modèle (vues, modèles proxy, etc.).

Par exemple, pour un index donné, la réimplémentation de hasChildren() par un modèle doit être cohérente avec les valeurs renvoyées par rowCount() et columnCount().

QAbstractItemModelTester permet de détecter les erreurs les plus courantes dans les classes de modèles d'éléments personnalisés. En effectuant une série de tests, il essaiera de vérifier que l'état du modèle est cohérent à tout moment. Les tests seront répétés automatiquement chaque fois que le modèle sera modifié.

QAbstractItemModelTester utilise des tests non destructifs, qui consistent généralement à lire les données et les métadonnées d'un modèle d'élément donné. QAbstractItemModelTester tente également d'effectuer des modifications illégales du modèle. Dans les modèles correctement implémentés, de telles tentatives devraient être rejetées, et aucune donnée ne devrait être modifiée en conséquence.

Utilisation de QAbstractItemModelTester

L'utilisation de QAbstractItemModelTester est simple. Dans un scénario de test, il suffit de créer une instance, en passant le modèle à tester au constructeur :

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

QAbstractItemModelTester signalera les échecs des tests par le biais des mécanismes de journalisation de Qt Test.

Il est également possible d'utiliser QAbstractItemModelTester en dehors d'un cas de test. Par exemple, il peut être utile de tester un modèle d'élément utilisé par une application sans avoir à construire un test unitaire explicite pour un tel modèle (ce qui peut être difficile). Pour utiliser QAbstractItemModelTester en dehors d'un scénario de test, il faut passer l'un des énumérateurs QAbstractItemModelTester::FailureReportingMode à son constructeur, ce qui permet de spécifier comment les échecs doivent être enregistrés.

QAbstractItemModelTester peut également rapporter des informations de débogage supplémentaires sous forme de messages de journalisation dans la catégorie qt.modeltest logging. Cette journalisation de débogage est désactivée par défaut ; reportez-vous à la documentation de QLoggingCategory pour savoir comment l'activer.