Introduzione agli anti-pattern

Stai visualizzando la documentazione di Apigee Edge.
Vai alla documentazione di Apigee X. info

Questa sezione riguarda gli antipattern comuni osservati all'interno dei proxy API di cui è stato eseguito il deployment sulla piattaforma Apigee Edge.

La buona notizia è che ciascuno di questi antipattern può essere identificato e corretto con le best practice appropriate. Di conseguenza, le API di cui è stato eseguito il deployment su Edge avrebbero svolto lo scopo previsto e avrebbero un rendimento migliore.

Riepilogo degli antipattern

La tabella seguente elenca gli antipattern in questa sezione:

Categoria	Anti-pattern
Anti-pattern dei criteri	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 i dati di dimensioni superiori a 512 kB Eseguire il logging dei dati su server di terze parti utilizzando il criterio JavaScript Utilizzo di una versione non conforme di JSONPath Richiama MessageLogging più volte in un proxy API 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 invocare il servizio di backend in un proxy senza target Utilizzo di criteri OAuth 1.0, che sono stati ritirati. Consulta la sezione Ritirai.
Anti-pattern delle prestazioni	Mantenere il deployment dei proxy API NodeJS inutilizzati
Anti-pattern generici	Eseguire chiamate all'API di gestione da un proxy API Richiamare un proxy all'interno di un proxy utilizzando codice personalizzato o come target Gestire le risorse Edge senza utilizzare la gestione del controllo del codice sorgente Definire più host virtuali con lo stesso alias host e numero di porta 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 è attivo Definire più ProxyEndpoint in un proxy API
Anti-pattern di backend	Consentire un backend lento Disattivare le connessioni HTTP permanenti (keep-alive riutilizzabile)
Antipattern di Edge for Private Cloud	Aggiungere informazioni personalizzate allo schema di proprietà di Apigee nel database Postgres

Scarica l'ebook sugli antipattern

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

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

Che cos'è un antipattern?

Wikipedia definisce un antipattern di software come:

format_quote

In ingegneria del software, un antipattern è uno schema che può essere di uso comune, ma che è inefficace e/o controproducente nella pratica.

format_quote

In parole povere, un antipattern è un'azione che il software consente all'utente di eseguire, ma che può avere un impatto negativo a livello di funzionalità, manutenzione o prestazioni.

Ad esempio, prendi in considerazione la "classe/l'oggetto Dio" dal suono onnipotente.

In termini di programmazione orientata agli oggetti, una classe dio è una classe che controlla troppe classi per una determinata applicazione.

Ad esempio, considera un'applicazione con la seguente struttura ad albero di riferimento:

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, tra cui i principali:

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

Di conseguenza, la creazione di questo tipo di classe deve essere evitata. Si tratta di un antipattern.

Pubblico di destinazione

Questa sezione è pensata per gli sviluppatori di Apigee Edge che si occupano della progettazione e dello sviluppo di proxy API per i loro servizi durante il ciclo di vita. Idealmente, dovrebbe essere utilizzata come guida di riferimento durante il ciclo di sviluppo dell'API e la risoluzione dei problemi.