# spring-rest-docs

17개의 포스트

Spring REST Docs - 2

ControllerTest의 통합테스트에서 단위테스트로의 변환기

2023년 4월 9일
·
0개의 댓글
·
post-thumbnail

[Kakao Cloud School] 16번째 회고록

카카오 클라우드 스쿨에서의 교육이 끝나가고 있습니다. 여태까지 공부하면서 그냥 되는대로 개발하는 마음가짐을 줄이기 위해 부단히 노력했지만 아직 많이 부족함을 느낍니다. 항상 무엇을 위해서, 왜 개발하는지를 생각하며 교육이나 프로젝트를 진행하기로 다짐하였습니다.

2023년 2월 21일
·
0개의 댓글
·

[Spring REST Docs] 적용 과정 및 가이드 - 2

앞서 작성한 테스트 코드로는 중복이 많이 발생할 수 있어서 이를 방지하기 위해 리팩토링을 진행하였다.Group API를 작성하며 관련 controller test를 리팩토링한 구조를 적용하여 만들었다. 그리고 현재 구조에서의 테스트 코드 작성법 및 REST doc 작성

2023년 1월 29일
·
0개의 댓글
·

Rest Docs와 Swagger

Rest Docs와 Swagger를 간단히 비교하고 간단히 저의 생각을 정리해봅니다.프로덕션 코드에 영향이 없다.통합 테스트 코드를 작성해서 문서가 생성되기 때문에 프로덕션 코드에 어떠한 영향을 주지 않는다.테스트 코드가 성공해야 문서 작성이 가능하다.문서를 위해서 테

2023년 1월 13일
·
0개의 댓글
·
post-thumbnail

Spring Rest Docs 초기 설정 하기 (HTML 파일 없애기)

처음에 Spring Rest Docs 설정해볼 때 생각보다 뭔가 쉽게 되지 않았었습니다.블로그들을 참고해서 설정을 했더니 잘못된 정보들도 많이 있었는지 설정을 하고 난 후에도 만족스럽지 않은 부분이 있었고, 공식문서를 참고해서 제대로된 설정을 완료할 수 있었습니다.삽질

2022년 12월 21일
·
0개의 댓글
·

Spring REST Docs - 1

Spring REST Docs를 진행하며 발생했던 문제점들

2022년 12월 16일
·
0개의 댓글
·
post-thumbnail

[삽질기록] 온갖 잡다한 삽질기 모음 1🤦🏻‍♀️

프로젝트를 진행하면서 기억에 남는 삽질기를 기록했습니다. 혹시나 틀린 부분이 있다면 지적해주시면 감사하겠습니다. 🙇🏻‍♀️

2022년 10월 22일
·
3개의 댓글
·
post-thumbnail

[Spring] API 문서화

API 문서화 API 문서화 클라이언트가 REST API 애플리케이션에 요청을 전송하기 위해서 알아야 하는 요청정보(요청 URL, Request Body, Query Parameter 등)을 문서로 정리한것 API사용을 위한 정보가 담겨있는 문서를 API문서

2022년 9월 30일
·
0개의 댓글
·
post-thumbnail

API 문서화와 Spring Rest Docs 사용기

클라이언트가 REST API 애플리케이션에 요청을 전송하기 위해서 알아야 되는요청 정보(요청 URI, request body, query parameter 등)를 정리하여 문서화 하는 것.API 문서 / API 스펙(사양, Specification) : API 사용을

2022년 8월 7일
·
0개의 댓글
·
post-thumbnail

Spring MVC API 문서화

시작하게 된 계기 및 다짐 😮이번 코드스테이츠의 백엔드 엔지니어링 개발자 부트캠프에 참여하게 되면서 현직개발자 분들의 빠른 성장을 위한 조언 중 자신만의 블로그를 이용하여 배운 것 들을 정리하는게 많은 도움이 된다 하여 시작하게 되었다.그 날 배웠던 것을 길지 않아도

2022년 7월 30일
·
0개의 댓글
·
post-thumbnail

[Spring] Spring Rest Docs Unresolved reference: snippetsDir 해결하기

일단 요약하면, 위 에러는 Spring Rest Docs 를 사용시 spring starter에서 자동으로 생성하는 설정 파일 때문에 발생하는 에러이다.build.gradle.kts를 고치면 해결된다.위 설정을 아래 처럼 바꾸면 해결된다.간단하게 해결!

2022년 7월 5일
·
0개의 댓글
·
post-thumbnail

Spring Rest Docs VS Swagger

모든 기술이 그렇겠지만 이 역시 장전점이 있는 부분이라서나는 스웨거를 추구했지만 팀원들이 Rest Docs를 사용하자고 해서선택하게 되었다. 장단점을 알아보자.우리 프로젝트는 문서화 도구로 Markdown이 아닌 AsciiDoc을 사용했다.ATDD 교육 과정에서 사용

2022년 4월 13일
·
0개의 댓글
·
post-thumbnail

[Spring] Spring rest docs 적용기(gradle 7.0.2)

gradle 7 버전에서 spring rest docs 적용 방법과 겪은 문제

2021년 7월 6일
·
8개의 댓글
·

API 문서 자동화 - Spring REST Docs

API 문서를 자동화 도구로는 대표적으로 Spring REST Docs와 Swagger가 있다. 흔히 두 가지를 두고 무엇을 사용할까 고민하실 것이다. 이번 글에서는 Spring REST Docs를 왜 사용하고, 어떻게 사용하는지 알아볼 것이다. Swagger는 다음

2020년 11월 12일
·
0개의 댓글
·
post-thumbnail

Spring Rest Docs와 Open Api (Swagger)

안녕하세요! 오늘은 Spring 진영의 문서화 프레임워크인 Spring Rest Docs와 Swagger를 비교하는 글을 작성해 볼까 합니다. Peloton 프로젝트 진행 중에 문서화와 관련해서 고민했던 부분들을 정리 해보았어요. 함께 공유해보면 좋을 것 같아요.Spr

2020년 9월 14일
·
4개의 댓글
·