Adapter и Facade

Код на:JavaC#PythonJavaScript

Накратко: Adapter превежда чужд интерфейс към този, който кодът ти очаква, а Facade скрива няколко подсистеми (склад, плащане, фактура, имейл) зад един метод.

Проблем

Новият доставчик не пасва

Магазинът плаща през свой интерфейс: charge приема сумата в евро и казва дали плащането е минало. Магазинът не знае кой стои отзад:

interface PaymentGateway {
    boolean charge(double amount);
}

class Shop {
    private final PaymentGateway gateway;

    public Shop(PaymentGateway gateway) {
        this.gateway = gateway;
    }

    public void pay(String order, double amount) {
        if (gateway.charge(amount)) {
            System.out.println(order + ": платено");
        } else {
            System.out.println(order + ": отказано");
        }
    }
}

Фирмата сменя доставчика на плащания с FastPay, който взима по-ниски такси. FastPay дава готова библиотека:

// Библиотеката на FastPay: чужд код, който не можеш да промениш.
class FastPayClient {
    public String makePayment(String currency, long amountInCents, Map<String, String> options) {
        System.out.println("FastPay: " + amountInCents + " " + currency);
        if (amountInCents > 100000) {
            return "DECLINED";
        }
        return "APPROVED";
    }
}

Прави същото, но с друга форма. Методът се казва makePayment, иска валута, сума в центове и опции, и връща текст "APPROVED" или "DECLINED", а не да или не. Подаден направо на магазина, не пасва:

Shop shop = new Shop(new FastPayClient());

Грешка

error: incompatible types: FastPayClient cannot be converted to PaymentGateway

Библиотеката е чужда: не можеш да ѝ добавиш метод. Да пренапишеш магазина за FastPay значи да пипнеш всяко място, което плаща, и да го пипнеш пак при следващия доставчик.

Идеята

Две обвивки, две различни цели

Двата шаблона в този урок обвиват чужд код, но решават различни задачи.

Adapter (адаптер) е клас с формата, която кодът ти чака, а вътре вика чуждия обект. Превежда имената, единиците и резултата. Като преходник за контакт в чужбина: щепселът на зарядното ти не пасва на контакта, преходникът пасва и на двете. Нищо не добавя, само сменя формата.

Facade (фасада) е една проста входна точка пред много класове, с които трябва да се работи в определен ред. Като рецепцията в хотел: не звъниш поотделно на чистачите, кухнята и счетоводството, казваш на рецепцията.

Разликата накратко:

• адаптерът сменя формата на един интерфейс, за да пасне на друг;
• фасадата опростява работата с много класове, като събира обичайната последователност зад един метод.

Виж го

Адаптерът превежда

FastPayAdapter имплементира PaymentGateway. Вътре пази клиента на FastPay и превежда: евро в центове, "EUR" и празни опции, текстът в да или не:

class FastPayAdapter implements PaymentGateway {
    private final FastPayClient client;

    public FastPayAdapter(FastPayClient client) {
        this.client = client;
    }

    @Override
    public boolean charge(double amount) {
        long cents = Math.round(amount * 100);
        String status = client.makePayment("EUR", cents, Map.of());
        return status.equals("APPROVED");
    }
}

Магазинът получава адаптера вместо клиента. В него не се пипа нищо:

Shop shop = new Shop(new FastPayAdapter(new FastPayClient()));
shop.pay("#1042", 19.99);
shop.pay("#1043", 1299);

Изход

FastPay: 1999 EUR
#1042: платено
FastPay: 129900 EUR
#1043: отказано

Телевизорът за 1299 € е над лимита на FastPay (1000 €), затова е отказан. Магазинът научава отказа на своя език: false.

Сцената показва адаптера, после и фасадата от следващата карта:

PaymentGateway payments = new FastPayAdapter(new FastPayClient());
System.out.println(payments.charge(19.99));

CheckoutFacade checkout = new CheckoutFacade(new Stock(), payments, new Invoices(), new Mailer());
checkout.placeOrder("Чайник", 24.90);

Стъпка по стъпка, с думи

