Framework/Spring

[Spring] Spring REST Docs API 문서 만들기

아래 내용은 Spring REST Docs를 사용하면서 정리해둔 내용입니다. API 문서 자동화 백엔드와 프론트엔드 개발자 사이의 원활한 협업을 위해서는 REST API 명세에 대한 문서화가 잘 되어있어야 한다. 물론 구글 독스, 스프레드 시트, 위키, 노션 등을 사용해서 직접 API 명세를 문서화할 수 있지만, 우리는 개발자 아니겠는가. 자동화를 해야지만 무언가 나도 편하고 간지도 난다. API 문서 작성을 도와주는 자동화 도구가 많은데, Java Spring 진영에서 가장 많이 쓰이는 API 문서 자동화 도구는 크게 Swagger와 Spring REST Docs 이 두 가지가 있다. API 문서 자동화 도구 : Spring REST Docs 테스트 도구 : MockMvc(@WebMvcTest) 문서 ..

2023. 8. 7. 13:32

Framework/Spring

[Spring] Transactional Propagation

트랜잭션을 다루면서 Propagation 설정을 사용하는 일이 있었다. 특히나 REQUIRES_NEW를 사용했는데 무슨 말인지 이해가 되지 않았다. 무슨 부모 spring에서 부모와 트랜잭션을 동일한 범위로 묶지 않기 위해서 사용한다는 말을 했는데.. 아래서 한번 알아보자. Propagation 일단 Propagation의 옵션들을 정리하면 아래와 같다. 옵션 설명 REQUIRED [기본 옵션] 부모 트랜잭션이 존재한다면 부모 트랜잭션에 합류, 그렇지 않다면 새로운 트랜잭션을 만든다. 중간에 자식/부모에서 rollback이 발생된다면 자식과 부모 모두 rollback 한다. REQUIRES_NEW 무조건 새로운 트랜잭션을 만든다. nested한 방식으로 메소드 호출이 이루어지더라도 rollback은 각각..

2023. 8. 2. 20:40