Łańcuch zobowiązań (Chain of Responsibility) - wzorzec projektowy (design pattern)

I. Wzorce kreacyjne
1. Singleton
2. Budowniczy
3. Prototyp
4. Fabryka
5. Fabryka abstrakcyjna
II. Wzorce strukturalne
1. Adapter
2. Most
3. Kompozyt
4. Dekorator
5. Fasada
6. Pyłek
7. Pełnomocnik
III. Wzorce czynnościowe
1. Łańcuch zobowiązań
2. Polecenie
3. Interpreter
4. Iterator
5. Mediator
6. Pamiątka
7. Obserwator
8. Stan
9. Strategia
10. Metoda szablonowa
11. Odwiedzający

Łańcuch zobowiązań (Chain of Responsibility) - wzorzec projektowy (design pattern) - java

1. Cel:
Łańcuch zobowiązań (Chain of Responsibility) oddziela żądanie od obiektu obsługi
w łańcuchu procedur obsługi, aż do ostatecznego rozpoznania.
Chcemy przekazać zapytanie do obiektu odbierającego,
nie wiedząc, kto był nadawcą.
Jak również, nadawca nie powinien wiedzieć, kto był odbiorcą,
aby przetworzyć to żądanie.
2. Problem:
Chcemy oddzielić obiekty nadawcy (sender) i odborcy (receiver).
Bez informacji kto jest nadawcą a kto odbiorcą.

3. Rozwiązanie:
Podczas używania wzorca odbiorca (receiver) powinien zawierać
odniesienie (referencje) do następnego odbiorcy. tzw. następcy (successor).
Nie znamy całej hierarchii ale wiemy kto jest następny.
Wybieramy ten wzorzec aby wybrać luźne połączenie.
Tworzymy łańcuch w którym odbiorcy przetwarzają żądanie.
Jeśli jeden objekt nie przetworzył żadania, zostaje przekazany następnemu.

4. Diagram klas wzorca Łańcuch zobowiązań (Chain of Responsibility):

5. Implementacja:
Klasa testująca łańcuch zobowiązań:

class ChainOfResponsibilityTest {
    public static void main(String[] args) {
        NominalChainHandler nominalHandler_100 = new NominalHandler_100(100);
        NominalChainHandler nominalHandler_50 = new NominalHandler_50(50);
        NominalChainHandler nominalHandler_10 = new NominalHandler_10(10);
        NominalChainHandler nominalHandler_5 = new NominalHandler_5(5);
        NominalChainHandler nominalHandler_2 = new NominalHandler_2(2);
        NominalChainHandler nominalHandler_1 = new NominalHandler_1(1);
 
        // ustawienie łańcuchów
        nominalHandler_100.setNextHandler(nominalHandler_50);
        nominalHandler_50.setNextHandler(nominalHandler_10);
        nominalHandler_10.setNextHandler(nominalHandler_5);
        nominalHandler_5.setNextHandler(nominalHandler_2);
        nominalHandler_2.setNextHandler(nominalHandler_1);
 
        // użycie (TEST)
        System.out.println("Rozłóż na drobne 5310 $");
        nominalHandler_100.handler(5310);
        System.out.println("Rozłóż na drobne 250 $");
        nominalHandler_100.handler(250);
        System.out.println("Rozłóż na drobne 430 $");
        nominalHandler_100.handler(430);
    }
}

Klasa abstrakcyjna która jest handlerem dla konkretnych nominałów:

public abstract class NominalChainHandler {
    NominalChainHandler nextHandler = null;
    Integer wielkoscJednostki = 0;
 
    public MoneyChainHandler setNextHandler (MoneyChainHandler nextHandler) {
        this.nextHandler = nextHandler;
        return this.nextHandler;
    }
 
    public void handler (int wielkoscCalosc) {
        int ilosc = wielkoscCalosc / wielkoscJednostki;
        int reszta = wielkoscCalosc % wielkoscJednostki;
 
        if (ilosc > 0) {
            System.out.printf("podzielone na: %d X %d = %d rodzaj: %s \n", wielkoscJednostki, ilosc, (wielkoscJednostki * ilosc), this.getClass().getSimpleName());
        }
        if (nextHandler != null && reszta > 0) {
            nextHandler.handler(reszta);
        }
    }
}

Implementacja konkretnych nominałów:

public class NominalHandler_100 extends NominalChainHandler {
    public HundrenDollarHandler_100 (Integer wielkoscJednostki) {
        this.wielkoscJednostki = wielkoscJednostki;
    }
}
 
public class NominalHandler_50 extends NominalChainHandler {
    public NominalHandler_50 (Integer wielkoscJednostki) {
        this.wielkoscJednostki = wielkoscJednostki;
    }
}
 
public class NominalHandler_10 extends NominalChainHandler {
    public NominalHandler_10 (Integer wielkoscJednostki) {
        this.wielkoscJednostki = wielkoscJednostki;
    }
}
 
public class NominalHandler_5 extends NominalChainHandler {
    public NominalHandler_5 (Integer wielkoscJednostki) {
        this.wielkoscJednostki = wielkoscJednostki;
    }
}
 
public class NominalHandler_2 extends NominalChainHandler {
    public NominalHandler_2 (Integer wielkoscJednostki) {
        this.wielkoscJednostki = wielkoscJednostki;
    }
}
 
public class NominalHandler_1 extends NominalChainHandler {
    public NominalHandler_1 (Integer wielkoscJednostki) {
        this.wielkoscJednostki = wielkoscJednostki;
    }
}

Wynikiem wywołanej klasy testowej jest:

Rozłóż na drobne 5310 $
podzielone na: 100 X 53 = 5300 rodzaj: NominalHandler_100
podzielone na: 10 X 1 = 10 rodzaj: NominalHandler_10
Rozłóż na drobne 250 $
podzielone na: 100 X 2 = 200 rodzaj: NominalHandler_100
podzielone na: 50 X 1 = 50 rodzaj: NominalHandler_50
Rozłóż na drobne 430 $
podzielone na: 100 X 4 = 400 rodzaj: NominalHandler_100
podzielone na: 10 X 3 = 30 rodzaj: NominalHandler_10

6. Zastosowanie w kodzie java:
- java.util.logging.Logger#log ()
- javax.servlet.Filter#doFilter ()
- Spring security filter chain