감각적신사 의 멱살잡고 IT

            <!-- https://mvnrepository.com/artifact/io.swagger/swagger-core -->

     <dependency>

                <groupId>io.swagger</groupId>

                <artifactId>swagger-core</artifactId>

                <version>1.5.10</version>

            </dependency>

<build>

                <plugins>

                    ...

                    <plugin>

                        <groupId>com.github.kongchen</groupId>

                        <artifactId>swagger-maven-plugin</artifactId>

                        <version>1.1-SNAPSHOT</version>

                        <configuration>

                            <apiSources>

                                <apiSource>

                                    <locations>com.foo.bar.apis;com.foo.bar.apis.internal.Resource</locations>

                                    <apiVersion>v1</apiVersion>

                                    <basePath>http://www.example.com</basePath>

                                    <outputTemplate>strapdown.html.mustache</outputTemplate>

                                    <outputPath>generated/strapdown.html</outputPath>

                                    <withFormatSuffix>false</withFormatSuffix>

                                    <swaggerDirectory>generated/apidocs</swaggerDirectory>

                                </apiSource>

                            </apiSources>

                        </configuration>

                        <executions>

                            <execution>

                                <phase>compile</phase>

                                <goals>

                                    <goal>generate</goal>

                                </goals>

                            </execution>

                        </executions>

                    </plugin>

                    ...

                </plugins>

            </build> 

@Controller 

@RequestMapping(value = "컨트롤러가 매핑되는 URL PATH", produces = {APPLICATION_JSON_VALUE}) 

@Api(value = "컨트롤러가 매핑되는 URL PATH", description = "controller 에 대한 설명을 써준다") // swagger annotation

public class SampleAPIController {

...

    @ApiOperation(  // swagger annotation

value = "개별 API 에 대한 소개", 

notes = "개별 API 에 대한 설명", 

response = SampleResponseObject.class, responseContainer = "List" 

) 

@ApiResponses(  // swagger annotation

value = { 

@ApiResponse(code = 200, message = "Success Return Results"), 

@ApiResponse(code = 0, message = "Unexpected error") 

} 

) 

@RequestMapping(value = "/{pathVariable}", method = RequestMethod.GET) 

public ResponseEntity<Collection<SampleResponseObject>> sendGetAPI(

@ApiParam(value = "pathVariable 에 대한 설명", required = true) 

@PathVariable String pathVariable, 

@ApiParam(value = "파라미터에 대한 설명") 

@RequestParam(value = "limits", required = false) Integer limits, 

@ApiParam(value = "파라미터에 대한 설명")

@RequestParam(value = "rollbackOptions", required = false) String rollbackOptions,

@ApiParam(value = "Body 에 대한 설명", required = true)

@RequestBody SampleRequestObject sRequestObject

) {

...

}

...

}