Eclipse MicroProfileСообщество все еще очень хорошо, обеспечивая множество хороших спецификаций для Java MicroServices. а такжеQuarkusсуществуетMicroProfileВстроенная в спецификацию, встроенная поддержкаMicroProfileканонические компоненты.
-
REST Client: клиентский вызов, аналогичныйFeign -
Metricsслужбы мониторинга, аналогичныеActuator -
OpenAPIСервис интерфейса, аналогичныйSpringfox Swagger -
OpenTracingОтслеживание ссылок, похожее наSpring Cloud Sleuth -
ConfigЦентр конфигурации, аналогичныйSpring Cloud Config
Представьте Swagger
<dependency>
<groupId>io.quarkus</groupId>
<artifactId>quarkus-smallrye-openapi</artifactId>
</dependency>
адрес
http://127.0.0.1:8080/swagger-ui
Общие аннотации
-
@Operation: описывает действие по определенному пути или, как правило, метод HTTP. (метод HTTP) -
@APIResponse: Описание операций API из основного ответа. (HTTP-ответ) -
@RequestBody: описывает тело запроса. (HTTP-запрос) -
@Content: Предоставляет схемы и примеры для определенного типа носителя. -
@Schema: позволяет определить типы входных и выходных данных. (Модель) -
@Server: Контейнер для нескольких определений сервера. -
@ServerVariable: представляет переменную сервера, используемую для подстановки шаблона URL-адреса сервера. -
@OpenAPIDefinition: комплексные метаданные, определенные OpenAPI.
Соответствие аннотациям Springfox
-
@ApiParam->@Parameter -
@ApiOperation->@Operation -
@Api->@Tag -
@ApiImplicitParams->@Parameters -
@ApiImplicitParam->@Parameter -
@ApiIgnore->@Parameter(hidden = true)or@Operation(hidden = true)or@Hidden -
@ApiModel->@Schema -
@ApiModelProperty->@Schema
Суммировать
OpenAPIиспользоватьJAX-RS 2.0Приложение генерирует действительныйOpenAPIдокументация. он обрабатывает всеJAX-RSПримечания (включая@Pathа также@Consumes/@Producesаннотация) и используется какJAX-RSвход или выход операцииPOJO.