Introdução aos antipadrões

Está a ver a documentação do Apigee e do Apigee Hybrid.
Veja a documentação do Apigee Edge.

Esta secção aborda os antipadrões comuns que surgem quando os proxies de API são implementados no Apigee.

O que é um antipadrão?

Um antipattern é uma prática de design de software ineficaz ou contraproducente, ou seja, o oposto de uma "prática recomendada". Por outras palavras, um antipadrão é algo que o software lhe permite fazer, mas que pode ter um impacto funcional ou no desempenho adverso.

Por exemplo, considere o "God Class/Object" que soa como omnipotente. Na programação orientada a objetos, uma classe de Deus é uma classe que controla demasiadas classes para uma determinada aplicação, conforme ilustrado pela seguinte árvore de referência:

Figura 1: classe God

Conforme ilustrado na imagem, a classe god usa e faz referência a demasiadas classes.

A framework na qual a aplicação foi desenvolvida não impede a criação de uma classe deste tipo, mas tem muitas desvantagens, sendo as principais as seguintes:

• Difícil de manter
• Ponto único de falha quando a aplicação é executada

Consequentemente, esta classe é um antipadrão que deve evitar criar.

A boa notícia é que pode identificar estes antipadrões e retificá-los com as práticas recomendadas adequadas, o que fará com que as APIs que implementar no Apigee sirvam melhor o seu propósito pretendido.

Resumo dos antipadrões

A tabela seguinte lista alguns antipadrões de API comuns:

Categoria	Antipatterns
Antipatterns de políticas	Emitir tokens de atualização sem invocar o fluxo de atualização Use waitForComplete() no código JavaScript Defina um tempo de expiração longo para os tokens OAuth Use quantificadores gananciosos na política RegularExpressionProtection Respostas de erro de cache Armazenar dados com um tamanho superior a 256 KB na cache Invocar MessageLogging várias vezes num proxy de API Identificadores de cardinalidade elevada na política de quotas Configure a quota não distribuída Reutilize uma política de quotas Use a política RaiseFault em condições impróprias Aceder incorretamente a cabeçalhos HTTP com vários valores num proxy de API Use o destaque de serviço para invocar o serviço de back-end sem proxy de destino
Padrões de solução genéricos	Invocar chamadas da API Management a partir de um proxy de API Invocar um proxy num proxy através de código personalizado ou como alvo Faça a gestão dos recursos do Apigee sem usar a gestão de controlo de origem Equilibrar a carga com um único servidor de destino com MaxFailures definido para um valor diferente de zero Aceda ao payload de pedido/resposta quando o streaming está ativado Defina vários ProxyEndpoints num proxy de API
Antipadrões de back-end	Permitir um back-end lento Desative as ligações HTTP persistentes (manter ativas reutilizáveis)

Transfira o livro eletrónico sobre antipadrões

Além dos links acima, também pode transferir os antipadrões no formato de livro eletrónico:

• O livro de antipadrões da Apigee v2.0 (PDF)