오늘의하루

개발자로 일하다 보면 코드를 작성하고 API를 설계하는 것만큼이나 문서화하는 과정이 중요하다는 걸 깨닫게 되는데 문서화는 단순히 기록하는 것이 아니라 팀원이나 다른 개발자와의 소통을 원활하게 하는 핵심 도구로 작용합니다.그러나 문서를 작성하는 과정에서 실수가 발생할 수 있으며 이를 제대로 검증하지 않으면 작은 오류가 큰 오해로 이어질 수 있기 때문에 이 글에서는 두 가지 문서화 방식을 비교하며 검증 과정이 왜 필요한지 살펴보겠습니다.1. 검증 없이 기록만 남기는 문서화아래는 검증 없이 API의 요청과 응답 형식만을 문서화한 코드입니다.public RestDocumentationResultHandler getTest() { return document("test", requestParam..

초기세팅 java = 1.8 spring boot = 2.7.14 db = oracle build tool = gradle 프로젝트 세팅하면서 알게 된 점 spring boot 버전을 낮추는 법 id 'org.springframework.boot' version '2.7.14' spring boot에서 java 버전을 낮추는 법 java { sourceCompatibility = '1.8' } spring boot에서 servlet 인코딩 관련된 속성의 의미 server.servlet.encoding.charset=UTF-8 server.servlet.encoding.force=true server.servlet.encoding.enabled=true force 속성 : 서블릿 요청 및 응답에 대해 강제..