? ?????? ???? ??????? API ???? ?? Swagger 3(OpenAPI)? Spring Cloud Gateway? ???? ??? ?????. Java 21, Spring Boot 3.2 ? Micronaut? ???? ???? ??? ???? ???? ??????.

Swagger/OpenAPI? ???? ??? ??????

?? OAS(OpenAPI ??)? Swagger? ???? API ?? ?????. ? ??? ??? ????.

• ?? ??: ??? ?? ???? ?? ?? ???? ?????.
• ??? ??: ???? API? ?? ???? ???? ? ??? ??? ???? ??? ?????.
• ??? ??? ??: SDK ? ?? ??? ?? ??? ?? ???? API ??? ??????.
• ??? ??: ???, ??? ? ?????? ?? API ??? ?? ??? ??? ?????.
• ???? ??? ? ???: Swagger UI?? API ??? ???? ?? ??? ?????? ???? ????.
• ?? ?? ??: ??? ?? ??? ???? ?????.
• ?? ??: Spring Boot ? Micronaut? ?? ?? ???? ?????? ???? ?????.
• ??? ???: API ???? ?? ???? ?????.
• ?????? ??? ??? ?? ??: ?????? ??? ??? ?? ?? ?? ??? ?????.

Spring Cloud Gateway: ??

Spring Framework 5, Spring Boot 2 ? Project Reactor? ???? ??? Spring Cloud Gateway? ???????? ?? ??? ????? ????? ?? ?? ??? ??? ???.

Spring Cloud Gateway? ?? ??:

?? ?????? Spring Cloud Gateway? ??? ?????.

????? ??? ??? ??? ???? ?????. ???? ??? ?? ??? ??? ?? ? ?? ??? ???? ????? ? ???? ?? ?????.

?????? ??:

?? ??:

1. ?? 21
2. Gradle(?? Maven)
3. Spring Boot 3.2 ??
4. Spring Cloud Gateway? Swagger? ??
5. ??????

??? ??:

1??: Micronaut ?????? ??(Job, Perk, Tag Services)

Micronaut Launcher([?? ??])? ???? job-service, perk-service ? tag-service ? ?? Micronaut ??????? ????. Java ?? Kotlin, ???? ?? Micronaut ??, Swagger UI ? OpenAPI? ???? ?????. Gradle ?? Maven? ?? ??? ?????. ? ????? ??? ??? Swagger UI? ????(?: http://localhost:8081/swagger-ui/index.html? ?? job-service). CLI? ??? ?? ????:

mn create-app --build=gradle_kotlin --jdk=21 --lang=java --test=junit --features=openapi,swagger-ui dev.job.job

(perk-service ? tag-service? ?? ???? ?? ?? ??? ??? ??).

2??: Spring Boot API ????? ??

Spring ???([Spring ???? ?? ??])? ???? Spring Boot ????? ?????. Spring Cloud Gateway, Spring Boot Actuator ? Spring Web? ?? ???? ?????.

3??: Swagger? API ?????? ??

pom.xml(Maven) ?? build.gradle(Gradle)? ??? Springdoc ???? ?????.

dependencies {
    implementation("org.springframework.cloud:spring-cloud-starter-gateway")
    implementation("org.springdoc:springdoc-openapi-starter-webmvc-api:2.8.3")
    implementation("org.springdoc:springdoc-openapi-starter-webflux-ui:2.8.3")
}

Swagger UI? ????? ? ???????? Swagger YAML ??? ?? URL? ????? application.yml? ?????.

springdoc:
  api-docs:
    enabled: true
  swagger-ui:
    enabled: true
    path: /swagger-ui.html
    config-url: /v3/api-docs/swagger-config
    urls:
      - name: Job Service
        url: http://localhost:8081/swagger/job-service-0.0.yml
      - name: Perk Service
        url: http://localhost:8082/swagger/perk-0.0.yml
      - name: Tag Service
        url: http://localhost:8083/swagger/tag-0.0.yml

application.yml:

server:
  port: 8080
spring:
  application:
    name: web-api-gateway

4??: ?????? ??

4?? ??????(3?? Micronaut ??? ? Spring Boot Gateway)? ?? ?????. Gateway? Swagger UI? http://localhost:8080/webjars/swagger-ui/index.html.

??:

??? ??? ?? ??? ???? ? ???? ??????? ????? ?????. Spring Cloud Gateway? ??? ????? ????? ?? Swagger? ?? ??? ??? API ?? ??? ?????. ? ??? ??? ???? ??? ?? ??????. ?? ??? URL? ??????? Swagger YAML ??? ?? URL? ??? ?? ?? ???.

? ??? Spring API Gateway ? Micronaut? ???? API ??????? ??????? ? Swagger UI ??? ?? ?????. ??? ??? PHP ??? ????? ?? ?? ??? ?????!