Introduzione agli anti-pattern

Stai visualizzando la documentazione di Apigee e Apigee hybrid.
Visualizza la documentazione di Apigee Edge.

Questa sezione riguarda gli antipattern comuni che si verificano quando viene eseguito il deployment dei proxy API su Apigee.

Che cos'è un antipattern?

Un antipattern è una pratica di progettazione del software inefficace o controproducente, in altre parole, l'opposto di una "best practice". In altre parole, un antipattern è qualcosa che il software ti consente di fare, ma che potrebbe avere un impatto negativo a livello funzionale o di prestazioni.

Ad esempio, considera "Classe/oggetto Dio", che suona onnipotente. Nella programmazione orientata agli oggetti, una god class è una classe che controlla troppe classi per una determinata applicazione, come illustrato dal seguente albero di riferimento:

Figura 1: classe God

Come illustrato nell'immagine, la classe god utilizza e fa riferimento a troppe classi.

Il framework su cui è stata sviluppata l'applicazione non impedisce la creazione di una classe di questo tipo, ma presenta molti svantaggi, i principali sono:

• Difficile da mantenere
• Single point of failure durante l'esecuzione dell'applicazione

Di conseguenza, una classe di questo tipo è un antipattern che dovresti evitare di creare.

La buona notizia è che puoi identificare questi antipattern e correggerli con best practice appropriate, che consentiranno alle API che implementi su Apigee di servire al meglio il loro scopo previsto.

Riepilogo degli anti-pattern

La seguente tabella elenca alcuni antipattern API comuni:

Categoria	Anti-pattern
Anti-pattern dei criteri	Emissione di token di aggiornamento senza richiamare il flusso di aggiornamento Utilizzare waitForComplete() nel codice JavaScript Impostare un periodo di scadenza lungo per i token OAuth Utilizzare quantificatori greedy nel criterio RegularExpressionProtection Memorizzare nella cache le risposte di errore Memorizzare nella cache dati di dimensioni superiori a 256 KB Richiamare MessageLogging più volte in un proxy API Identificatori con cardinalità elevata nelle norme relative alle quote Configurare una quota non distribuita Riutilizzare un criterio Quota Utilizzare il criterio RaiseFault in condizioni inappropriate Accedere in modo errato a intestazioni HTTP multivalore in un proxy API Utilizzare callout di servizio per richiamare il servizio di backend in un proxy non di destinazione
Anti-pattern generici	Richiamare chiamate API di gestione da un proxy API Richiamare un proxy all'interno di un proxy utilizzando un codice personalizzato o come target Gestire le risorse Apigee senza utilizzare la gestione del controllo del codice sorgente Bilanciamento del carico mediante un singolo server di destinazione con MaxFailures impostato su un valore diverso da zero Accedere al payload della richiesta/risposta quando lo streaming è attivato Definire più ProxyEndpoint in un proxy API
Anti-pattern di backend	Consentire un backend lento Disattivare le connessioni HTTP permanenti (keep-alive riutilizzabile)

Scarica l'ebook sugli anti-pattern

Oltre ai link riportati sopra, puoi anche scaricare gli antipattern in formato ebook:

• The Book of Apigee Antipatterns v2.0 (PDF)