반복영역 건너뛰기
주메뉴 바로가기
본문 바로가기
제품/서비스
EMS Solution
Features
클라우드 관리
서버관리
데이터베이스 관리
네트워크 관리
트래픽 관리
설비 IoT 관리
무선 AP 관리
교환기 관리
운영자동화
실시간 관리
백업 관리
스토리지 관리
예방 점검
APM Solution
애플리케이션 관리
URL 관리
브라우저 관리
ITSM Solution
서비스데스크
IT 서비스 관리
Big Data Solution
SIEM
AI 인공지능
Dashboard
대시보드
Consulting Service
컨설팅 서비스
고객
레퍼런스
고객FAQ
문의하기
가격
자료실
카탈로그
사용자매뉴얼
회사소개
비전·미션
연혁
2016~현재
2000~2015
인증서·수상
투자정보
재무정보
전자공고
IR자료
새소식
공고
보도자료
오시는 길
채용
피플
컬처
공고
FAQ
블로그
열기
메인 페이지로 이동
블로그
기술이야기
블로그
최신이야기
사람이야기
회사이야기
기술이야기
다양한이야기
데브옵스(DevOps)에 대한 오해, 그리고 진실은?!
잘파세대(Z세대 + 알파 세대)에 대한 모든 것
차정환
2024.02.19
페이스북 공유하기
트위터 공유하기
링크드인 공유하기
블로그 공유하기
SMS를 통한 서버관리는 꼭 이렇게 해야만 한다?!
IT 기술의 빠른 발전 못지않게, 각 세대별 특성도 빠르게 변화하고 있습니다.
특히 몇 해 전부터 'MZ 세대'와 관련한 이슈들이 크게 부각되었습니다. 유튜브나 TV 예능에서의 소재뿐 아니라, 사회 전체적으로도 모두가 관심을 가진 그야말로 '핫'한 주제가 되었죠.
MZ 세대와 관련한 다양한 도서들(출처: 교보문고)
MZ 세대에 대해 이해하고 함께 어울려보려고 노력해서 이제 조금 익숙해져가는 와중에... 이제 'MZ 세대' 보다 중요한 세대가 등장했습니다. 바로 '잘파세대'!
잘파세대는 Z세대와 알파 세대를 합친 말인데요, 소비자로서 그리고 직장의 구성원으로서 정말 중요한 부분을 차지하고 있고 영향력이 더 커질 잘파세대에 대해서 지금부터 자세히 알아보겠습니다.
│ 세대는 어떻게 구분되는가?!
본격적으로 이야기를 시작하기 전에 한 가지 분명히 해야 할 것이 있습니다. 지금부터 알아볼 특징들이 전체를 대표하는 경향이 있긴 하지만, 같은 세대 안에서도 개인차가 있으므로 모든 사람에게 동일하게 적용될 수는 없다는 것이죠.
하지만 이와 동시에 각 세대별 차이는 분명히 존재하기 때문에, 각 세대의 특징과 경향을 앎으로써 서로 더 가까워지기 위한 목적을 가지고 본격적으로 들여다보도록 하겠습니다.
조금씩의 차이는 있지만, 가장 나이가 많은 베이비부머 세대부터 알파 세대에 이르기까지 총 다섯 개의 분류로 세대를 구분하는 것이 일반적입니다. 세대별 구분 기준과 특징은 아래와 같이 정리할 수 있습니다.
베이비부머부터 X세대 초반(1975년생)까지는 그동안의 한국 사회의 가파른 성장을 이끌어온, 이른바 '기성세대'라고 볼 수 있습니다.
한편 그동안 'MZ세대(밀레니얼세대 + Z세대)'로 묶여왔던 밀레니얼 세대는 대세에서 멀어지고, 알파 세대가 새롭게 떠오르며 Z세대와 대세를 이루게 됐습니다.
밀레니얼 세대는 회사 내에서 '주니어급'에서 '중간관리자' 급으로 성장했죠. 따라서 위로는 베이비부머와 X세대를 모셔야 하고, 아래로는 잘파세대를 관리해야 함에 따른 밀레니얼 세대의 고충도 커지고 있습니다
(이 이슈는 나중에 따로 자세히 살펴보도록 하죠)
.
회사 내에서의 세대별 차이에서 오는 에피소드를 극대화한 MZ 오피스 (출처: 쿠팡플레이)
현재 대부분의 회사에서는 X세대 이상의 임원과, 차~부장급 팀장이 된 밀레니얼 세대, 그리고 주니어에서 갓 벗어나 과장급 실무자가 됐거나 주니어급인 Z세대가 어울려 있습니다. 그리고 이들이 알파 세대 고객을 만나 고생하기도 하고요.
그리고 가정에서는 은퇴한 베이비부머 세대를 둔 X세대 후반 ~ 밀레니얼 세대가 결혼해서 알파 세대를 낳은 후 고군분투하고 있고, Z세대는 그런 밀레니얼 시대를 보면서 결혼에 대해 심각하게 고민하는 모습을 흔치않게 볼 수 있습니다.
직장과 가정 모두에서 각 세대가 서로를 이해하며 오래오래 행복하게 살면 좋겠지만, 현실은 그렇지 않죠. 앞에도 언급했듯이 이제 주류가 된 잘파세대를 제대로 알고 함께 어울리기 위한 방법은 무엇일까요?
│ 소비자로서의 잘파세대, 그리고 대응 방안
본격적으로 잘파세대에 대해서 알아보겠습니다. 먼저 그들에게 우리 서비스와 제품을 잘 알리기 위해 '소비자로서의' 잘파세대의 특성을 살펴보죠. 세부적으로 Z세대와 알파 세대의 특성이 차이가 있기 때문에 나눠서 살펴보겠습니다.
Z세대(14세~28세)
Z세대는 소비자로서 세 가지 특성이 있습니다.
▪
디지털 네이티브:
인터넷, 스마트폰, 소셜미디어와 함께 성장한 이들은 소비에 있어서도 다양한 온라인 플랫폼을 적극 활용합니다. 특히 온라인 리뷰와 소셜미디어 추천을 매우 중요하게 여깁니다.
▪
가치 중심의 소비:
제품이나 브랜드가 대표하는 가치와 사회적 책임을 중시합니다. 지속 가능성, 윤리적 생산, 다양성 존중 등이 소비에 있어서 중요한 결정 요소가 됩니다.
▪
개인화된 경험 선호:
Z세대는 자신들의 취향과 관심사에 맞춤화된 제품이나 서비스를 선호합니다.
따라서 기업의 입장에선 우선 콘텐츠 마케팅/인플루언스 마케팅/자체 소셜미디어 운영 등을 통해서 Z세대와의 접점을 최대한 늘려야 합니다. 그리고 철저한 데이터 분석을 통해, 소비자의 취향과 선호를 파악하고 맞춤형 제품과 경험을 제공해야 하죠.
더불어서 기업의 사회적 책임과 지속 가능성 목표를 명확히 하고, 이를 적극적으로 알려야 합니다. 다만, 이때 주의해야 할 것은 '바르게 잘 하고 있는 척' 만 하는 것이 아니라, '실제로 바르게 말하고 행동'해야 합니다. 말과 행동이 다른 기업이나 서비스는 Z세대에게 바로 외면받을 수밖에 없기 때문이죠.
환경 보호를 직접 실천하며 꾸준한 사랑을 받고 있는 Patagonia
Z세대를 대상으로 성공적인 마케팅을 펼친 사례를 간단히 정리해 보면,
▪
나이키:
나이키는 AR(증강현실)을 이용한 신발 피팅 기술과, 소비자가 자신만의 디자인을 할 수 있는 커스터마이징 옵션을 제공하여 좋은 반응을 얻고 있습니다.
▪
Spotify:
Z세대의 음악 취향을 분석하여 개인화된 플레이리스트를 제공하는 것을 통해 많은 사용자를 유지하고 있습니다.
▪
Patagonia:
환경 보호를 중시하는 아웃도어 의류 브랜드로, 지속 가능한 제품 제조 방식과 환경 보호 캠페인을 펼치며 Z세대로부터 큰 지지를 받고 있습니다. 2023년에는 주식 전체를 환경보호 단체에 기부하며 큰 화제가 되기도 했죠.
▪
Beyond Meat:
식물로 만든 대체 육류 제품을 제공하여, 지속 가능한 소비와 동물 복지, 환경 보호에 앞장섬으로써 많은 사랑을 받고 있습니다.
식물로 만든 다양한 육류 제품으로 인기를 끌고 있는 Beyond Meat
Z세대를 위한 마케팅은 다음과 같은 한 마디로 정의할 수 있습니다.
'정말 좋은 목적을 가지고 만든 고객 맞춤형 제품과 서비스를, 소셜미디어를 통해 활발하게 알린다!'
알파 세대(~13세)
알파 세대는 Z세대와 비슷하지만 조금은 다른 특성을 가지고 있습니다.
▪
기술과의 완전한 통합:
알파 세대는 태어난 직후부터 스마트 기기와 AI와 함께 자랐습니다. 따라서 이들에게 최신 기술은 일상의 일부죠
(실제 미국에서 많은 아기들이 처음으로 발음한 것이 '엄마'가 아닌, '알렉사(구글의 AI 서비스)'여서 큰 화제가 되기도 했습니다)
.
▪
교육적 콘텐츠 소비:
아직 성장단계에 있고, 부모의 영향도 있기 때문에 교육적 가치가 있는 콘텐츠를 주로 많이 소비합니다.
▪
가족 구매 결정에 영향:
아직 어린 나이에도 불구하고, 알파 세대가 가족의 구매 결정에 영향을 미치는 경우가 꽤 많습니다.
디지털 기기와 매우 친숙한 알파 세대
알파 세대를 대상으로 성공적인 마케팅과 서비스를 제공하고 있는 사례를 살펴보면,
▪
Duolingo:
언어 학습 앱으로 게임 기능을 통해 교육적 가치와 재미를 동시에 제공하고 있습니다.
▪
Roblox:
아이들이 자신만의 게임을 만들고 다른 사람들과 공유할 수 있는 플랫폼으로, 창의력과 코딩 기술을 향상시킬 수 있어서 많은 사랑을 받고 있습니다.
▪
Amazone Echo Dot Kids Edition:
아이들을 위한 스마트 스피커로, 부모가 컨트롤할 수 있는 콘텐츠와 함께 다양한 교육 콘텐츠를 제공합니다.
▪
LEGO Super Mario:
레고와 닌텐도의 협업으로 만들어진 이 제품은, 게임과 실제 놀이의 결합을 통해 창의력과 문제 해결 능력을 발전시킬 수 있어서 좋은 반응을 얻고 있습니다.
알파 세대에게 큰 사랑을 받고 있는 Roblox (출처: The Irish Times)
결국 위에 살펴본 사례처럼 알파 세대에게 사랑받으려면, 교육적 가치가 있는 제품을 개발하고 가족 친화적 마케팅을 진행하면서 부모의 신뢰를 얻을 수 있는 안전한 디지털 환경을 제공해야 합니다
(유해 콘텐츠 방지, 개인정보 보호 등)
.
잘파세대인 소비자들에게 어떻게 다가갈지 조금 감이 잡히시나요? 함께 살펴본 내용은 극히 기본에 불과하지만, 이번 기회를 통해서 잘파세대 소비자들과 한 걸음이라도 가까워질 있게 되기를 바랍니다.
│ 직장인으로서의 잘파세대, 그리고 대응방안
자 이제, 소비자가 아닌 내 동료로서의 잘파세대를 알아보겠습니다. 단, 알파 세대는 아직 사회에 진출하기 전이 때문에 Z세대를 중심으로 하나씩 살펴보도록 하죠.
2020년대 초반부터 본격적으로 직장 생활을 시작한 Z세대는, 그들만의 독특한 특성과 가치관을 가지고 있습니다. 사실 'MZ 세대'에 특성으로 꼽히는 부분 중에 기성세대가 많이 새로워하고 놀란 특성들 대부분이 'Z세대'의 특성이라고 볼 수 있죠.
직장인으로서의 Z세대 특성은 다섯 가지로 정리할 수 있습니다.
Z세대가 즐겨 사용하는 업무 도구인 Slack
기술에 대한 높은 숙련도
디지털 네이티브인 Z세대는 다양한 기술과 플랫폼을 자연스럽게 사용합니다. Slack이나 Notion 등 효율적인 업무 도구와 소프트웨어를 활용하여 업무를 진행하는 것을 선호하죠
(반면에 전화나 대면 미팅을 꺼리는 경향도 있습니다)
.
자율성과 유연성에 대한 강한 욕구
자율적인 업무 환경과 일과 생활의 균형을 매우 중요시합니다. 유연한 근무시간과 재택근무 옵션을 높은 연봉보다 선호할 정도입니다.
다양성과 포용성에 대한 강조
Z세대는 다양성, 평등, 포용성에 대한 가치를 중요하게 여깁니다. 다양한 배경과 경험을 가진 사람들과의 협업을 중시하며, 모두가 존중받는 직장 문화를 원합니다.
목적과 가치에 대한 추구
단순히 급여를 받는 것에 그치지 않고, 자신이 하는 일이 사회적으로 선하고 긍정적인 영향을 미치는지를 중요하게 여깁니다. 따라서 회사를 선택할 때도 회사의 사회적 책임과 가치에 공감할 수 있는지를 진지하게 고민합니다.
피드백과 성장 기회에 대한 욕구
지속적인 피드백과 자신의 역량을 개발할 수 있는 기회를 중요하게 생각합니다. 특히 본인의 업무 성과에 대한 구체적이고 명확한 피드백을 원하죠. 불투명한 평가절차 및 결과로 인한 Z세대의 퇴사가 늘고 있는 이유입니다.
따라서 Z세대를 회사의 구성원으로 잘 적응시키기 위해서는, 유연한 근무 환경을 제공하고 개인의 성장과 개발을 지원하는 프로그램을 갖추는 것이 중요합니다.
이와 동시에 회사의 사회적 책임에 대해서 어필하고, 다양성과 포용성을 증진할 수 있는 실질적인 실천도 뒷받침되어야 하죠. 그리고 무엇보다 이들의 성과를 정확히 평가하고, 구체적이고, 투명하게 피드백을 줄 수 있는 시스템도 갖춰야 합니다.
Z세대가 선호하는 직장으로 꼽히는 곳들은 대부분 구글과 같이 유연한 근무 환경/자율성 존중/개인의 성장과 개발에 대한 강력한 지원을 하거나, Salesforce나 에어비앤비처럼 사회적 가치와 미션에 대해서 강조하고 직원들과 투명한 커뮤니케이션을 진행하고 있습니다.
신입/주니어급이던 Z세대가 실무의 핵심으로 자리 잡고 있는 가운데, 본인의 이상과 실제에 거리감에 회의를 느낀 Z세대의 이직이나 퇴사도 늘고 있습니다.
또한 퇴사는 하지 않아도 일을 잘하려는 의지 없이 최소한의 업무만 하는 이른바 '조용한 퇴사'도 늘고 있는데요. 조용한 퇴사로 인한 기업의 손실이 약 2,500조에 이른다는 갤럽의 분석도 있습니다.
따라서 모든 기업이 Z세대의 마음을 사로잡고, 그들의 업무 효율을 높이기 위한 빠른 노력이 꼭 필요합니다. 이제 곧 Z세대가 기업 실무진행의 핵심으로 자리 잡을 시기가 오기 때문이죠.
│ 글을 마치며
"요즘 젊은이들은 버릇이 없다."
기원전 1700년에 만들어진 수메르 시대 점토판 문자에 이렇게 쓰여있다고 하죠. 기존 세대와 새로운 세대의 갈등은 오래전부터 존재해왔습니다.
하지만 기술의 발달과 넘치는 정보로 인해서 상황이 옛날과 많이 바뀌었습니다. 앞서 살펴본 대로 잘파세대는 소비자로서도 중요한 위치에 오르고 있고, 회사 내에서도 잘파세대의 역할이 점점 더 중요해지고 있기 때문입니다.
특히 기업을 운영할 때 '기성세대의 노하우를 전수하는 것'보다, '신기술을 빠르게 터득하고 활용하는 것'이 더 중요해졌기 때문에 새로운 세대와 효과적으로 함께 하기 위한 노력이 빠르게 필요합니다.
점심회식을 통해 세대간 어울리기 위한 노력을 이어가고 있는 브레인즈컴퍼니
어려워 보이고 갈 길이 멀어 보일 수도 있지만, 오늘부터 잘파세대를 이해하기 위한 하나씩 실천해 보는 건 어떨까요?
(그렇다고 잘파세대 후배 불러서 저녁회식 같은거 하시면 안 됩니다...)
#잘파세대
#Z세대
#알파세대
#MZ세대
#브레인즈컴퍼니
차정환
온/오프라인 마케팅 브랜딩, 그리고 홍보를 총괄하고 있습니다.
필진 글 더보기
목록으로
추천 콘텐츠
이전 슬라이드 보기
IT 인프라 모니터링 시스템의 컨트롤러 개선기, ArgumentResolver를 통한 중복 제거
IT 인프라 모니터링 시스템의 컨트롤러 개선기, ArgumentResolver를 통한 중복 제거
대규모 IT 인프라를 모니터링하는 도메인에서는 서버나 네트워크 장비와 같은 관리 대상을 통칭하여 타겟(Target)이라고 부릅니다. 이에 따라 대다수의 API는 리소스 식별을 위해 URL 경로(Path Variable)나 쿼리 스트링(Query Parameter)을 통해 targetId를 필수적으로 전달받는 구조를 가지고 있습니다. 이 targetId는 단순한 문자열 식별자가 아니라, 실제 비즈니스 로직이 수행되기 전 반드시 선행되어야 하는 일련의 검증 절차를 요구합니다. 구체적으로는 클라이언트 입력값에 대한 유효성 검사, 해당 ID를 기반으로 한 DB 조회 및 도메인 객체(TargetInfoRecord)로의 매핑, 그리고 해당 타겟에 대한 사용자 접근 권한(Authorization) 확인 과정이 포함됩니다. 프로젝트 초기 구현 단계에서는 이러한 전처리 로직을 각 컨트롤러 메서드 바디 상단에 직접 구현하는 방식을 취했습니다. 하지만 API 엔드포인트가 수십 개로 늘어남에 따라, 동일한 검증 코드가 여러 컨트롤러에 산재하게 되는 구조적 문제가 발생했습니다. 이는 단순한 코드 중복(Boilerplate Code)을 넘어, 타겟 검증 정책이 변경될 때마다 관련된 모든 API를 수정해야 하는 유지보수의 취약점으로 이어졌습니다. 또한 비즈니스 로직과 검증 로직이 한 곳에 혼재됨에 따라 코드의 가독성이 저하되고, 수정 과정에서 누락이 발생할 경우 장애로 직결될 위험이 높습니다. 반복되는 검증 로직과 분산된 수정 포인트(N개의 지점) 문제를 근본적으로 해결하기 위해, 다음과 같은 명확한 엔지니어링 목표를 수립했습니다. “타겟 검증, 변환을 메서드 파라미터 주입 시점에 끝낸다.” Spring MVC는 이미 @PathVariable, @RequestParam, @AuthenticationPrincipal과 같이 요청 데이터를 가공하여 컨트롤러 메서드 파라미터에 바인딩하는 표준화된 메커니즘을 제공하고 있습니다. 이 아키텍처 패턴에 착안하여, [ URL에서 타겟 ID 추출 → 유효성 검증 → 도메인 객체 변환 ]으로 이어지는 일련의 과정을 비즈니스 로직 진입 전인 '파라미터 주입 단계'에서 완결짓도록 HandlerMethodArgumentResolver를 적용했습니다. 이 아키텍처를 실제 코드로 구현하기 위해, 프로세스를 크게 세 가지 단계로 나누어 진행했습니다. 메타데이터 정의 (Annotation): 어떤 파라미터를 검증할지 식별하고 정책을 부여 로직 구현 (Resolver & Helper): 실제 값을 추출하고 도메인 객체로 변환하는 바인딩 로직 작성 설정 등록 (Configuration): Spring MVC가 해당 리졸버를 인식하도록 설정 가장 먼저, 컨트롤러 파라미터에 검증 요구사항을 명시할 커스텀 어노테이션을 정의합니다. 1. 커스텀 어노테이션 정의 - @ToTargetInfoRecords 구현의 첫 단계로, 파라미터에 메타데이터를 부여할 커스텀 어노테이션을 정의합니다. 타겟에 대한 모든 정보를 TargetInfoRecord라는 도메인 객체로 캡슐화하여 관리하고 있습니다. 따라서 '해당 파라미터를 TargetInfoRecord 객체로 변환하라'는 명시적인 의미를 담아 @ToTargetInfoRecords라는 어노테이션을 설계했습니다. 이 어노테이션은 런타임 시점에 Resolver가 식별할 수 있어야 하므로 RUNTIME 정책을 사용하며, 파라미터 레벨에 적용되도록 타겟을 한정했습니다. - VALUE_PARAMETER로 메서드 파라미터에서만 사용하도록 제한합니다. - RUNTIME 보존으로 요청 처리 시점에 리졸버가 어노테이션 값을 읽습니다. 2. ArgumentResolver 구현 다음으로 Spring MVC의 HandlerMethodArgumentResolver 인터페이스를 구현하여 실질적인 바인딩 로직을 처리하는 ToTargetInfoRecordResolver를 작성합니다. HandlerMethodArgumentResolver를 상속한 ToTargetInfoRecordsResolver를 생성합니다. 3. 리졸버 등록 방법 구현한 리졸버가 실제로 동작하기 위해서는 Spring MVC의 Argument Resolver 체인에 등록해야 합니다. WebMvcConfigurer를 구현하여 우리가 만든 리졸버를 추가해주면, 이후 들어오는 요청에 대해 Spring이 자동으로 개입하게 됩니다. 이 리졸버를 등록한 후에 클라이언트로부터 요청이 들어오면, 컨트롤러 메서드 호출 직전에 파라미터 단위로 다음 순서가 진행됩니다. 1. Spring이 컨트롤러 메서드의 각 파라미터에 대해 등록된 리졸버 리스트를 순서대로 확인합니다. 2. supportsParameter(...)가 true인 첫 번째 리졸버를 선택합니다. 3. 선택된 리졸버의 resolveArgument(...)를 호출하여 값을 만들고, 그 반환값을 해당 파라미터에 주입합니다. 자세한 구현은 다음과 같습니다. 1) 어떤 파라미터를 내가 담당하는가 — supportsParameter 파라미터에 @ToTargetInfoRecords가 붙어 있으면 자신의 책임으로 판단합니다. 2) 값을 어떻게 만들고 주입하는가 — resolveArgument 3) URL에서 값은 어떻게 추출하는가 — 쿼리 vs 경로 - 쿼리스트링은 webRequest.getParameterValues()로, 경로 변수 HandlerMapping.URI_TEMPLATE_VARIABLES_ATTRIBUTE로 추출합니다. - 메서드 파라미터 타입이 List인지도 구분하고 검증합니다. 이렇게 헬퍼 클래스를 통해 요청 위치나 데이터 타입에 구애받지 않고 무결성이 검증된 데이터가 준비되면, 변환된 객체가 마침내 컨트롤러 메소드의 파라미터에 주입됩니다. 결과적으로 컨트롤러는 HTTP 요청의 복잡한 세부 사항을 전혀 모른 채, 안전하게 가공된 도메인 객체를 즉시 사용할 수 있게 됩니다. 실제 적용 사례 가장 눈에 띄는 변화는 컨트롤러의 간결함입니다. 기존에는 비즈니스 로직과 섞여 있던 '타겟 ID 추출', '유효성 검사', '도메인 변환', '권한 체크' 등의 횡단 관심사(Cross-cutting Concerns)가 완벽하게 분리되었습니다. 덕분에 개발자는 신규 API를 작성할 때 불필요한 반복 코드(Boilerplate)를 작성하는 수고를 덜고, 핵심 비즈니스 로직 구현에만 온전히 집중할 수 있게 되었습니다. 또한, 유지보수 측면에서도 강력한 이점을 가집니다. 만약 타겟 검증 정책이 변경되더라도 수십 개의 컨트롤러를 일일이 수정할 필요 없이, ArgumentResolver의 로직 한 곳만 수정하면 전사적으로 변경 사항이 반영됩니다. 다수의 API에서 [URL로부터 값 추출 → 검증 → 도메인 객체 변환]의 패턴이 반복되는 프로젝트라면, HandlerMethodArgumentResolver를 적극적으로 도입하여 코드의 품질과 생산성을 높여보시는 것을 권장합니다.
2026.02.06
Spring MVC: 반복되는 검증 로직 한 번에 끝내기
Spring MVC: 반복되는 검증 로직 한 번에 끝내기
인프라 관리 도메인에서 API 설계 시 가장 빈번하게 등장하는 파라미터는 단연 targetId입니다. 하지만 이 식별자는 비즈니스 로직이 실행되기 전, 반드시 통과해야 하는 '삼중 관문'을 가지고 있습니다. 유효성 검사, 도메인 객체 변환, 그리고 권한 확인이 그것입니다. 초기 구현 단계에서는 이 관문들을 각 컨트롤러 메서드 내부에서 직접 제어하는 방식을 택했습니다. 하지만 인프라 규모가 커지고 API 엔드포인트가 늘어날수록, 이 직관적인 방식은 코드 중복과 유지보수 효율성 저하라는 아키텍처적 부채로 돌아오기 시작했습니다. API 엔드포인트가 수십 개로 늘어남에 따라, 동일한 검증 코드가 여러 컨트롤러에 산재하게 되는 구조적 문제가 발생했습니다. 이는 단순한 코드 중복(Boilerplate Code)을 넘어, 타겟 검증 정책이 변경될 때마다 관련된 모든 API를 수정해야 하는 유지보수의 취약점으로 이어졌습니다. 또한 비즈니스 로직과 검증 로직이 한 곳에 혼재됨에 따라 코드의 가독성이 저하되고, 수정 과정에서 누락이 발생할 경우 장애로 직결될 위험이 높습니다. 반복되는 검증 로직과 분산된 수정 포인트(N개의 지점) 문제를 근본적으로 해결하기 위해, 다음과 같은 명확한 엔지니어링 목표를 수립했습니다. “타겟 검증, 변환을 메서드 파라미터 주입 시점에 끝낸다” Spring MVC는 이미 @PathVariable, @RequestParam, @AuthenticationPrincipal과 같이 요청 데이터를 가공하여 컨트롤러 메서드 파라미터에 바인딩하는 표준화된 메커니즘을 제공하고 있습니다. 이 아키텍처 패턴에 착안하여, [ URL에서 타겟 ID 추출 → 유효성 검증 → 도메인 객체 변환 ]으로 이어지는 일련의 과정을 비즈니스 로직 진입 전인 '파라미터 주입 단계'에서 완결짓도록 HandlerMethodArgumentResolver를 적용했습니다. 이 아키텍처를 실제 코드로 구현하기 위해, 프로세스를 크게 세 가지 단계로 나누어 진행했습니다. 1. 메타데이터 정의 (Annotation): 어떤 파라미터를 검증할지 식별하고 정책을 부여 2. 로직 구현 (Resolver & Helper): 실제 값을 추출하고 도메인 객체로 변환하는 바인딩 로직 작성 3. 설정 등록 (Configuration): Spring MVC가 해당 리졸버를 인식하도록 설정 가장 먼저, 컨트롤러 파라미터에 검증 요구사항을 명시할 커스텀 어노테이션을 정의합니다. 1. 커스텀 어노테이션 정의 - @ToTargetInfoRecords 구현의 첫 단계로, 파라미터에 메타데이터를 부여할 커스텀 어노테이션을 정의합니다. 타겟에 대한 모든 정보를 TargetInfoRecord라는 도메인 객체로 캡슐화하여 관리하고 있습니다. 따라서 '해당 파라미터를 TargetInfoRecord 객체로 변환하라'는 명시적인 의미를 담아 @ToTargetInfoRecords라는 어노테이션을 설계했습니다. 이 어노테이션은 런타임 시점에 Resolver가 식별할 수 있어야 하므로 RUNTIME 정책을 사용하며, 파라미터 레벨에 적용되도록 타겟을 한정했습니다. - VALUE_PARAMETER로 메서드 파라미터에서만 사용하도록 제한합니다. - RUNTIME 보존으로 요청 처리 시점에 리졸버가 어노테이션 값을 읽습니다. 2. ArgumentResolver 구현 다음으로 Spring MVC의 HandlerMethodArgumentResolver 인터페이스를 구현하여 실질적인 바인딩 로직을 처리하는 ToTargetInfoRecordResolver를 작성합니다. HandlerMethodArgumentResolver를 상속한 ToTargetInfoRecordsResolver를 생성합니다. 3. 리졸버 등록 방법 구현한 리졸버가 실제로 동작하기 위해서는 Spring MVC의 Argument Resolver 체인에 등록해야 합니다. WebMvcConfigurer를 구현하여 우리가 만든 리졸버를 추가해주면, 이후 들어오는 요청에 대해 Spring이 자동으로 개입하게 됩니다. 이 리졸버를 등록한 후에 클라이언트로부터 요청이 들어오면, 컨트롤러 메서드 호출 직전에 파라미터 단위로 다음 순서가 진행됩니다. 1. Spring이 컨트롤러 메서드의 각 파라미터에 대해 등록된 리졸버 리스트를 순서대로 확인합니다. 2. supportsParameter(...)가 true인 첫 번째 리졸버를 선택합니다. 3. 선택된 리졸버의 resolveArgument(...)를 호출하여 값을 만들고, 그 반환값을 해당 파라미터에 주입합니다. 자세한 구현은 다음과 같습니다. 1) 어떤 파라미터를 내가 담당하는가 — supportsParameter 파라미터에 @ToTargetInfoRecords가 붙어 있으면 자신의 책임으로 판단합니다. 2) 값을 어떻게 만들고 주입하는가 — resolveArgument 3) URL에서 값은 어떻게 추출하는가 — 쿼리 vs 경로 - 쿼리스트링은 webRequest.getParameterValues()로, 경로 변수는HandlerMapping.URI_TEMPLATE_VARIABLES_ATTRIBUTE로 추출합니다. - 메서드 파라미터 타입이 List인지도 구분하고 검증합니다. 이렇게 헬퍼 클래스를 통해 요청 위치나 데이터 타입에 구애받지 않고 무결성이 검증된 데이터가 준비되면, 변환된 객체가 마침내 컨트롤러 메소드의 파라미터에 주입됩니다. 결과적으로 컨트롤러는 HTTP 요청의 복잡한 세부 사항을 전혀 모른 채, 안전하게 가공된 도메인 객체를 즉시 사용할 수 있게 됩니다. 실제 적용 사례 가장 눈에 띄는 변화는 컨트롤러의 간결함입니다. 기존에는 비즈니스 로직과 섞여 있던 '타겟 ID 추출', '유효성 검사', '도메인 변환', '권한 체크' 등의 횡단 관심사(Cross-cutting Concerns)가 완벽하게 분리되었습니다. 덕분에 개발자는 신규 API를 작성할 때 불필요한 반복 코드(Boilerplate)를 작성하는 수고를 덜고, 핵심 비즈니스 로직 구현에만 온전히 집중할 수 있게 되었습니다. 또한, 유지보수 측면에서도 강력한 이점을 가집니다. 만약 타겟 검증 정책이 변경되더라도 수십 개의 컨트롤러를 일일이 수정할 필요 없이, ArgumentResolver의 로직 한 곳만 수정하면 전사적으로 변경 사항이 반영됩니다. 다수의 API에서 [URL로부터 값 추출 → 검증 → 도메인 객체 변환]의 패턴이 반복되는 프로젝트라면, HandlerMethodArgumentResolver를 적극적으로 도입하여 코드의 품질과 생산성을 높여보시는 것을 권장합니다.
2026.03.06
다음 슬라이드 보기