Printemps RSS
Suivre
Versioning de l'API dans Spring
Spring Framework 7 introduit une prise en charge intégrée du versionnement d'API, répondant à un besoin courant qui nécessitait auparavant une implémentation manuelle. La fonctionnalité fournit des éléments de base essentiels, en se concentrant sur la gestion côté serveur et côté client. Côté serveur, le `ApiVersionStrategy` gère les préférences de versionnement de l'application, en analysant et en validant les requêtes. La configuration se fait via les configurations MVC ou WebFlux, en utilisant des propriétés pour les applications Spring Boot. Les contrôleurs utilisent l'attribut `version` dans `@RequestMapping` et les annotations associées, tandis que les points de terminaison fonctionnels utilisent le prédicat de requête `version`. Côté client, le `ApiVersionInserter` ajoute la version de l'API aux requêtes, permettant une spécification facile de la version. Les capacités de test sont améliorées grâce à la prise en charge dans `RestTestClient`, `WebTestClient` et `MockMvc`. Des indications de dépréciation peuvent être configurées via un gestionnaire de dépréciation. Le framework inclut la prise en charge du versionnement sémantique et des versions de base, améliorant la flexibilité. Pour plus de détails, la documentation officielle et un exemple de projet sont disponibles pour l'expérimentation.