2.7. Фасада

2.7.1. Предназначение

Основната цел на фасаден шаблон не е да не ви се налага да четете ръководството на сложен API. Това е само страничен ефект. Първата цел е да се намали връзката и да се следва закона на Деметра (Law of Demeter).

Фасадата има за цел да отдели клиент и подсистема чрез вграждане на много (но понякога само един) интерфейс и, разбира се, да намали сложността.

• Фасадата не ви забранява достъпа до подсистемата

• Можете (трябва) да имате множество фасади за една подсистема

Ето защо добрата фасада няма new в себе си. Ако има множество творения за всеки метод, това не е Facade, това е Builder или [Abstract|Static|Simple] Factory [Method].

Най-добрата фасада няма new и конструктор с interface-type-hinted параметри. Ако се нуждаете от създаване на нови копия, използвайте Factory като аргумент.

2.7.2. UML Диаграма

2.7.3. Код

Можете също да намерите този код в 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. Тест

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());
    }
}