update restdocs, move to spring-5

spring-5/pom.xml

@@ -39,6 +39,10 @@
 			<groupId>org.springframework.boot</groupId>
 			<artifactId>spring-boot-starter-webflux</artifactId>
 		</dependency>
+		<dependency>
+			<groupId>org.springframework.boot</groupId>
+			<artifactId>spring-boot-starter-hateoas</artifactId>
+		</dependency>
 		<dependency>
 			<groupId>org.projectreactor</groupId>
 			<artifactId>reactor-spring</artifactId>
@@ -135,6 +139,22 @@
 			<version>${junit.platform.version}</version>
 			<scope>test</scope>
 		</dependency>
+		 <dependency>
+            <groupId>org.springframework.restdocs</groupId>
+            <artifactId>spring-restdocs-mockmvc</artifactId>
+            <scope>test</scope>
+        </dependency>
+         <dependency>
+            <groupId>org.springframework.restdocs</groupId>
+            <artifactId>spring-restdocs-webtestclient</artifactId>
+            <scope>test</scope>
+        </dependency>
+         <dependency>
+            <groupId>org.springframework.restdocs</groupId>
+            <artifactId>spring-restdocs-restassured</artifactId>
+            <scope>test</scope>
+        </dependency>
+        
 
 	</dependencies>
 
@@ -163,6 +183,29 @@
 					</excludes>
 				</configuration>
 			</plugin>
+			<plugin>
+                <groupId>org.asciidoctor</groupId>
+                <artifactId>asciidoctor-maven-plugin</artifactId>
+                <version>${asciidoctor-plugin.version}</version>
+                <executions>
+                    <execution>
+                        <id>generate-docs</id>
+                        <phase>package</phase>
+                        <goals>
+                            <goal>process-asciidoc</goal>
+                        </goals>
+                        <configuration>
+                            <backend>html</backend>
+                            <doctype>book</doctype>
+                            <attributes>
+                                <snippets>${snippetsDirectory}</snippets>
+                            </attributes>
+                            <sourceDirectory>src/docs/asciidocs</sourceDirectory>
+                            <outputDirectory>target/generated-docs</outputDirectory>
+                        </configuration>
+                    </execution>
+                </executions>
+            </plugin>
 		</plugins>
 	</build>
 
@@ -199,6 +242,8 @@
 		<johnzon.version>1.1.3</johnzon.version>
 		<jsonb-api.version>1.0</jsonb-api.version>
 		<geronimo-json_1.1_spec.version>1.0</geronimo-json_1.1_spec.version>
+		<asciidoctor-plugin.version>1.5.6</asciidoctor-plugin.version>
+		<snippetsDirectory>${project.build.directory}/generated-snippets</snippetsDirectory>
 	</properties>
 
 </project>

spring-5/src/main/java/com/baeldung/restdocs/CRUDController.java

@@ -0,0 +1,59 @@
+package com.baeldung.restdocs;
+
+import static org.springframework.hateoas.mvc.ControllerLinkBuilder.linkTo;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import org.springframework.http.HttpHeaders;
+import org.springframework.http.HttpStatus;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PatchMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.ResponseStatus;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequestMapping("/crud")
+public class CRUDController {
+
+    @GetMapping
+    public List<CrudInput> read(@RequestBody CrudInput crudInput) {
+        List<CrudInput> returnList = new ArrayList<CrudInput>();
+        returnList.add(crudInput);
+        return returnList;
+    }
+
+    @ResponseStatus(HttpStatus.CREATED)
+    @PostMapping
+    public HttpHeaders save(@RequestBody CrudInput crudInput) {
+        HttpHeaders httpHeaders = new HttpHeaders();
+        httpHeaders.setLocation(linkTo(CRUDController.class).slash(crudInput.getId()).toUri());
+        return httpHeaders;
+    }
+
+   @DeleteMapping(value = "/{id}")
+    @ResponseStatus(HttpStatus.OK)
+    HttpHeaders delete(@PathVariable("id") long id) {
+        return new HttpHeaders();
+    }
+
+    @PutMapping(value = "/{id}")
+    @ResponseStatus(HttpStatus.ACCEPTED)
+    void put(@PathVariable("id") long id, @RequestBody CrudInput crudInput) {
+
+    }
+
+    @PatchMapping(value = "/{id}")
+    public List<CrudInput> patch(@PathVariable("id") long id, @RequestBody CrudInput crudInput) {
+        List<CrudInput> returnList = new ArrayList<CrudInput>();
+        crudInput.setId(id);
+        returnList.add(crudInput);
+        return returnList;
+    }
+}

spring-5/src/main/java/com/baeldung/restdocs/CrudInput.java

@@ -0,0 +1,66 @@
+package com.baeldung.restdocs;
+
+import java.net.URI;
+import java.util.Collections;
+import java.util.List;
+
+import javax.validation.constraints.NotBlank;
+import javax.validation.constraints.NotNull;
+
+import com.fasterxml.jackson.annotation.JsonCreator;
+import com.fasterxml.jackson.annotation.JsonProperty;
+
+public class CrudInput {
+    
+    @NotNull
+    private long id;
+    
+    @NotBlank
+    private String title;
+
+    private String body;
+
+    private List<URI> tagUris;
+
+    @JsonCreator
+    public CrudInput(@JsonProperty("id") long id, @JsonProperty("title") String title, @JsonProperty("body") String body, @JsonProperty("tags") List<URI> tagUris) {
+        this.id=id;
+        this.title = title;
+        this.body = body;
+        this.tagUris = tagUris == null ? Collections.<URI> emptyList() : tagUris;
+    }
+
+    public String getTitle() {
+        return title;
+    }
+
+    public String getBody() {
+        return body;
+    }
+    
+    public long getId() {
+        return id;
+    }
+
+    public void setId(long id) {
+        this.id = id;
+    }
+
+    public void setTitle(String title) {
+        this.title = title;
+    }
+
+    public void setBody(String body) {
+        this.body = body;
+    }
+
+    public void setTagUris(List<URI> tagUris) {
+        this.tagUris = tagUris;
+    }
+
+    @JsonProperty("tags")
+    public List<URI> getTagUris() {
+        return this.tagUris;
+    }
+
+}

spring-5/src/main/java/com/baeldung/restdocs/IndexController.java

@@ -0,0 +1,21 @@
+package com.baeldung.restdocs;
+
+import static org.springframework.hateoas.mvc.ControllerLinkBuilder.linkTo;
+
+import org.springframework.hateoas.ResourceSupport;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+@RestController
+@RequestMapping("/")
+public class IndexController {
+
+    @GetMapping
+    public ResourceSupport index() {
+        ResourceSupport index = new ResourceSupport();
+        index.add(linkTo(CRUDController.class).withRel("crud"));
+        return index;
+    }
+
+}

spring-5/src/main/java/com/baeldung/restdocs/SpringRestDocsApplication.java

@@ -0,0 +1,12 @@
+package com.baeldung.restdocs;
+
+import org.springframework.boot.SpringApplication;
+import org.springframework.boot.autoconfigure.SpringBootApplication;
+
+@SpringBootApplication
+public class SpringRestDocsApplication {
+
+    public static void main(String[] args) {
+        SpringApplication.run(SpringRestDocsApplication.class, args);
+    }
+}