Я столкнулся с некоторой проблемой генерации документации о чванстве в моем проекте по микросервисам. Когда я добавляю zuul пользовательскую маршрутизацию, документация swagger становится противоречивой.
Примеры:
- RestController:
@RestController
public class Controller {
@PostMapping("/foo")
public void foo() {}
}
Zuul маршруты:
zuul:
routes:
foo:
path: /bar/**
url: http://localhost:8080/foo
Конфигурация Swagger
@Configuration
@EnableSwagger2
public class SwaggerConfig {
@Bean
public Docket api() {
return new Docket(DocumentationType.SWAGGER_2)
.select()
.apis(RequestHandlerSelectors.basePackage("my.package"))
.build();
}
}
- Что мне нужно: Swagger UI отображает / конечная точка бара
- Что я получаю: Swagger UI отображает / foo endpoint (и это бесполезно для разработчиков внешнего интерфейса, поскольку они генерируют свои компоненты во время выполнения с использованием swagger)
Итак, есть ли какое-либо решение, как я могу настроить swagger или zuul, чтобы избежать проблемы?