• https://springfox.github.io/springfox/docs/current/
• Swagger 의 Spring 구현

The Springfox suite of java libraries are all about automating the generation of machine and human readable specifications for JSON APIs written using the spring family of projects.

• Swagger SpringMVC
• Swagger-UI
• Spring MVC Swagger 튜토리얼 시리즈
  • Spring Rest API with Swagger – Creating documentation Swagger 문서 생성
  • Spring Rest API with Swagger – Exposing documentation Spring REST API를 웹 서비스로 볼 수 있게 해줌
• Spring MVC API 적용 Servlet의 “/“가 아닌 ”/api/*” 형태로 매핑되면 Swagger 적용이 복잡해진다. 최근 버전은 매우 간결해짐.

  // /css/*, /js/* 등에 대한 핸들러 추가.
  @Override
  protected void addResourceHandlers(ResourceHandlerRegistry registry) {
    registry.addResourceHandler("css/**", "js/**", "lib/**", "images/**", "swagger-ui.js")
      .addResourceLocations(WEB_JAR_RESOURCE_LOCATION,
          WEB_JAR_RESOURCE_LOCATION + "css/",
          WEB_JAR_RESOURCE_LOCATION + "js/",
          WEB_JAR_RESOURCE_LOCATION + "lib/",
          WEB_JAR_RESOURCE_LOCATION + "images/")
      .setCachePeriod(0);
    super.addResourceHandlers(registry);
  }
   
  @ApiIgnore
  @Controller
  public class SwaggerController {
    @Autowired
      private ResourceLoader resourceLoader;
   
    @RequestMapping("/swagger")
      public void swagger(HttpServletResponse response) throws IOException {
        final Resource swaggerHtmlResource =
          resourceLoader.getResource("classpath:/META-INF/resources/sdoc.jsp");
   
        final String swaggerHtmlContents =
          CoupangIOUtils.toString(swaggerHtmlResource.getInputStream(), "UTF-8");
        final String refinedHtml = swaggerHtmlContents
          .replaceAll("http://swagger.wordnik.com", "/api/swagger");
   
        response.setContentType("text/html; charset=UTF-8");
        final PrintWriter writer = response.getWriter();
        writer.write(refinedHtml);
        writer.close();
      }
  }

• Setting Up Swagger 2 with a Spring REST API Spring REST API에 Swagger 2 설정하기
• Spring REST Docs Versus SpringFox Swagger for API Documentation - DZone Java