3) Ajout d'annotations swagger pour détailler la documentation générée

src/main/java/greetings/Application.java

@@ -5,6 +5,8 @@
 import org.springframework.context.annotation.Bean;
 import springfox.documentation.builders.PathSelectors;
 import springfox.documentation.builders.RequestHandlerSelectors;
+import springfox.documentation.service.ApiInfo;
+import springfox.documentation.service.Contact;
 import springfox.documentation.spi.DocumentationType;
 import springfox.documentation.spring.web.plugins.Docket;
 import springfox.documentation.swagger2.annotations.EnableSwagger2;
@@ -24,6 +26,7 @@ public Docket api() {
                 .apis(RequestHandlerSelectors.any())
                 .paths(PathSelectors.regex("/greeting.*"))
                 .build()
+                .apiInfo(new ApiInfo("Greetings Api Documentation", "Documentation of the awesome greetings API.", "1.0", "urn:tos", new Contact("", "", ""), "Apache 2.0", "http://www.apache.org/licenses/LICENSE-2.0"))
                 .useDefaultResponseMessages(false);
     }
 }

src/main/java/greetings/Greeting.java

@@ -1,8 +1,13 @@
 package greetings;
 
+import io.swagger.annotations.ApiModelProperty;
+
 public class Greeting {
 
+    @ApiModelProperty(value = "The request number", position = 0)
     private final long id;
+
+    @ApiModelProperty(value = "The greeting content", position = 1)
     private final String content;
 
     public Greeting(long id, String content) {

src/main/java/greetings/GreetingController.java

@@ -1,5 +1,8 @@
 package greetings;
 
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
+import io.swagger.annotations.ApiParam;
 import org.springframework.http.MediaType;
 import org.springframework.web.bind.annotation.RequestMapping;
 import org.springframework.web.bind.annotation.RequestMethod;
@@ -8,14 +11,16 @@
 
 import java.util.concurrent.atomic.AtomicLong;
 
+@Api(tags = "Greetings", description = "Greets the user by it's name")
 @RestController
 public class GreetingController {
 
     private static final String TEMPLATE = "Hello, %s!";
     private final AtomicLong counter = new AtomicLong();
 
+    @ApiOperation(notes = "A longer description of this greeting method. \n\nIt may use `markdown` notation.", value = "greeting")
     @RequestMapping(value = "/greeting", method = RequestMethod.GET, produces = MediaType.APPLICATION_JSON_UTF8_VALUE)
-    public Greeting greeting(@RequestParam(value = "name", defaultValue = "World") String name) {
+    public Greeting greeting(@ApiParam("The name to greet") @RequestParam(value = "name", defaultValue = "World") String name) {
         return new Greeting(counter.incrementAndGet(),
                 String.format(TEMPLATE, name));
     }