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 d'une sous-classe concrète de ` QAbstractItemModel `), il est nécessaire de respecter un ensemble de règles très strictes garantissant la cohérence pour les utilisateurs du modèle (vues, modèles proxy, etc.).

Par exemple, pour un index donné, la réimplémentation par un modèle de la méthode ` hasChildren()` 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 tente de vérifier que l’état du modèle reste cohérent à tout moment. Les tests sont répétés automatiquement à chaque modification du modèle.

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 tentera également d’effectuer des modifications illégales du modèle. Dans les modèles correctement implémentés, ces tentatives devraient être rejetées et aucune donnée ne devrait être modifiée en conséquence.

Utilisation

L’utilisation de `QAbstractItemModelTester` est simple. Dans un cas 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 de test via les mécanismes de journalisation d’ Qt Test.

Il est également possible d’utiliser QAbstractItemModelTester en dehors d’un cas de test. Par exemple, cela peut s’avérer utile pour tester un modèle d’élément utilisé par une application sans avoir à créer un test unitaire explicite pour ce modèle (ce qui pourrait s’avérer complexe). Pour utiliser QAbstractItemModelTester en dehors d’un cas de test, transmettez l’un des énumérateurs de la catégorie « QAbstractItemModelTester::FailureReportingMode » à son constructeur, précisant ainsi comment les échecs doivent être consignés.

QAbstractItemModelTester peut également signaler des informations de débogage supplémentaires sous forme de messages de journalisation dans la catégorie « qt.modeltest ». Cette journalisation de débogage est désactivée par défaut ; consultez la documentation d’ QLoggingCategory pour savoir comment l’activer.