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.

Mez
la source
10
Vous devriez peut-être envisager de changer la réponse acceptée.
Jacob
1
Peut-être que stackoverflow.com/a/2947823/23963 vous aidera.
Nigel Thorne

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
Victor Farazdagi
la source
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
prend
la source
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
}
GordonM
la source
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.


la source
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é.

skqr
la source
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.

hangy
la source