目的

将一个类的接口转换成可应用的兼容接口。适配器使原本由于接口不兼容而不能一起工作那些类可以一起工作。

例子

  • 客户端数据库适配器
  • 使用多个不同的网络服务适配器来规范数据使得出来结果是想同的。

UML图

代码

1
2
3
4
5
6
7
8
9
BookInterface.php
<?php
namespace DesignPatterns\Structural\Adapter;
interface BookInterface
{
public function turnPage();
public function open();
public function getPage():int;
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
Book.php
<?php
namespace DesignPatterns\Structural\Adapter;
class Book implements BookInterface
{
private $page;
public function open()
{
$this->page = 1;
}
public function turnPage()
{
$this->page++;
}

public function getPage():int
{
return $this->page;
}
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
EBookAdapter.php
<?php
namespace DesignPatterns\Structural\Adapter;
/**
* 这里是一个适配器,注意他实现了 BookInterface,
* 因此你不必去更改客户端代码当使用 Book
*/
class EBookAdapter implements BookInterface
{
protected $eBook;
public function __contruct(EBookInterface $eBook)
{
$this->eBook = $eBook;
}
/**
* 这个类使接口进行适当的转换
*/
public function open()
{
$this-eBook->unlock();
}

public function turnPage()
{
$this->eBook->pressNext();
}
/**
* 注意这里适配器的行为: EBookInterface::getPage() 将反回两个整型,除了 BookInterface
* 仅支持获得当前页,所以我们这里适配这个行为。
*/
public function getPage():int
{
return $this->eBook->getPage()[0];
}
}
1
2
3
4
5
6
7
8
9
10
11
12
EBookInterface.php
<?php
namespace DesignPatterns\Structural\Adapter;
interface EBookInterface
{
public function unlock();
public function pressNext();
/**
* 返回当前和总页数,像 [10,100] 是总页数 100 中的第10页。
*/
public function getPage();array;
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
Kindle.php
<?php
namespace PStructural\AdaPter;
/**
* 这里是适配过的类,在生产代码中,这可能是来自另一个报的类,一些供应商提供的代码。
* 注意它使用了另一个命名方案并用了另一个方式实现了类似的操作。
*/
class Kindle implements EBookInterface
{
private $page = 1;
private $totalPages = 100;
public function pressNext()
{
$this->page++;
}
public function unlock()
{

}

/**
* 返回当前页和总页数,像 [10,100] 是总页数 100页中的第10页。
*/
public function getPage():array
{
return [$this->page,$this->totalPages];
}
}

测试

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
Tests/AdapterTest.php
<?php
namespace DesignPatterns\Structural\Adapter\Tests;
use DesignPatterns\Structural\Adapter\Book;
use DesignPatterns\Structural\Adapter\EBookAdapter;
user DesignPatterns\Structural\Adapter\Kindle;
user PHPUnit\Framework\TestCase;
class AdapterTest extends TestCase
{
public function testCanTurnPageOnBook()
{
$book = new Book();
$book->open();
$book->turnPage();
$this->assertEquals(2,$book->gerPager());
}
public function testCanTrunPageOnKindleLikeInANormalBook()
{
$kindle = new Kindle();
$book = new EBookAdaPter($kindle);
$book->open();
$book->turnPage();
$this->assertEquals(2,$book->gerPage());
}
}