레넌의 개발 일기

로깅이란? 로깅이란 시스템이 동작할 때 시스템의 상태 및 동작 정보를 시간 경과에 따라 기록하는 것을 의미한다. 로깅이 필요한 이유 개발 과정 혹은 개발 후에 발생할 수 있는 예상치 못한 애플리케이션의 문제 진단 가능 다양한 정보 수집 가능 사용자 로그의 경우 분석 데이터로 활용 가능 하지만 로깅을 하는 단계에서 적절한 수준의 로그 기록 기준을 잡지 못하면 방대한 양의 로그 파일이 생성되는 문제를 겪거나, 의미 있는 로그를 쌓지 못하는 경우가 발생할 수 있다. 결국 효율적으로 로깅을 하는 방법을 이해하는 것이 중요하다. 로깅하는 방법 대표적으로 Log4j 와 Logback이 있다. Log4j는 2015년 개발이 중단되었고, 현재 널리 사용되고 있는 Logback으로 설명하도록 하겠다. Logback은 S..

Spring REST Docs Spring REST Docs는 테스트 코드 기반으로 RESTful 문서생성을 돕는 도구로 기본적으로 Asciidoctor를 사용하여 HTML를 생성한다. Spring MVC 테스트 프레임워크로 생성된 snippet을 사용해서 snippet이 올바르지 않으면 생성된 테스트가 실패하여 정확성을 보장해준다. 왜 REST Docs인가? 인수테스트가 있음에도 컨트롤러 테스트를 작성해야하는 불편함이 있지만, 프로덕션 코드에 의존적이지 않다는 점에서 REST Docs가 더 좋다고 생각한다. 또한, Swagger는 API 동작을 테스트하는 데에 더 특화되어 있다고한다. API 문서화를 통해 스펙을 정의하는 것이 목적이라면, 깔끔하고 명료하게 문서화할 수 있는 REST Docs가 더 좋..