Tolerant reader (tolerancyjny odbiorca)
Konsument API albo zdarzeń czyta tylko potrzebne pola i ignoruje resztę, więc dostawca może dodawać pola, nie psując go.
Martin Fowler opisuje go jako „bądź ostrożny w tym, co wysyłasz, i liberalny w tym, co przyjmujesz” zastosowane do integracji serwisów. Tolerancyjny odbiorca nie pada na nieznanych polach, nie zależy od kolejności pól i rozsądnie traktuje brak opcjonalnych danych. Ścisła walidacja schematu całej odpowiedzi, częsta przy generowanych klientach, robi odwrotnie.
Razem z consumer-driven contracts, które mówią dostawcy, co czyta każdy konsument, pozwala wypuszczać większość zmian bez wersjonowania API i pasuje do podejścia expand and contract. Waliduj to, czego używasz, przez walidację w runtime; resztę ignoruj.
Źródła
- Martin Fowler: Tolerant Reader martinfowler.com
Powiązane hasła
- Consumer-driven contracts (testy kontraktowe): Każdy konsument API spisuje, czego faktycznie używa, a build dostawcy sprawdza każdą zmianę względem tych oczekiwań przed wydaniem.
- Wersjonowanie API: Nadawanie kontraktowi API jawnych wersji, żeby konsumenci mogli przechodzić na nowe we własnym tempie, a stare wycofywać z wyprzedzeniem.
- Walidacja w runtime (Zod): Sprawdzanie w czasie działania, czy dane z zewnątrz (zapytania, API, pliki, modele) pasują do typu, który zakłada kod.
- Expand and contract (migracje bez przestoju): Zmiana schematu bazy w krokach zgodnych wstecz: dodaj nowy kształt, przenieś kod i dane, a stary kształt usuń dopiero później.
