# spring-rest-docs
[Kakao Cloud School] 16번째 회고록
카카오 클라우드 스쿨에서의 교육이 끝나가고 있습니다. 여태까지 공부하면서 그냥 되는대로 개발하는 마음가짐을 줄이기 위해 부단히 노력했지만 아직 많이 부족함을 느낍니다. 항상 무엇을 위해서, 왜 개발하는지를 생각하며 교육이나 프로젝트를 진행하기로 다짐하였습니다.
[Spring REST Docs] 적용 과정 및 가이드 - 2
앞서 작성한 테스트 코드로는 중복이 많이 발생할 수 있어서 이를 방지하기 위해 리팩토링을 진행하였다.Group API를 작성하며 관련 controller test를 리팩토링한 구조를 적용하여 만들었다. 그리고 현재 구조에서의 테스트 코드 작성법 및 REST doc 작성
Rest Docs와 Swagger
Rest Docs와 Swagger를 간단히 비교하고 간단히 저의 생각을 정리해봅니다.프로덕션 코드에 영향이 없다.통합 테스트 코드를 작성해서 문서가 생성되기 때문에 프로덕션 코드에 어떠한 영향을 주지 않는다.테스트 코드가 성공해야 문서 작성이 가능하다.문서를 위해서 테
Spring Rest Docs 초기 설정 하기 (HTML 파일 없애기)
처음에 Spring Rest Docs 설정해볼 때 생각보다 뭔가 쉽게 되지 않았었습니다.블로그들을 참고해서 설정을 했더니 잘못된 정보들도 많이 있었는지 설정을 하고 난 후에도 만족스럽지 않은 부분이 있었고, 공식문서를 참고해서 제대로된 설정을 완료할 수 있었습니다.삽질
[삽질기록] 온갖 잡다한 삽질기 모음 1🤦🏻♀️
프로젝트를 진행하면서 기억에 남는 삽질기를 기록했습니다. 혹시나 틀린 부분이 있다면 지적해주시면 감사하겠습니다. 🙇🏻♀️
[Spring] API 문서화
API 문서화 API 문서화 클라이언트가 REST API 애플리케이션에 요청을 전송하기 위해서 알아야 하는 요청정보(요청 URL, Request Body, Query Parameter 등)을 문서로 정리한것 API사용을 위한 정보가 담겨있는 문서를 API문서
API 문서화와 Spring Rest Docs 사용기
클라이언트가 REST API 애플리케이션에 요청을 전송하기 위해서 알아야 되는요청 정보(요청 URI, request body, query parameter 등)를 정리하여 문서화 하는 것.API 문서 / API 스펙(사양, Specification) : API 사용을
Spring MVC API 문서화
시작하게 된 계기 및 다짐 😮이번 코드스테이츠의 백엔드 엔지니어링 개발자 부트캠프에 참여하게 되면서 현직개발자 분들의 빠른 성장을 위한 조언 중 자신만의 블로그를 이용하여 배운 것 들을 정리하는게 많은 도움이 된다 하여 시작하게 되었다.그 날 배웠던 것을 길지 않아도
[Kotlin Spring Boot] Spring Rest Docs 를 포함한 초기 프로젝트 생성 시 빌드 오류 수정하기 - Gradle
Unresolved reference: snippetsDir에 대한 글 작성할 것.
[Spring] Spring Rest Docs Unresolved reference: snippetsDir 해결하기
일단 요약하면, 위 에러는 Spring Rest Docs 를 사용시 spring starter에서 자동으로 생성하는 설정 파일 때문에 발생하는 에러이다.build.gradle.kts를 고치면 해결된다.위 설정을 아래 처럼 바꾸면 해결된다.간단하게 해결!
Spring Rest Docs VS Swagger
모든 기술이 그렇겠지만 이 역시 장전점이 있는 부분이라서나는 스웨거를 추구했지만 팀원들이 Rest Docs를 사용하자고 해서선택하게 되었다. 장단점을 알아보자.우리 프로젝트는 문서화 도구로 Markdown이 아닌 AsciiDoc을 사용했다.ATDD 교육 과정에서 사용
[Spring] Spring rest docs 적용기(gradle 7.0.2)
gradle 7 버전에서 spring rest docs 적용 방법과 겪은 문제
API 문서 자동화 - Spring REST Docs
API 문서를 자동화 도구로는 대표적으로 Spring REST Docs와 Swagger가 있다. 흔히 두 가지를 두고 무엇을 사용할까 고민하실 것이다. 이번 글에서는 Spring REST Docs를 왜 사용하고, 어떻게 사용하는지 알아볼 것이다. Swagger는 다음
Spring Rest Docs와 Open Api (Swagger)
안녕하세요! 오늘은 Spring 진영의 문서화 프레임워크인 Spring Rest Docs와 Swagger를 비교하는 글을 작성해 볼까 합니다. Peloton 프로젝트 진행 중에 문서화와 관련해서 고민했던 부분들을 정리 해보았어요. 함께 공유해보면 좋을 것 같아요.Spr