Présentation des antimodèles

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Vous consultez la documentation d'Apigee et d'Apigee hybrid.
Consultez la documentation d'Apigee Edge.

Cette section concerne les antimodèles courants qui surviennent lorsque des proxys d'API sont déployés sur Apigee.

Qu'est-ce qu'un antimodèle ?

Un antimodèle est une pratique de conception logicielle qui est inefficace ou contre-productive, c'est-à-dire l'opposé d'une "bonne pratique". En d'autres termes, un antimodèle est une pratique que le logiciel vous autorise à faire, mais qui peut avoir un impact négatif sur la fonctionnalité ou les performances.

Prenons l'exemple de la classe "God Class/Object" aux accents de tout-puissance. Dans la programmation orientée objet, une god class est une classe qui contrôle trop de classes pour une application donnée, comme illustré par l'arborescence de référence suivante :

Comme le montre l'illustration, la god class utilise et référence trop de classes.

Le framework sur lequel l'application a été développée n'empêche pas la création de ce type de classe. Il présente toutefois de nombreux inconvénients, les principaux étant :

• Sa difficulté de gestion
• Son point de défaillance unique lorsque l'application s'exécute

Par conséquent, une telle classe est un antimodèle que vous devez éviter de créer.

La bonne nouvelle, c'est que vous pouvez identifier ces antimodèles et les corriger avec les bonnes pratiques appropriées. Ainsi, les API que vous déployez sur Apigee répondront mieux à leur objectif.

Résumé des antimodèles

Le tableau suivant répertorie des antimodèles d'API courants :

Catégorie	Antimodèles
Antimodèles de règles	Émettre des jetons d'actualisation sans appeler le flux d'actualisation Utiliser waitForComplete() dans le code JavaScript Définir un délai d'expiration long pour les jetons OAuth Utiliser des quantificateurs gourmands en ressources dans la règle RegularExpressionProtection Mettre les réponses d'erreur en cache Stocker les données supérieures à 256 ko dans le cache Appeler MessageLogging plusieurs fois dans un proxy d'API Configurer un quota non distribué Réutiliser une règle de quota Utiliser la règle RaiseFault dans des conditions inappropriées Accéder de façon incorrecte aux en-têtes HTTP à valeurs multiples dans un proxy d'API Utiliser la règle ServiceCallout pour appeler un service de backend sans proxy cible
Antimodèles génériques	Effectuer des appels d'API Management à partir d'un proxy d'API Appeler un proxy dans un proxy à l'aide d'un code personnalisé ou en tant que cible Gérer des ressources Apigee sans utiliser la gestion du contrôle du code source Équilibrer la charge avec un seul serveur cible tout en définissant MaxMaxFailures sur une valeur non nulle Accéder à la charge utile de requête/réponse lorsque le streaming est activé Définir plusieurs ProxyEndpoints dans un proxy d'API
Antimodèles de backends	Tolérer un backend lent Désactiver les connexions HTTP persistantes (keep-alive)

Télécharger l'e-book sur les antimodèles

Outre les liens ci-dessus, vous pouvez également télécharger les antimodèles au format d'e-book :

• Le livre des antimodèles Apigee v2.0 (PDF)