Fiz o curso Microsserviços na prática: implementando com Java e Spring, foi muito bom, mas queria saber como posso implementar o swagger nesse contexto.
Fiz o curso Microsserviços na prática: implementando com Java e Spring, foi muito bom, mas queria saber como posso implementar o swagger nesse contexto.
Olá! Tudo bem?
Que bom saber que você está gostando do curso de Microsserviços com Java e Spring. Implementar o Swagger em um projeto que utiliza o Eureka é uma ótima ideia para documentar suas APIs de forma clara e interativa.
Para integrar o Swagger em um projeto de microsserviços com Eureka, você pode seguir os seguintes passos:
Primeiro, adicione a seguinte dependência ao seu gateway:
org.springdoc springdoc-openapi-uiEm seguida, adicione a configuração abaixo no arquivo "application.properties":
springdoc.api-docs.enabled=true
springdoc.swagger-ui.configUrl=${server.servlet.contextPath}/v3/api-docs/swagger-config
springdoc.swagger-ui.url=${server.servlet.contextPath}/v3/api-docs
springdoc.swagger-ui.urls[0].name=api-customer
springdoc.swagger-ui.urls[0].url=/customer/v3/api-docs
springdoc.swagger-ui.urls[1].name=api-cart
springdoc.swagger-ui.urls[1].url=/cart/v3/api-docs
springdoc.swagger-ui.urls[2].name=api-product
springdoc.swagger-ui.urls[2].url=/product/v3/api-docs
Para cada serviço você precisa preencher a urlpropriedade com a URL para a definição do openAPI no formato json ou yaml. Para a biblioteca springdoc que usa openAPI 3.0, a URL padrão é /${ServiceContextPath}/v3/api-docs.
Por fim, na interface do Swagger você pode selecionar qual serviço você deseja visualizar:
Espero ter ajudado e bons estudos!