프레임워크/스프링 프레임워크

asciidoctor 를 통한 Spring REST Docs 자동 생성 세팅하기

Spring REST Docs 개요 RESTful 서비스의 문서 작성을 돕는다. Spring MVC Test 와 함께 자동 생성된 스니펫과 Asciidoctor 로 쓰여진 수기 문서를 조합한다. Swagger 와 같은 도구에 의해 만들어진 문서화의 한계로부터 해방시켜준다. 정확하고, 간결하고, 잘 구조화된 문서를 생성하는 것을 돕는다. 이 문서화 방법은 사용자가 가장 쉬운 방법으로 정보에 접근할 수 있도록 돕는다. Spring Boot Config 스프링 부트에서는 @AutoConfigureRestDocs 라는 애노테이션을 제공하여 테스트에 있는 Spring REST Docs 를 강화한다. build.gradle 세팅 방법 plugins 세팅하기 plugins { // Asciidoctor id 'org..

Spring REST Docs + asciidoctor 로 문서 자동 생성해보기

Spring REST Docs 개요 RESTful 서비스의 문서 작성을 돕는다. Spring MVC Test 와 함께 자동 생성된 스니펫과 Asciidoctor 로 쓰여진 수기 문서를 조합한다. Swagger 와 같은 도구에 의해 만들어진 문서화의 한계로부터 해방시켜준다. 정확하고, 간결하고, 잘 구조화된 문서를 생성하는 것을 돕는다. 이 문서화 방법은 사용자가 가장 쉬운 방법으로 정보에 접근할 수 있도록 돕는다. Spring Boot Config 스프링 부트에서는 @AutoConfigureRestDocs 라는 애노테이션을 제공하여 테스트에 있는 Spring REST Docs 를 강화한다. build.gradle 세팅 방법 plugins 세팅하기 plugins { // Asciidoctor id 'org..

AutoConfigureMockMvc 에서 한글이 제대로 인식되지 않을 때

원인 (추정) 스프링 프레임워크 최신 버전에서 APPLICATION_JSON_UTF8 상수가 Deprecated 된 것 때문이라고 추정한다. 해결 방법 아래와 같은 커스텀 애노테이션을 작성하면 된다. /** * @AutoConfigureMockMvc 에 UTF-8 인코딩 필터를 적용한다. * * Spring 에 존재하던 APPLICATION_JSON_UTF8 상수가 Deprecated 되어 * @AutoConfigureMockMvc 를 이용할 경우, 한글 인코딩 문제가 발생한다. */ @Target(ElementType.TYPE) @Retention(RetentionPolicy.RUNTIME) @Documented @AutoConfigureMockMvc @Import(AutoConfigureUtf8Moc..

스프링부트 개발도구(spring-boot-devtools) 정리

소개 스프링부트 개발을 더욱 쾌적하게 해주는 도구이다. 대표적인 기능으로는 다음과 같은 기능이 있다. 스프링 부트 Restart: 재시작 시간을 단축해준다. 자동 재시작: 클래스 패스에 있는 파일이 변경되었을 때, 자동으로 애플리케이션을 재시작한다. LiveReload: 리소스 변경사항을 브라우저에 즉각 반영해준다. 캐시 무효화: 디폴트 설정으로 동작하는 캐싱 기능들을 꺼준다. 공식 문서 Restart vs Reload 스프링부트는 재시작할 때 2개의 클래스 로더를 사용한다. base classloader 와 restart classloader 가 있다. 서드파티 라이브러리와 같은 변하지 않는 클래스는 base classloader 에 로드되고, 내가 현재 개발하는 클래스들은 restart classlo..