Added swagger configuration.

Author: cevheri

person-service/pom.xml

@@ -70,6 +70,17 @@
             <artifactId>spring-boot-starter-test</artifactId>
             <scope>test</scope>
         </dependency>
+        <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>
 
     </dependencies>
     <dependencyManagement>

person-service/src/main/java/com/cevher/ms/person/config/SwaggerConfig.java

@@ -0,0 +1,37 @@
+package com.cevher.ms.person.config;
+
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import springfox.documentation.builders.ApiInfoBuilder;
+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;
+
+@Configuration
+@EnableSwagger2
+public class SwaggerConfig {
+
+    @Bean
+    public Docket api() {
+        return new Docket(DocumentationType.SWAGGER_2).select()
+                .apis(RequestHandlerSelectors.basePackage("com.cevher.ms.person.web.rest"))
+                .paths(PathSelectors.regex("/.*"))
+                .build().apiInfo(apiEndPointsInfo());
+
+    }
+
+    private ApiInfo apiEndPointsInfo() {
+        return new ApiInfoBuilder().title("Person Service Swagger Documentation")
+                .description("Person API Doc")
+                .contact(new Contact("Cevher Microservices", "", ""))
+                .license("Apache 2.0")
+                .licenseUrl("http://www.apache.org/licenses/LICENSE-2.0.html")
+                .version("1.0.0")
+                .build();
+    }
+}

person-service/src/main/java/com/cevher/ms/person/domain/Person.java

@@ -1,6 +1,7 @@
 package com.cevher.ms.person.domain;
 
 
+import io.swagger.annotations.ApiModel;
 import lombok.AllArgsConstructor;
 import lombok.Data;
 import lombok.NoArgsConstructor;
@@ -14,6 +15,7 @@
 @Data
 @AllArgsConstructor
 @NoArgsConstructor
+@ApiModel(value = "PersonDomain", description = "Person Domain Model for person values")
 public class Person {
     @Id
     @GeneratedValue(strategy = GenerationType.AUTO)

person-service/src/main/java/com/cevher/ms/person/web/rest/PersonController.java

@@ -3,6 +3,9 @@
 import com.cevher.ms.person.domain.Person;
 import com.cevher.ms.person.service.PersonService;
 import com.cevher.ms.person.vm.ResponseTempVM;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
+import lombok.RequiredArgsConstructor;
 import lombok.extern.slf4j.Slf4j;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
@@ -12,11 +15,13 @@
 @RestController
 @RequestMapping("/people")
 @Slf4j
+@RequiredArgsConstructor
+@Api(value = "PersonController", tags = {"person", "service"})
 public class PersonController {
 
-    @Autowired
-    private PersonService personService;
+    private final PersonService personService;
 
+    @ApiOperation(value = "savePerson", notes = "Person Save API", response = Person.class)
     @PostMapping("/")
     public Person savePerson(@RequestBody Person person) {
         log.info("savePerson by PersonController");