QAbstractItemModelTester Class

Descripción Detallada

La clase QAbstractItemModelTester es una clase de utilidad para probar modelos de elementos.

Cuando se implementa un modelo de ítem (es decir, una subclase concreta de QAbstractItemModel ) hay que atenerse a un conjunto muy estricto de reglas que garantizan la coherencia para los usuarios del modelo (vistas, modelos proxy, etc.).

Por ejemplo, para un índice determinado, la reimplementación de hasChildren() en un modelo debe ser coherente con los valores devueltos por rowCount() y columnCount().

QAbstractItemModelTester ayuda a detectar los errores más comunes en las clases de modelos de elementos personalizados. Realizando una serie de pruebas, intentará comprobar que el estado del modelo es consistente en todo momento. Las pruebas se repetirán automáticamente cada vez que se modifique el modelo.

QAbstractItemModelTester emplea pruebas no destructivas, que suelen consistir en la lectura de datos y metadatos de un modelo de ítem dado. QAbstractItemModelTester también intentará modificaciones ilegales del modelo. En los modelos que están correctamente implementados, tales intentos deben ser rechazados, y ningún dato debe ser cambiado como consecuencia.

Uso

El uso de QAbstractItemModelTester es sencillo. En un caso de prueba es suficiente para crear una instancia, pasando el modelo que necesita ser probado al constructor:

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

QAbstractItemModelTester informará de los fallos en las pruebas a través de los mecanismos de registro de Qt Test.

También es posible utilizar QAbstractItemModelTester fuera de un caso de prueba. Por ejemplo, puede ser útil para probar un modelo de elemento utilizado por una aplicación sin necesidad de construir una prueba unitaria explícita para dicho modelo (lo que podría ser un reto). Para utilizar QAbstractItemModelTester fuera de un caso de prueba, pase uno de los enumeradores QAbstractItemModelTester::FailureReportingMode a su constructor, especificando así cómo se deben registrar los fallos.

QAbstractItemModelTester también puede reportar información adicional de depuración como mensajes de registro bajo la categoría de registro qt.modeltest. Este registro de depuración está deshabilitado por defecto; consulte la documentación de QLoggingCategory para aprender a habilitarlo.