1. Магазинът вика charge(сума в евро). FastPayClient има само makePayment(валута, центове, опции), и прякото извикване отскача.
2. FastPayAdapter застава между тях: отвън е PaymentGateway с charge, а вътре пази клиента на FastPay.
3. charge(19.99): адаптерът закръгля евро в центове, 1999, и вика makePayment с "EUR".
4. FastPay отговаря "APPROVED", а адаптерът го превежда в true: езика на магазина.
5. CheckoutFacade получава склада, плащанията (същия адаптер), фактурите и имейла.
6. placeOrder: първо складът запазва чайника.
7. После плащането, пак през адаптера: 24.90 € стават 2490 цента.
8. Минало е, затова фасадата издава фактурата и праща имейла. Викащият написа един ред.

По-точно, за любопитните

• Адаптери има и в стандартната библиотека. InputStreamReader прави от поток байтове поток символи (Reader), а Arrays.asList показва масив като List.
• Адаптерът пази чуждия обект в поле (композиция). Може и да го наследи (class FastPayAdapter extends FastPayClient implements PaymentGateway), но тогава магазинът вижда и всички методи на FastPay, а един адаптер не може да обвие вече създаден клиент.

Виж го

Фасадата пред четири класа

Плащането е само една стъпка от поръчката. Преди него складът запазва стоката, а след него идват фактурата и имейлът. Ако плащането е отказано, складът освобождава стоката. Всяка стъпка е малък клас:

class Stock {
    public boolean reserve(String item) {
        System.out.println("Склад: запазвам " + item);
        return true;
    }

    public void release(String item) {
        System.out.println("Склад: освобождавам " + item);
    }
}

class Invoices {
    public void issue(String item, double amount) {
        System.out.printf("Фактура: %s, %.2f €%n", item, amount);
    }
}

class Mailer {
    public void send(String text) {
        System.out.println("Имейл: " + text);
    }
}

Без фасада всяко място, което приема поръчка (сайтът, мобилното приложение, поръчките по телефон), пише същото, в същия ред:

if (stock.reserve(item)) {
    if (payments.charge(amount)) {
        invoices.issue(item, amount);
        mailer.send("потвърждение за " + item);
    } else {
        stock.release(item);
    }
}

Ако някое място забрави stock.release, стоката остава запазена за поръчка, която не е платена. CheckoutFacade пише реда веднъж:

class CheckoutFacade {
    private final Stock stock;
    private final PaymentGateway payments;
    private final Invoices invoices;
    private final Mailer mailer;

    public CheckoutFacade(Stock stock, PaymentGateway payments, Invoices invoices, Mailer mailer) {
        this.stock = stock;
        this.payments = payments;
        this.invoices = invoices;
        this.mailer = mailer;
    }

    public boolean placeOrder(String item, double amount) {
        if (!stock.reserve(item)) {
            return false;
        }
        if (!payments.charge(amount)) {
            stock.release(item);
            return false;
        }
        invoices.issue(item, amount);
        mailer.send("потвърждение за " + item);
        return true;
    }
}

Плащанията във фасадата са PaymentGateway, подадени отвън (dependency injection от урока „Singleton и Dependency Injection“). Тук това е адаптерът от предишната карта. Двата шаблона работят заедно:

PaymentGateway payments = new FastPayAdapter(new FastPayClient());
CheckoutFacade checkout = new CheckoutFacade(new Stock(), payments, new Invoices(), new Mailer());
checkout.placeOrder("Чайник", 24.90);

Изход

Склад: запазвам Чайник
FastPay: 2490 EUR
Фактура: Чайник, 24.90 €
Имейл: потвърждение за Чайник

Фасадата не е стена. Класовете зад нея се ползват и направо, когато трябва нещо извън обичайния път. Счетоводството издава фактурата отново:

Invoices invoices = new Invoices();
invoices.issue("Чайник", 24.90);

Изход

Фактура: Чайник, 24.90 €

Пробвай

Предвиди изхода

Класовете са от картите „Адаптерът превежда“ и „Фасадата пред четири класа“. Какво печата програмата?

PaymentGateway payments = new FastPayAdapter(new FastPayClient());
CheckoutFacade checkout = new CheckoutFacade(new Stock(), payments, new Invoices(), new Mailer());
checkout.placeOrder("Телевизор", 1299);

Отговор

Склад: запазвам Телевизор
FastPay: 129900 EUR

Склад: запазвам Телевизор
FastPay: 129900 EUR
Фактура: Телевизор, 1299.00 €
Имейл: потвърждение за Телевизор

