门面模式（Facade）

目的

门面模式的最初目的并不是为了避免让你阅读复杂的 API 文档，这只是一个附带作用。其实它的本意是为了降低耦合性并且遵循 Demeter 定律。

一个门面旨在通过嵌入许多（但有时只有一个）接口来分离客户端和子系统。当然，也是为了降低复杂度。

  • 门面不会禁止你访问子系统。
  • 你可以（应该）有多个门面对应一个子系统。

这就是为什么一个好的门面里没有 new 的原因。如果每个方法都有多种创建，那并不是一个门面，而是一个构建器 [抽象的|静态的|简单的] 或是一个工厂 [方法] 。

最好的门面是没有 new 的，并且其构造函数带有接口类型提示的参数。 如果你需要创建新的实例，可以使用工厂作为变量。

UML 图

z5RZ820Gdy.png

代码

你也可以在 GitHub 上查看此代码

Facade.php

  2. <?php
  4. namespace DesignPatterns\Structural\Facade;
  6. class Facade
  7. {
  8.     /**
  9.     * @var OsInterface
  10.     * 定义操作系统接口变量。
  11.     */
  12.     private $os;
  14.     /**
  15.     * @var BiosInterface
  16.     * 定义基础输入输出系统接口变量。
  17.     */
  18.     private $bios;
  20.     /**
  21.     * @param BiosInterface $bios
  22.     * @param OsInterface $os
  23.     * 传入基础输入输出系统接口对象 $bios 。
  24.     * 传入操作系统接口对象 $os 。
  25.     */
  26.     public function __construct(BiosInterface $bios, OsInterface $os)
  27.     {
  28.         $this->bios = $bios;
  29.         $this->os = $os;
  30.     }
  32.     /**
  33.     * 构建基础输入输出系统执行启动方法。
  34.     */
  35.     public function turnOn()
  36.     {
  37.         $this->bios->execute();
  38.         $this->bios->waitForKeyPress();
  39.         $this->bios->launch($this->os);
  40.     }
  42.     /**
  43.     * 构建系统关闭方法。
  44.     */
  45.     public function turnOff()
  46.     {
  47.         $this->os->halt();
  48.         $this->bios->powerDown();
  49.     }
  50. }

OsInterface.php

  2. <?php
  4. namespace DesignPatterns\Structural\Facade;
  6. /**
  7. * 创建操作系统接口类 OsInterface 。
  8. */
  9. interface OsInterface
  10. {
  11.     /**
  12.     * 声明关机方法。
  13.     */
  14.     public function halt();
  16.     /** 
  17.     * 声明获取名称方法，返回字符串格式数据。
  18.     */
  19.     public function getName(): string;
  20. }

BiosInterface.php

  2. <?php
  4. namespace DesignPatterns\Structural\Facade;
  6. /**
  7. * 创建基础输入输出系统接口类 BiosInterface 。
  8. */
  9. interface  BiosInterface
  10. {
  11.     /**
  12.     * 声明执行方法。
  13.     */
  14.     public function execute();
  16.     /**
  17.     * 声明等待密码输入方法
  18.     */
  19.     public function waitForKeyPress();
  21.     /**
  22.     * 声明登录方法。
  23.     */
  24.     public function launch(OsInterface $os);
  26.     /**
  27.     * 声明关机方法。
  28.     */
  29.     public function powerDown();
  30. }

测试

Tests/FacadeTest.php

  2. <?php
  4. namespace DesignPatterns\Structural\Facade\Tests;
  6. use DesignPatterns\Structural\Facade\Facade;
  7. use DesignPatterns\Structural\Facade\OsInterface;
  8. use PHPUnit\Framework\TestCase;
  10. /**
  11. * 创建自动化测试单元 FacadeTest 。
  12. */
  13. class FacadeTest extends TestCase
  14. {
  15.     public function testComputerOn()
  16.     {
  17.         /** @var OsInterface|\PHPUnit_Framework_MockObject_MockObject $os */
  18.         $os = $this->createMock('DesignPatterns\Structural\Facade\OsInterface');
  20.         $os->method('getName')
  21.             ->will($this->returnValue('Linux'));
  23.         $bios = $this->getMockBuilder('DesignPatterns\Structural\Facade\BiosInterface')
  24.             ->setMethods(['launch', 'execute', 'waitForKeyPress'])
  25.             ->disableAutoload()
  26.             ->getMock();
  28.         $bios->expects($this->once())
  29.             ->method('launch')
  30.             ->with($os);
  32.         $facade = new Facade($bios, $os);
  34.         // 门面接口很简单。
  35.         $facade->turnOn();
  37.         // 但你也可以访问底层组件。
  38.         $this->assertEquals('Linux', $os->getName());
  39.     }
  40. }