SI Supply Depot

지난번에 Springdoc 사용법 이래가지고 글도 쓰고 이렇게 쓰면 잘 된다고 했었다. 지금도 프로젝트 새로 만들어서 전에 썼던 글대로 진행을 하면 잘 된다. 하지만 이미 개발이 완료된 어떤 프로젝트가 있었는데 여기에 Springdoc을 적용하려 하니 위와 같은 문제가 발생한다. [WARN ][org.springframework.web.servlet.PageNotFound.noHandlerFound:line1275] - No mapping for GET /swagger-ui/index.html 다 안되는건 아니다. swagger-ui 관련된 기능만 안된다. http://localhost:8080/v3/api-docs/swagger-config -> 200 OK http://localhost:8080/v3..

지난 시간에는 Springdoc을 사용하는 한 사이클에 대해서 봤다면 이번시간에는 어떻게 상세하게 내가 원하는대로 설정을 할 수 있는지에 대해서 알아보겠다. OpenAPI 설정 지난시간에 application.yml 파일에 springdoc을 설정한 부분이다. springdoc: swagger-ui: path: animal.html version: v1 paths-to-match: - /bear/** - /dog/** 여기에 나온 내용들은 문서 맨 아래의 참고에 있는 properties 표에서 내가 원하는 속성을 찾아서 설정을 해줄 수 있다. springdoc에서 샘플로 제공한 application.yml 의 모습은 다음과 같다. (일반적으로 사용할거라고 예상하여 샘플을 만들었으므로 거의 이 모습에서 크..

지난번에 JavaDoc이라던지 JSDoc을 사용하는 방법에 대해서 다룬적이 있었다. 이와 마찬가지 맥락으로 API Docs을 생성하는 방법도 있다. MSA가 유행을 하며 이로 구성된 시스템은 수많은 API Service를 관리해야 한다. 그리고 또한 이 API Service를 사용자들이 쉽게 이용할 수 있어야 한다. 이를 편하게 자동으로 해주는것이 OpenAPI 3.0 spec을 이용하여 구현한 Springdoc이라는 녀석이다. 어떻게 사용하는지 간단히 알아보자. (API Docs을 가능하게 해주는건 크게 Springfox Swagger와 SpringDoc 이렇게 크게 두가지가 있는데 최근 Spring에서 밀고 있는건 이름에서도 느낌이 오겠지만 SpringDoc이다. 이에 대해 자세하게 기술이 된 포스팅..