![Какви проблеми решава шаблонът за проектиране на адаптер? - 1](https://cdn.codegym.cc/images/article/2a00c183-20f3-4a73-abc5-f1f896e18a52/800.jpeg)
Повече за проблема
Първо, ще симулираме поведението на старата система. Да предположим, че генерира извинения за закъснение за работа or учorще. За да направи това, имаExcuse
интерфейс, който има generateExcuse()
, likeExcuse()
и dislikeExcuse()
методи.
public interface Excuse {
String generateExcuse();
void likeExcuse(String excuse);
void dislikeExcuse(String excuse);
}
Класът WorkExcuse
имплементира този интерфейс:
public class WorkExcuse implements Excuse {
private String[] excuses = {"in an incredible confluence of circumstances, I ran out of hot water and had to wait until sunlight, focused using a magnifying glass, heated a mug of water so that I could wash.",
"the artificial intelligence in my alarm clock failed me, waking me up an hour earlier than normal. Because it is winter, I thought it was still nighttime and I fell back asleep. Everything after that is a bit hazy.",
"my pre-holiday mood slows metabolic processes in my body, leading to depression and insomnia."};
private String [] apologies = {"This will not happen again, of course. I'm very sorry.", "I apologize for my unprofessional behavior.", "There is no excuse for my actions. I am not worthy of this position."};
@Override
public String generateExcuse() { // Randomly select an excuse from the array
String result = "I was late today because " + excuses[(int) Math.round(Math.random() + 1)] + "\\n" +
apologies[(int) Math.round(Math.random() + 1)];
return result;
}
@Override
public void likeExcuse(String excuse) {
// Duplicate the element in the array so that its chances of being chosen are higher
}
@Override
public void dislikeExcuse(String excuse) {
// Remove the item from the array
}
}
Нека тестваме нашия пример:
Excuse excuse = new WorkExcuse();
System.out.println(excuse.generateExcuse());
Изход:
"I was late today because my pre-holiday mood slows metabolic processes in my body, leading to depression and insomnia.
I apologize for my unprofessional behavior.
Сега си представете, че сте стартирали услуга за генериране на извинения, събрали сте статистика и сте забелязали, че повечето от вашите потребители са студенти. За да обслужвате по-добре тази група, помолихте друг разработчик да създаде система, която генерира извинения специално за студенти. Екипът за разработка проведе проучване на пазара, класира извиненията, свърза малко изкуствен интелект и интегрира услугата с отчети за трафика, прогнози за времето и т.н. Сега имате библиотека за генериране на извинения за студенти, но тя има различен интерфейс: StudentExcuse
.
public interface StudentExcuse {
String generateExcuse();
void dislikeExcuse(String excuse);
}
Този интерфейс има два метода: generateExcuse
, който генерира извинение, и dislikeExcuse
, който предотвратява повторното появяване на извинението в бъдеще. Библиотеката на трета страна не може да се редактира, т.е. не можете да промените нейния изходен code. Това, което имаме сега, е система с два класа, които имплементират интерфейса Excuse
, и библиотека с SuperStudentExcuse
клас, който имплементира StudentExcuse
интерфейса:
public class SuperStudentExcuse implements StudentExcuse {
@Override
public String generateExcuse() {
// Logic for the new functionality
return "An incredible excuse adapted to the current weather conditions, traffic jams, or delays in public transport schedules.";
}
@Override
public void dislikeExcuse(String excuse) {
// Adds the reason to a blacklist
}
}
Кодът не може да се променя. Текущата йерархия на класовете изглежда така: ![Какви проблеми решава шаблонът за проектиране на адаптер? - 2](https://cdn.codegym.cc/images/article/5eb3ced7-e0e6-4dec-94a1-298d797d0e7d/800.jpeg)
![Какви проблеми решава шаблонът за проектиране на адаптер? - 3](https://cdn.codegym.cc/images/article/97a9295a-155b-4043-9c37-b187044a02df/800.jpeg)
Excuse
интерфейса. Но допълнителната йерархия е нежелателна при сериозни applications: въвеждането на общ коренов елемент нарушава архитектурата. Трябва да внедрите междинен клас, който ще ни позволи да използваме Howто новата, така и старата функционалност с минимални загуби. Накратко, имате нужда от адаптер .
Принципът зад модела на адаптера
Адаптерът е междинен обект, който позволява извикванията на метода на един обект да бъдат разбрани от друг. Нека внедрим адаптер за нашия пример и да го наречемMiddleware
. Нашият адаптер трябва да реализира интерфейс, който е съвместим с един от обектите. Нека бъде Excuse
. Това позволява Middleware
да се извикат методите на първия обект. Middleware
приема повиквания и ги препраща по съвместим начин към втория обект. Ето реализацията Middleware
с методите generateExcuse
и dislikeExcuse
:
public class Middleware implements Excuse { // 1. Middleware becomes compatible with WorkExcuse objects via the Excuse interface
private StudentExcuse superStudentExcuse;
public Middleware(StudentExcuse excuse) { // 2. Get a reference to the object being adapted
this.superStudentExcuse = excuse;
}
@Override
public String generateExcuse() {
return superStudentExcuse.generateExcuse(); // 3. The adapter implements an interface method
}
@Override
public void dislikeExcuse(String excuse) {
// The method first adds the excuse to the blacklist,
// Then passes it to the dislikeExcuse method of the superStudentExcuse object.
}
// The likeExcuse method will appear later
}
Тестване (в клиентски code):
public class Test {
public static void main(String[] args) {
Excuse excuse = new WorkExcuse(); // We create objects of the classes
StudentExcuse newExcuse = new SuperStudentExcuse(); // that must be compatible.
System.out.println("An ordinary excuse for an employee:");
System.out.println(excuse.generateExcuse());
System.out.println("\n");
Excuse adaptedStudentExcuse = new Middleware(newExcuse); // Wrap the new functionality in the adapter object
System.out.println("Using new functionality with the adapter:");
System.out.println(adaptedStudentExcuse.generateExcuse()); // The adapter calls the adapted method
}
}
Изход:
An ordinary excuse for an employee:
I was late today because my pre-holiday mood slows metabolic processes in my body, leading to depression and insomnia.
There is no excuse for my actions. I am not worthy of this position.
Using new functionality with the adapter:
Невероятно извинение, адаптирано към текущите метеорологични условия, задръствания or закъснения в разписанията на градския транспорт. Методът generateExcuse
просто предава извикването на друг обект, без ниHowви допълнителни промени. Методът dislikeExcuse
изискваше първо да поставим извинението в черен списък. Възможността за извършване на междинна обработка на данни е причина хората да обичат модела на адаптера. Но Howво да кажем за likeExcuse
метода, който е част от Excuse
интерфейса, но не и част от StudentExcuse
интерфейса? Новата функционалност не поддържа тази операция. Измислен е UnsupportedOperationException
за тази ситуация. Изхвърля се, ако заявената операция не се поддържа. Нека го използваме. Ето How Middleware
изглежда новата реализация на класа:
public class Middleware implements Excuse {
private StudentExcuse superStudentExcuse;
public Middleware(StudentExcuse excuse) {
this.superStudentExcuse = excuse;
}
@Override
public String generateExcuse() {
return superStudentExcuse.generateExcuse();
}
@Override
public void likeExcuse(String excuse) {
throw new UnsupportedOperationException("The likeExcuse method is not supported by the new functionality");
}
@Override
public void dislikeExcuse(String excuse) {
// The method accesses a database to fetch additional information,
// and then passes it to the superStudentExcuse object's dislikeExcuse method.
}
}
На пръв поглед това решение не изглежда много добро, но имитирането на функционалността може да усложни ситуацията. Ако клиентът обърне внимание и адаптерът е добре documentиран, такова решение е приемливо.
Кога да използвате адаптер
-
Когато трябва да използвате клас на трета страна, но интерфейсът му е несъвместим с основното приложение. Примерът по-горе показва How да създадете адаптерен обект, който обвива повикванията във формат, който целевият обект може да разбере.
-
Когато няколко съществуващи подкласа се нуждаят от обща функционалност. Вместо да създавате допълнителни подкласове (което ще доведе до дублиране на code), по-добре е да използвате адаптер.
Предимства и недостатъци
Предимство: Адаптерът скрива от клиента подробностите за обработката на заявки от един обект към друг. Кодът на клиента не мисли за форматиране на данни or обработка на извиквания към целевия метод. Твърде сложно е, а програмистите са мързеливи :) Недостатък: Кодовата база на проекта е усложнена от допълнителни класове. Ако имате много несъвместими интерфейси, броят на допълнителните класове може да стане неуправляем.Не бъркайте адаптер с фасада or декоратор
Само с повърхностен оглед адаптерът може да бъде объркан с шарките на фасадата и декоратора. Разликата между адаптер и фасада е, че фасадата въвежда нов интерфейс и обгръща цялата подсистема. А декораторът, за разлика от адаптера, променя самия обект, а не интерфейса.Алгоритъм стъпка по стъпка
-
Първо, уверете се, че имате проблем, който този модел може да разреши.
-
Дефинирайте клиентския интерфейс, който ще се използва за индиректно взаимодействие с несъвместими обекти.
-
Накарайте класа на адаптера да наследи интерфейса, дефиниран в предишната стъпка.
-
В класа на адаптера създайте поле за съхраняване на препратка към адаптирания обект. Тази препратка се предава на конструктора.
-
Внедрете всички методи на клиентския интерфейс в адаптера. Един метод може:
-
Предавайте повиквания, без да правите промени
-
Променете or допълнете данните, увеличете/намалете броя на извикванията към целевия метод и др.
-
В екстремни случаи, ако определен метод остане несъвместим, хвърлете UnsupportedOperationException. Неподдържаните операции трябва да бъдат строго documentирани.
-
-
Ако приложението използва само класа на адаптера през клиентския интерфейс (Howто в примера по-горе), тогава адаптерът може да бъде безболезнено разширен в бъдеще.