Couplage Swagger 2 Swagger
Nous avons vu qu’une documentation statique était nécessaire et facile à faire avec Spring et que nous pouvions utiliser le navigateur HAL pour exposer les API. Il est aussi possible d’utiliser Swagger 2. Cette section décrit deux utilisations de Swagger 2 dans les projets Spring : une utilisation standard avec Swagger 2 et une utilisation plus avancée avec SpringFox. SpringFox
Swagger permet une génération statique à la compilation et SpringFox une génération dynamique à l’exécution. Nous utilisons parfois les deux conjointement.
1. Utilisation Springfox
Nous allons voir comment utiliser, en alternative à la solution étudiée, l’implémentation Springfox sur notre projet d’exemple.
http://springfox.github.io/springfox/docs/current/
Le projet Springfox automatise la documentation des API JSON pour les API construites avec Spring.
Dépendance Maven :
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>3.0.0</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>3.0.0</version>
</dependency>
Cette classe de configuration est utilisée pour configurer Springfox :
@Configuration...