Add spring doc to generate open api doc, open http://127.0.0.1:8080/d…

…ddsample/swagger-ui/index.html to see it on browser.

README.md

@@ -54,4 +54,4 @@ You can use cURL to send the request using an JSON file for the body:
     -H 'Content-Type: application/json;charset=UTF-8' \
     http://localhost:8080/dddsample/handlingReport
 
-See the [api-docs.yaml](/api-docs.yaml) file for a complete API definition.
+open http://127.0.0.1:8080/dddsample/swagger-ui/index.html for a complete API definition.

pom.xml

@@ -123,6 +123,12 @@
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-validation</artifactId>
         </dependency>
+        <!-- doc -->
+        <dependency>
+            <groupId>org.springdoc</groupId>
+            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+            <version>2.5.0</version>
+        </dependency>
         <dependency>
             <groupId>org.apache.commons</groupId>
             <artifactId>commons-lang3</artifactId>

src/main/java/se/citerus/dddsample/interfaces/handling/ws/HandlingReportServiceImpl.java

@@ -1,5 +1,6 @@
 package se.citerus.dddsample.interfaces.handling.ws;
 
+import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.validation.Valid;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -23,6 +24,7 @@
  * of incoming data, and in case of a valid registration attempt, sends an asynchronous message
  * with the information to the handling event registration system for proper registration.
  */
+@Tag(name = "report")
 @RestController
 public class HandlingReportServiceImpl implements HandlingReportService {
   private static final Logger logger = LoggerFactory.getLogger(MethodHandles.lookup().lookupClass());

src/main/java/se/citerus/dddsample/interfaces/tracking/ws/CargoTrackingRestService.java

@@ -1,5 +1,6 @@
 package se.citerus.dddsample.interfaces.tracking.ws;
 
+import io.swagger.v3.oas.annotations.tags.Tag;
 import jakarta.servlet.http.HttpServletRequest;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -23,6 +24,7 @@
 
 import static org.springframework.http.MediaType.APPLICATION_JSON_VALUE;
 
+@Tag(name = "track")
 @RestController
 public class CargoTrackingRestService {
     private static final Logger log = LoggerFactory.getLogger(MethodHandles.lookup().lookupClass());