2.7. Facade

2.7.1. Rôle

The primary goal of a Facade Pattern is not to avoid you having to read the manual of a complex API. It’s only a side-effect. The first goal is to reduce coupling and follow the Law of Demeter.

Une façade est destinée à découpler un client et un système secondaire en intégrant plusieurs (ou parfois une seule) interfaces, et bien sûr à réduire la complexité.

• Une façade ne vous interdit pas l’accès au sous-système.

• Vous pouvez (vous devriez) avoir plusieurs façades pour un seul sous-système.

C’est pourquoi une bonne façade n’a pas de new. S’il y a plusieurs créations pour chaque méthode, ce n’est pas une façade, c’est un Builder ou une [méthode] d’usine [abstraite|statique|simple].

La meilleure façade n’a pas de new et un constructeur avec des paramètres indiquant le type d’interface. Si vous avez besoin de créer de nouvelles instances, utilisez un Factory comme argument.

2.7.2. Diagramme UML

2.7.3. Code

Vous pouvez également trouver ce code sur GitHub

Facade.php

<?php

declare(strict_types=1);

namespace DesignPatterns\Structural\Facade;

class Facade
{
    public function __construct(private Bios $bios, private OperatingSystem $os)
    {
    }

    public function turnOn()
    {
        $this->bios->execute();
        $this->bios->waitForKeyPress();
        $this->bios->launch($this->os);
    }

    public function turnOff()
    {
        $this->os->halt();
        $this->bios->powerDown();
    }
}

OperatingSystem.php

<?php

declare(strict_types=1);

namespace DesignPatterns\Structural\Facade;

interface OperatingSystem
{
    public function halt();

    public function getName(): string;
}

Bios.php

<?php

declare(strict_types=1);

namespace DesignPatterns\Structural\Facade;

interface Bios
{
    public function execute();

    public function waitForKeyPress();

    public function launch(OperatingSystem $os);

    public function powerDown();
}

2.7.4. Test

Tests/FacadeTest.php

<?php

declare(strict_types=1);

namespace DesignPatterns\Structural\Facade\Tests;

use DesignPatterns\Structural\Facade\Bios;
use DesignPatterns\Structural\Facade\Facade;
use DesignPatterns\Structural\Facade\OperatingSystem;
use PHPUnit\Framework\TestCase;

class FacadeTest extends TestCase
{
    public function testComputerOn()
    {
        $os = $this->createMock(OperatingSystem::class);

        $os->method('getName')
            ->will($this->returnValue('Linux'));

        $bios = $this->createMock(Bios::class);

        $bios->method('launch')
            ->with($os);

        /** @noinspection PhpParamsInspection */
        $facade = new Facade($bios, $os);
        $facade->turnOn();

        $this->assertSame('Linux', $os->getName());
    }
}