Склад: запазвам Телевизор
FastPay: 129900 EUR
Склад: освобождавам Телевизор

Провери

Пробвай

Намери грешката

Колега „опрости“ адаптера: центовете и без това са цяло число. Клиентът плаща поръчка #1042 за 19.99 €:

Shop shop = new Shop(new FastPayAdapter(new FastPayClient()));
shop.pay("#1042", 19.99);

Изход

FastPay: 1998 EUR
#1042: платено

FastPay взе 1998 цента, един по-малко. На кой ред в адаптера е грешката?

Избери реда с грешката.

1class FastPayAdapter implements PaymentGateway {2 private final FastPayClient client;34 public FastPayAdapter(FastPayClient client) {5 this.client = client;6 }78 @Override9 public boolean charge(double amount) {10 long cents = (long) (amount * 100);11 String status = client.makePayment("EUR", cents, Map.of());12 return status.equals("APPROVED");13 }14}

Провери

По-точно, за любопитните

Пробвай сам:

System.out.println(19.99 * 100);

Изход

1998.9999999999998

За пари без закръгляния по пътя има BigDecimal: new BigDecimal("19.99") е точно 19.99. Затова големите системи пазят сумите в BigDecimal или направо в центове (long), а double се ползва само за показване.

Идеята

Кога не ти трябва

Адаптер не ти трябва, когато и двете страни са твой код. Тогава смени едната да пасне на другата, вместо да слагаш преводач между тях. Адаптер е за код, който не можеш да пипнеш: чужда библиотека, стара система, услуга на друг екип.

Фасада не ти трябва, когато последователността се ползва на едно място. Една функция там стига. Фасадата има и капан: лесно става клас, през който минава всичко, с метод за всяка нужда на всеки екран. Пази в нея само обичайните пътища, а за останалото викай класовете направо.

И двата шаблона са тънки. Адаптер, който започва да решава бизнес правила (отстъпки, лимити), вече не е адаптер. Фасада, която сама смята суми, вместо да вика класовете, които го правят, също.

Упражнение

Втори доставчик

Реши задачата в редактора си.

PayNow. Фирмата пуска и втори доставчик, PayNow. Библиотеката му иска центовете първи и валутата втора, и връща число: 0 значи успех, всичко друго е отказ.

class PayNowApi {
    public int send(int cents, String currency) {
        System.out.println("PayNow: " + currency + " " + cents);
        return 0;
    }
}

Напиши PayNowAdapter, така че магазинът да плаща през PayNow без промяна:

Shop shop = new Shop(new PayNowAdapter(new PayNowApi()));
shop.pay("#1042", 19.99);

Изход

PayNow: EUR 1999
#1042: платено

Още задачи

• Отказ на поръчка. Добави във фасадата cancelOrder(item): складът освобождава стоката, а клиентът получава имейл „отказана поръчка за …“.
• Тестов доставчик. Напиши FakeGateway implements PaymentGateway, който отказва всяка сума над 50 €. Подай го на фасадата и провери, че при отказ складът освобождава стоката.
• Фактурата пада. Нека издаването на фактура хвърля изключение. Парите вече са взети. Какво трябва да направи фасадата? Реши и го напиши: например да продължи с имейла и да запише грешката, за да се издаде фактурата по-късно.

Тест

Провери се

1. Библиотеката на доставчика има метод с друго име, други единици и друг резултат от тези, които кодът ти чака. Кой шаблон пасва?

ObserverAdapterFacade

2. Уебсайтът, мобилното приложение и телефонните поръчки повтарят едни и същи четири стъпки в същия ред. Кой шаблон пасва?

FacadeSingletonAdapter

3. Има ли фасадата, складът и фактурите пак се ползват ли направо?

Само ако фасадата е singletonДа, фасадата е кратък път, а не стенаНе, фасадата ги скрива напълно

4. Адаптерът превръща 19.99 € в центове с отрязване на дробната част. Какво получава доставчикът?

200019991998

Провери

Започни урока отначало

Свързани уроци

• Нужно отпреди: HashMap и HashSet · Шаблони за дизайн · Strategy · Singleton и Dependency Injection
• Продължава в: Магазинът: кой шаблон къде · Hexagonal и clean architecture · Интеграция със стари и чужди системи
• Задачи по темата: Шаблони за дизайн