Test des classes abstraites


144

Comment tester les méthodes concrètes d'une classe abstraite avec PHPUnit?

Je m'attendrais à devoir créer une sorte d'objet dans le cadre du test. Cependant, je n'ai aucune idée de la meilleure pratique pour cela ou si PHPUnit le permet.


10
Vous devriez peut-être envisager de changer la réponse acceptée.
Jacob

Réponses:


240

Le test unitaire des classes abstraites ne signifie pas nécessairement tester l'interface, car les classes abstraites peuvent avoir des méthodes concrètes, et ces méthodes concrètes peuvent être testées.

Il n'est pas si rare, lors de l'écriture de code de bibliothèque, d'avoir une classe de base que vous prévoyez d'étendre dans votre couche d'application. Et si vous voulez vous assurer que le code de la bibliothèque est testé, vous avez besoin de moyens pour UT les méthodes concrètes des classes abstraites.

Personnellement, j'utilise PHPUnit, et il a ce qu'on appelle des stubs et des objets simulés pour vous aider à tester ce genre de choses.

Directement à partir du manuel PHPUnit :

abstract class AbstractClass
{
    public function concreteMethod()
    {
        return $this->abstractMethod();
    }

    public abstract function abstractMethod();
}

class AbstractClassTest extends PHPUnit_Framework_TestCase
{
    public function testConcreteMethod()
    {
        $stub = $this->getMockForAbstractClass('AbstractClass');
        $stub->expects($this->any())
             ->method('abstractMethod')
             ->will($this->returnValue(TRUE));

        $this->assertTrue($stub->concreteMethod());
    }
}

L'objet simulé vous donne plusieurs choses:

  • vous n'êtes pas obligé d'avoir une implémentation concrète de la classe abstraite, et pouvez vous en tirer avec stub à la place
  • vous pouvez appeler des méthodes concrètes et affirmer qu'elles fonctionnent correctement
  • si la méthode concrète repose sur une méthode non implémentée (abstraite), vous pouvez remplacer la valeur de retour avec la méthode will () PHPUnit

38

C'est une bonne question. J'ai cherché ça aussi.
Heureusement, PHPUnit a déjà une getMockForAbstractClass()méthode pour ce cas, par exemple

protected function setUp()
{
    $stub = $this->getMockForAbstractClass('Some_Abstract_Class');
    $this->_object = $stub;
}

Important:

Notez que cela nécessite PHPUnit> 3.5.4. Il y avait un bogue dans les versions précédentes.

Pour passer à la dernière version:

sudo pear channel-update pear.phpunit.de
sudo pear upgrade phpunit/PHPUnit

Cela semble intéressant, mais vous testeriez contre la simulation? À quoi ressembleraient les tests? IE: étendre la maquette dans le cas de test et tester par rapport à la classe de test étendue?
stefgosselin

34

Il convient de noter que depuis PHP 7, le support des classes anonymes a été ajouté. Cela vous donne un moyen supplémentaire de configurer un test pour une classe abstraite, qui ne dépend pas des fonctionnalités spécifiques à PHPUnit.

class AbstractClassTest extends \PHPUnit_Framework_TestCase
{
    /**
     * @var AbstractClass
     */
    private $testedClass;

    public function setUp()
    {
        $this->testedClass = new class extends AbstractClass {

            protected function abstractMethod()
            {
                // Put a barebones implementation here
            }
        };
    }

    // Put your tests here
}

4
Merci pour cela! L'utilisation d'une classe anonyme dans PHPUnit m'a donné beaucoup de flexibilité dans la création de mes différents tests.
Alice Wonder

1

Eran, votre méthode devrait fonctionner, mais elle va à l'encontre de la tendance d'écrire le test avant le code réel.

Ce que je suggérerais, c'est d'écrire vos tests sur la fonctionnalité souhaitée d'une sous-classe non abstraite de la classe abstraite en question, puis d'écrire à la fois la classe abstraite et la sous-classe d'implémentation, et enfin d'exécuter le test.

Vos tests doivent évidemment tester les méthodes définies de la classe abstraite, mais toujours via la sous-classe.


Je trouve une réponse arbitraire: vous avez une classe abstraite 'A' ayant une méthode commune 'foo ()'. Cette méthode «foo ()» est utilisée dans l'ensemble toutes les classes «B» et «C», toutes deux dérivant de «A». Quelle classe choisiriez-vous pour tester 'foo ()'?
user3790897

1

La réponse de Nelson est fausse.

Les classes abstraites ne nécessitent pas que toutes leurs méthodes soient abstraites.

Les méthodes implémentées sont celles que nous devons tester.

Ce que vous pouvez faire, c'est créer une fausse classe stub sur le fichier de test unitaire, lui faire étendre la classe abstraite et implémenter uniquement ce qui est requis sans aucune fonctionnalité, bien sûr, et tester cela.

À votre santé.


0

Si vous ne voulez pas sous-classer la classe abstraite juste pour effectuer un test unitaire sur les méthodes qui sont déjà implémentées dans la classe abstraite, vous pouvez essayer de voir si votre framework vous permet de simuler des classes abstraites.

En utilisant notre site, vous reconnaissez avoir lu et compris notre politique liée aux cookies et notre politique de confidentialité.
Licensed under cc by-sa 3.0 with attribution required.