API描述未在Swagger UI中顯示

Question

我想用Swagger和Spring MVC記錄REST API，

我在Swagger UI中瀏覽/ api-docs URL

就像下圖一樣。

有誰可以幫我解決兩個問題？

1. I don't know why the description isn't display.
2. how can I show all API in same group

SwaggerConfig.java

@Configuration
@EnableSwagger
public class SwaggerConfig {
  private SpringSwaggerConfig springSwaggerConfig;

  @Autowired
  public void setSpringSwaggerConfig(SpringSwaggerConfig springSwaggerConfig){
      this.springSwaggerConfig = springSwaggerConfig;
  }

  @Bean
  public SwaggerSpringMvcPlugin customImplementation(){
    return new SwaggerSpringMvcPlugin(this.springSwaggerConfig)
      .apiInfo(apiInfo())
      .includePatterns(".*/rest.*");
    }

  private ApiInfo apiInfo(){
      ApiInfo apiInfo = new ApiInfo(
      "API description", "API for me", 
      "API terms of service", 
      "ageehuang@gmail.com", "", ""
      );
      return apiInfo;
    }

的pom.xml

jackson-annotations 2.2.3
jackson-databind 2.2.3
jackson-core 2.2.3
guava 14.0
swagger-springmvc 1.0.2
swagger-core_2.10 1.3.7

ServletConifg

.......
@Configuration
@ComponentScan(basePackages = {"config.swagger"})
public class ServletConfig{ 
.......

Controller.java

@Controller
@RequestMapping(value = "/rest/v1")
@Api(value = "CounponController" ,description="SCCCCCC")
public class CouponController {
........

HTTP：//本地主機：8080 /優惠券/ API-文檔

{"apiVersion":"1.0","apis":[{"description":"SCCCCCC","path":"/default/counponcontroller","position":0},{"description":"Coupon Order Controller","path":"/default/coupon-order-controller","position":0},{"description":"Data Controller","path":"/default/data-controller","position":0},{"description":"Ep Controller","path":"/default/ep-controller","position":0}],"authorizations":{},"info":{"contact":"ageehuang@eztravel.com.tw","description":"API for Ez-Conpon","license":"","licenseUrl":"","termsOfServiceUrl":"EzTravel API terms of service","title":"EzTravel"},"swaggerVersion":"1.2"}

如果需要任何信息，請告訴我

我將非常感謝您提供的任何幫助。

Answer 1

我不確定Spring-MVC對Swagger的看法，但我希望你能用我對Swagger 1.5的研究來解決你的情況。 我用你的問題（並分享你的共享圖片）來建立我的，所以我相信它可以為你提供部分幫助。

Answer 2

關於第一個問題，因為你使用錯誤的swagger-core依賴。 嘗試使用以下依賴項com.wordnik:swagger-annotations:1.3.11 1.3.11（gradle artifact representation）

稍后將詳細介紹第二個問題