Che cos'è la Clean Architecture? Com'è strutturata e come funziona?

Question

IT Interview Practice · Accepted Answer

## Che cos'è la Clean Architecture?

La **Clean Architecture** organizza il software attorno al comportamento aziendale, separandolo da interfacce utente, database e framework. Il suo obiettivo è ridurre l'effetto dei cambiamenti tecnologici sulle regole importanti dell'applicazione.

Per esempio, «un ordine consegnato non può essere annullato» è una regola aziendale. Rimane la stessa sia che il cliente utilizzi un sito web sia che usi un'applicazione mobile, indipendentemente dalla tecnologia di memorizzazione.

## Parti principali

La Clean Architecture viene comunemente rappresentata come cerchi disposti dall'interno verso l'esterno:

- **Entità:** Contengono i dati e le regole aziendali fondamentali, come un ordine e le condizioni per annullarlo.
- **Casi d'uso:** Coordinano una specifica operazione dell'applicazione, come recuperare un ordine, richiederne l'annullamento e salvare il risultato.
- **Adattatori di interfaccia:** Convertono i dati tra logica aziendale e sistemi esterni. Un controller trasforma una richiesta HTTP nell'input dell'operazione di annullamento; un adattatore di memorizzazione trasforma i dati dell'ordine in query al database.
- **Framework e strumenti:** Tecnologie poste al margine esterno, come il framework web o il sistema di database.

**La regola essenziale è che il codice interno non deve dipendere dal codice esterno.** Un caso d'uso può lavorare con un'interfaccia di memorizzazione degli ordini definita sul lato aziendale; un adattatore esterno implementa tale interfaccia con una tecnologia specifica.

## Esempio: annullare un ordine

Quando un cliente richiede un annullamento, il controller chiama il caso d'uso corrispondente. Quest'ultimo recupera l'ordine tramite un'interfaccia di accesso ai dati, quindi chiede all'oggetto ordine di verificare se l'annullamento è consentito.

Se l'ordine non è stato consegnato e soddisfa le condizioni, il suo stato passa ad annullato. Il caso d'uso richiede di salvare la modifica, l'adattatore del database esegue la scrittura e il controller restituisce il risultato al cliente.

Durante l'esecuzione, la logica aziendale può comunque chiamare un adattatore attraverso un'interfaccia collegata all'avvio. La regola delle dipendenze rivolte verso l'interno riguarda i rapporti tra componenti del codice; non significa che dati o chiamate possano viaggiare in una sola direzione.

## Vantaggi

- **Test delle regole più semplici:** Gli annullamenti consentiti e quelli rifiutati possono essere verificati con dati in memoria, senza avviare un server web o un database.
- **Una collocazione chiara per il comportamento aziendale:** Le regole non sono sparse tra controller e query, quindi sono più facili da leggere e modificare in modo coerente.
- **Meno impatto dai cambiamenti tecnologici:** La sostituzione di una libreria di memorizzazione o di un gestore delle richieste interessa soprattutto i componenti esterni, se i contratti aziendali rimangono invariati.

## Limiti

- **Più componenti:** Interfacce, casi d'uso e codice di conversione dei dati richiedono tempo per essere scritti e mantenuti.
- **I confini richiedono disciplina:** Se un caso d'uso utilizza direttamente tipi specifici di un framework o di una libreria per il database, la logica aziendale torna a dipendere dalla tecnologia esterna.

## Quando usarla?

La Clean Architecture è utile per sistemi con comportamenti aziendali complessi, una lunga vita di sviluppo e frequenti esigenze di test. Per una piccola applicazione che legge e scrive solo poche tabelle, una struttura più semplice può essere più facile da gestire. Non è necessario creare ogni cerchio o cartella se non aiuta a separare responsabilità reali.

Che cos'è la Clean Architecture?

Parti principali

Esempio: annullare un ordine

Vantaggi

Limiti

Quando usarla?

Domande correlate