Адаптер (Adapter / Wrapper)
Адаптер (Adapter / Wrapper)
Шаблон адаптера позволяет обернуть несовместимый объект в адаптер, чтобы сделать его совместимым с другим классом.
Чаще всего "Адаптер" применяется, если необходимо создать определенный класс, производный от уже существующего.
Привести нестандартный или неудобный интерфейс какого-то класса в интерфейс, совместимый с вашим кодом. Адаптер
позволяет классам работать вместе стандартным образом, что обычно не получается из-за несовместимых интерфейсов,
предоставляя для этого прослойку с интерфейсом, удобным для клиентов, самостоятельно используя оригинальный интерфейс.
Использование:
- Когда вы хотите использовать сторонний класс, но его интерфейс не соответствует остальному коду приложения.
- Когда вам нужно использовать несколько существующих подклассов, но в них не хватает какой-то общей функциональности,
причём расширить суперкласс вы не можете.
Преимущества:
- Отделяет и скрывает от клиента подробности преобразования различных интерфейсов.
Недостатки:
- Усложняет код программы из-за введения дополнительных классов.
Связи с другими паттернами
- Мост проектируют загодя, чтобы развивать большие части приложения отдельно друг от друга. Адаптер применяется постфактум, чтобы заставить несовместимые классы работать вместе.
- Адаптер меняет интерфейс существующего объекта. Декоратор улучшает другой объект без изменения его интерфейса. Причём Декоратор поддерживает рекурсивную вложенность, чего не скажешь об Адаптере.
- Адаптер предоставляет классу альтернативный интерфейс. Декоратор предоставляет расширенный интерфейс. Заместитель предоставляет тот же интерфейс.
- Фасад задаёт новый интерфейс, тогда как Адаптер повторно использует старый. Адаптер оборачивает только один класс, а Фасад оборачивает целую подсистему. Кроме того, Адаптер позволяет двум существующим интерфейсам работать сообща, вместо того, чтобы задать полностью новый.
- Мост, Стратегия и Состояние (а также слегка и Адаптер) имеют схожие структуры классов – все они построены на принципе «композиции», то есть делегирования работы другим объектам. Тем не менее, они отличаются тем, что решают разные проблемы. Помните, что паттерны – это не только рецепт построения кода определённым образом, но и описание проблем, которые привели к данному решению.
Adapter.php
<?php
interface NativeWorker
{
public function countSalary(): int;
}
interface OutsourceWorker
{
public function countSalaryByHour($hours): int;
}
class NativeDeveloper implements NativeWorker
{
public function countSalary(): int
{
return 3000 * 20;
}
}
class OutsourceDeveloper implements OutsourceWorker
{
public function countSalaryByHour($hours): int
{
return $hours * 300;
}
}
class OutsourceWorkerAdapter implements NativeWorker
{
private OutsourceWorker $outsourceWorker;
public function __construct(OutsourceWorker $outsourceWorker)
{
$this->outsourceWorker = $outsourceWorker;
}
public function countSalary(): int
{
return $this->outsourceWorker->countSalaryByHour(40);
}
}
$nativeDeveloper = new NativeDeveloper();
echo $nativeDeveloper->countSalary(); // 60000
$outsourceDeveloper = new OutsourceDeveloper();
echo $outsourceDeveloper->countSalaryByHour(40); //12000
$outsourceWorkerAdapter = new OutsourceWorkerAdapter($outsourceDeveloper);
echo $outsourceWorkerAdapter->countSalary(); // 12000
// ----------- 2 -----------
interface Book
{
public function turnPage();
public function open();
public function getPage(): int;
}
class PaperBook implements Book
{
private int $page;
public function open(): void
{
$this->page = 1;
}
public function turnPage(): void
{
$this->page++;
}
public function getPage(): int
{
return $this->page;
}
}
interface EBook
{
public function unlock();
public function pressNext();
/**
* возвращает текущую страницу и общее количество страниц, например [10, 100] - страница 10 из 100
*
* @return int[]
*/
public function getPage(): array;
}
/**
* Вот этот адаптер. Обратите внимание, что в нем реализована книга,
* таким образом, вам не нужно изменять код клиента, который использует книгу
*/
class EBookAdapter implements Book
{
public function __construct(protected EBook $eBook)
{
}
/**
* Этот класс выполняет надлежащий перевод с одного интерфейса на другой.
*/
public function open()
{
$this->eBook->unlock();
}
public function turnPage()
{
$this->eBook->pressNext();
}
/**
* обратите внимание на адаптированное поведение здесь: eBook::getPage() вернет два целых числа, но Book
* поддерживает только средство получения текущей страницы, поэтому мы адаптируем поведение здесь
*/
public function getPage(): int
{
return $this->eBook->getPage()[0];
}
}
/**
* это адаптированный класс. В производственном коде это может быть класс из другого пакета, какой-нибудь код поставщика.
* Обратите внимание, что он использует другую схему именования, и реализация делает нечто подобное, но другим способом
*/
class Kindle implements EBook
{
private int $page = 1;
private int $totalPages = 100;
public function pressNext()
{
$this->page++;
}
public function unlock()
{
}
/**
* возвращает текущую страницу и общее количество страниц, например [10, 100] - страница 10 из 100
*
* @return int[]
*/
public function getPage(): array
{
return [$this->page, $this->totalPages];
}
}
$book = new PaperBook();
$book->open();
$book->turnPage();
echo $book->getPage(); // 2
$kindle = new Kindle();
$kindle->unlock();
$kindle->pressNext();
print_r($kindle->getPage());
// [0] => 2
// [1] => 100
$kindle2 = new Kindle();
$book2 = new EBookAdapter($kindle2);
$book2->open();
$book2->turnPage();
$book2->turnPage();
echo $book2->getPage(); // 3