Filtering for API parts in swagger

前端 未结 2 1088
广开言路
广开言路 2021-01-04 18:52

I have a REST API and springfox swagger v2.6.1 included and working. But now, I would like to not always display all the controllers I have, because some of them are very te

2条回答
  •  轻奢々
    轻奢々 (楼主)
    2021-01-04 19:49

    Some of the options I can think of

    1. You can add Authentication to different endpoints using SpringSecurity and make the endpoints not accessible at all(But will be visible in Swagger UI).

    2. The drop down you are mentioning on the top can be configured something like this

      @Bean
      public Docket orderApi() {
          // This will group the endpoints strting with /order.   
          // And it will be visible as a separate group in the drop down(In Swagger UI) 
          // with the name 'order' as specified in the groupName(..)
          return new Docket(DocumentationType.SWAGGER_2)
                  .groupName("order")
                  .apiInfo(metadata())
                  .select()
                  .paths(PathSelectors.ant("/order/**"))
                  .build();
      }
      
      @Bean
      public Docket orderValidationApi() {
          return new Docket(DocumentationType.SWAGGER_2)
                  .groupName("product")
                  .apiInfo(metadata())
                  .select()
                  .paths(PathSelectors.ant("/product/**"))
                  .build();
      }
      
    3. You can completely exclude the endpoint from being visible in Swagger UI with someting like this in your Docker configuration

         return new Docket( DocumentationType.SWAGGER_2 )
              .select()
                  .apis( RequestHandlerSelectors.any() )
                  .paths(PathSelectors.regex("(?!/error).+")).paths(PathSelectors.regex("(?!/product).+"))
                  .build()
              .apiInfo( metadata() );  
      

      This will make all the endpoints which are not /error and /product available. you can filter out endpoints like this.

提交回复
热议问题