클린 아키텍처를 적용한 스프링 기반 애플리케이션

클린 아키텍처는 관심사의 분리(Separation of Concerns)에 기반하여 애플리케이션을 구조한다. 상위 수준의 추상화 및 정책을 하위 수준의 기술 의존 코드와 분리하고, 소스 코드 의존성을 바깥에서 안쪽으로 향하도록 만든다. 그 결과 코드는 테스트하기 훨씬 쉬워지고, 기술 선택이나 환경 변화가 생겨도 유연하게 대응할 수 있다.

하지만 실제 구현 단계에 이르면, 수많은 난관이 생기고 질문도 많이 떠오른다. "어디서부터 시작해야 할까?", "프로젝트 구조는 어떻게 잡아야 하지?", "스프링 기반 애플리케이션에 클린 아키텍처 원칙을 어떻게 적용하면 좋을까?" 등등 같은 질문이 당연히 생기기 마련이다.

클린 아키텍처를 제안한 로버트 C. 마틴(일명 밥 아저씨)이 직접 작성한 블로그 글과 책, 그리고 강연 영상들이 있어서 개념적인 도움을 얻을 수는 있다. 그런데 문제는, 이 자료들에서 소스 코드 구조나 세부 구현 예시 같은 실질적인 지침이 거의 제시되지 않는다는 점이다. 이 때문에 스프링 프로젝트나 현대적인 개발 환경에서 어떻게 적용해야 할지 구체적인 코드 수준의 설명이 부족하다는 아쉬움이 있었다. 나도 처음에는 "도대체 예제 코드 없이 이걸 어떻게 구현하라는 거지?" 라는 생각에 당혹감과 약간의 분노를 느끼기도 했는데, 결국 지난 몇 년 동안 다양한 시도를 거치며 일부 원칙을 준수하고 내 상황에 가장 잘 맞는 접근 방식을 나름 찾아냈다.

이 글은 클린 아키텍처를 스프링 기반 애플리케이션에 적용해보고 싶은 분들을 위해 "좀 더 실용적이고 간소화된 클린 아키텍처"를 설명하기 위해 작성했다. 비즈니스 로직과 외부 기술을 어떻게 분리하고 조직화해야 하는지 예제로 살펴보며, 왜 이런 구조가 유지보수성과 확장성에 유리한지를 구체적으로 설명하려고 노력했다. 클린 아키텍처가 다소 추상적이라 느껴졌던 분들에게, "실제 코드로 어떻게 구현할 수 있을까?" 라는 궁금증을 풀어주는 좋은 사례가 되었으면 좋겠다.

https://www.linkedin.com/pulse/클린-아키텍처를-적용한-스프링-기반-애플리케이션-springrunner-hpnzc/