Client per Servizi Esterni

Il problema

Chiamate HTTP o messaging sparse nel codice duplicano autenticazione, serializzazione, timeout ed error mapping.

Il pattern

Incapsulare la tecnologia di integrazione in un client/adapter che implementa una porta applicativa.

Come funziona

Il client configura base URL, auth, timeout, headers, correlation/tracing e mapping degli errori. Retry e circuit breaker vanno applicati con policy coerenti, non casualmente in ogni chiamata.

Esempio sanitario

Benefici

• Integrazione testabile
• Policy uniformi
• Riduce accoppiamento al protocollo

Trade-off

• Rischio di client God object
• Serve distinguere errori tecnici e semantici

Quando usarlo

Per qualunque dipendenza esterna non banale.

Quando evitarlo

Quando il client espone direttamente al dominio ResponseEntity o JSON grezzo.

Pattern correlati