2015-10-23 3 views
3

Я хочу документирования REST API с Swagger и Spring MVC,описание API не показывают в Swagger UI

Я исследую/апи-DOCS URL в Swagger UI

Так же, как показано ниже изображения.

enter image description here

enter image description here

ли кто-нибудь может помочь мне решить два вопроса?

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", 
     "[email protected]", "", "" 
    ); 
     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://localhost:8080/coupon/api-docs

{"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":"[email protected]","description":"API for Ez-Conpon","license":"","licenseUrl":"","termsOfServiceUrl":"EzTravel API terms of service","title":"EzTravel"},"swaggerVersion":"1.2"} 

Если нужна любая информация, пожалуйста, скажите мне

буду благодарен за любую помощь вы можете предоставить.

+0

Did вы получили какое-либо решение для этого. Я столкнулся с такой же проблемой –

ответ

2

Я не уверен, что Spring-MVC возьмет Swagger, но я надеюсь, что вы могли бы использовать my research on Swagger 1.5, чтобы пролить светлый свет на вашу ситуацию. Я использовал ваши вопросы (и поделился вашим общим изображением), чтобы собрать мои, поэтому я уверен, что он может оказать вам частичную помощь.

1

Что касается первого вопроса, это связано с тем, что вы используете неправильную зависимость от чартов. Попробуйте использовать следующую зависимость com.wordnik:swagger-annotations:1.3.11 (Gradle артефакт представление)

Вывесит подробно о втором вопросе в немного

+0

У меня такая же проблема. и я попытался добавить такую ​​же зависимость, как вы упомянули, но моя проблема не решена. –

Смежные вопросы