magic-number | data-abstraction | enum | java

매직 넘버에서 상수화, Enum을 거쳐 데이터 추상화까지

매직 넘버에서 상수화, Enum, 데이터 추상으로 이어지는 코드 설계의 진화 과정을 살펴보며, Enum만으로 부족한 이유와 비즈니스 규칙을 캡슐화해야 하는 이유를 Java 예제와 함께 설명합니다.

Mimul
MimulJanuary 18, 2015 · 22 min read · Last Updated:

매직 넘버를 발견하면 상수로 대체하고, 상태값이라면 Enum으로 바꾼다. 많은 개발팀에서 여기까지를 “좋은 설계”라고 여긴다. 하지만 상수화는 값에 이름을 붙이고, Enum은 허용 가능한 값을 타입으로 묶을 뿐이다. 둘을 적용하고 나서도 그 값을 해석하는 판단 규칙은 호출하는 쪽 곳곳에 흩어진 채 남는 경우가 많다. 이 글은 매직 넘버를 상수나 Enum으로 바꾸는 데서 리팩토링을 멈추곤 하는 개발자를 대상으로, 아래 네 단계의 진화 과정을 따라가며 왜 데이터 추상화가 최종 목적지인지 설명한다.

매직 넘버 → 상수 → Enum → 데이터 추상화

1. 매직 넘버

if (age >= 20) {
    issueAdultTicket();
}

20이라는 숫자는 존재하지만 그 의미는 코드 어디에도 적혀 있지 않다. 성인 기준 나이일 수도, 주류 구매 가능 연령일 수도, 이벤트 참여 기준일 수도 있다. 이 코드를 처음 보는 개발자는 추측하거나, 커밋 로그를 뒤지거나, 작성자에게 직접 물어봐야 한다. 코드 리뷰에서도 같은 문제가 생긴다. 리뷰어는 20이 도메인 정책에서 비롯된 값인지, 기술적 한계값인지, 임시로 하드코딩된 것인지 구분할 방법이 없다.

더 큰 문제는 동일한 숫자가 코드베이스 여러 곳에 흩어져 있을 때 발생한다.

if (age >= 20) { ... }        // UserService.java
if (age >= 20) { ... }        // TicketService.java
if (age >= 20) { ... }        // CouponService.java

정책이 변경되어 기준 나이가 19세로 바뀌면 세 곳을 모두 찾아 수정해야 한다. 하나라도 놓치면 서비스마다 기준이 달라지는 버그가 발생한다. 이것은 추측이 아니라 측정된 현상이다. 일곱 개 오픈소스 시스템의 수천 개 커밋을 추적한 코드 클론 연구에서, 버그 수정을 겪은 클론 조각의 18.42%는 다른 클론에서 전파된 버그를 고치고 있었다. 복제된 매직 넘버는 그 자체로 클론이므로, 복제본이 늘어날수록 한 곳만 고치고 나머지를 놓칠 가능성도 함께 늘어난다.

2. 상수화

가장 흔한 리팩토링이다.

public static final int ADULT_AGE = 20;

if (age >= ADULT_AGE)

숫자 대신 이름이 등장하면 코드를 읽는 사람이 의도를 즉시 파악할 수 있다. 정책이 변경될 경우 ADULT_AGE = 19; 한 줄만 수정하면 이 상수를 참조하는 모든 곳에 변경이 반영된다. 상수화는 가독성과 변경 용이성이라는 두 문제를 동시에 해결한다.

그러나 많은 프로젝트에서 상수화는 다음과 같은 방식으로 진행된다.

// Constants.java
public class Constants {
    public static final int ADULT_AGE = 20;
    public static final int MAX_LOGIN_FAIL_COUNT = 5;
    public static final int DEFAULT_TIMEOUT = 3000;
    public static final int MAX_CONNECTION = 100;
    public static final int GOLD_MEMBER_TYPE = 2;
    public static final int VIP_MEMBER_TYPE = 3;
    public static final int MAX_RETRY = 3;
    ...
}

이 파일은 시간이 지날수록 커진다. 회원 등급, 로그인 정책, 네트워크 설정처럼 서로 무관한 값이 한데 모이면서 맥락(context)이 사라진다. GOLD_MEMBER_TYPE이 회원 도메인의 규칙이라는 사실은 이 파일 어디에도 드러나지 않고, 그 옆에 놓인 DEFAULT_TIMEOUT과 같은 무게로 나열될 뿐이다. 상수가 속한 도메인을 잃으면 상수화는 데이터 추상화가 아니라 단순한 이름 부여에 머문다.

변경을 한 곳에서 처리할 수 있다는 이점도 이름 붙이기가 올바를 때만 성립한다. 위 파일의 MAX_RETRY와 VIP_MEMBER_TYPE은 값이 둘 다 3이지만 전혀 다른 개념이다. 값이 같다는 이유로 하나의 상수로 합쳐 두면, 재시도 횟수만 바꿔야 할 때 회원 등급까지 함께 바뀐다. 같은 이름으로 묶인 값은 함께 변하고, 다른 이름으로 구별된 값은 독립적으로 변한다. 명명의 핵심은 값에 의미를 부여하는 일이고, 변경의 집중화는 그 결과로 따라오는 효과다.

더 근본적인 한계도 있다. 상수화가 해결하는 것은 값(Value)의 가독성과 집중화다. 그런데 실제 코드에서 중요한 것은 값만이 아니다.

if (age >= ADULT_AGE)

이 코드를 읽는 사람은 여전히 세 가지 사실을 알아야 한다. 성인 판정 규칙이 존재한다는 것, 나이를 비교해서 판단한다는 것, 기준값은 ADULT_AGE라는 것. 숫자는 사라졌지만 규칙 자체는 코드 바깥에 노출되어 있다. 상수화는 이름을 부여했을 뿐, 규칙을 캡슐화하지는 못했다.

Martin Fowler는 이를 Replace Magic Literal(1판의 이름은 Replace Magic Number with Symbolic Constant) 리팩토링으로 설명한다. 핵심 목적은 숫자를 제거하는 것이 아니라 값에 의미를 부여하는 것이다. 하지만 이 리팩토링은 어디까지나 이름을 부여하는 단계이며, 값을 어떻게 해석하고 사용할지에 대한 규칙까지 캡슐화하지는 않는다. 따라서 상수화는 중요한 출발점이지만 데이터 추상화의 종착점은 아니다.

3. Enum

정수 상수에는 타입 안전성이 없다. 회원 등급을 정수 상수로 두면 다음과 같다.

public static final int BASIC = 1;
public static final int GOLD = 2;
public static final int VIP = 3;

이름이 생겼지만 정수형이기 때문에 member.setGrade(999)처럼 존재하지 않는 값을 할당해도 컴파일러가 오류를 잡아내지 못한다. Enum은 이 문제를 해결한다.

enum MemberGrade {
    BASIC,
    GOLD,
    VIP
}

if (member.getGrade() == MemberGrade.VIP) {
    applyDiscount();
}

MemberGrade 타입에는 BASIC, GOLD, VIP 외의 값을 넣을 수 없으므로, 잘못된 값이 코드베이스에 침투할 가능성이 컴파일 단계에서 차단된다. MemberGrade라는 이름 하나로 회원이 가질 수 있는 모든 상태를 한눈에 파악할 수 있고, 정수 상수 목록과 달리 관련 개념이 하나의 타입으로 묶이기 때문에 IDE의 자동 완성이나 리팩토링 도구도 효과적으로 활용할 수 있다.

Enum도 충분하지 않다

다음 코드가 시스템 곳곳에 존재한다고 가정한다.

if (member.getGrade() == MemberGrade.GOLD
        || member.getGrade() == MemberGrade.VIP) {
    showDiscountBanner();
}

if (member.getGrade() == MemberGrade.GOLD
        || member.getGrade() == MemberGrade.VIP) {
    applyDiscount();
}

if (member.getGrade() == MemberGrade.GOLD
        || member.getGrade() == MemberGrade.VIP) {
    issueCoupon();
}

문제는 GOLD나 VIP가 아니다. “할인을 받을 수 있는 회원”이라는 비즈니스 규칙이 여러 곳에 중복되어 있다는 점 이다. 새로운 회원 등급 PREMIUM이 추가되고 이 등급도 할인 대상이 된다면 위의 조건문을 모두 찾아 수정해야 한다. 세 곳을 모두 찾았다면 다행이지만, 다섯 번째 여섯 번째 중복 조건문을 놓치면 버그가 된다. Enum은 데이터를 타입으로 모델링했지만, 그 데이터를 해석하는 행동(Behavior)은 여전히 외부에 노출되어 있다.

Java의 Enum은 필드와 메서드를 가질 수 있으므로, MemberGrade 안에 isDiscountEligible()을 두면 이 중복은 사라진다. 따라서 이 글이 문제 삼는 것은 Enum이라는 언어 기능이 아니라, Enum을 값 집합으로만 쓰고 그 값을 해석하는 판단을 호출하는 쪽에 남겨 두는 습관이다. 판단을 Enum 안에 둘지, 그 Enum을 속성으로 가진 객체 안에 둘지는 다음 절에서 정한다.

4. 데이터 추상화

호출하는 쪽이 알고 싶은 것은 회원 등급이 GOLD인지가 아니라 이 회원이 할인 대상인가이다. 그 판단을 Member 객체 안으로 가져온다.

class Member {

    private MemberGrade grade;

    public boolean canReceiveDiscount() {
        return grade == MemberGrade.GOLD
            || grade == MemberGrade.VIP;
    }
}

호출하는 쪽은 이렇게 된다.

if (member.canReceiveDiscount()) {
    applyDiscount();
}

이 한 줄은 이제 비즈니스 의도와 코드 표현이 일치한다.

판단을 어디에 둘 것인가

할인 가능 여부가 등급만의 함수라면 MemberGrade.isDiscountEligible()로 충분하고, Member의 canReceiveDiscount()는 그 메서드에 위임하면 된다. 반면 할인 여부가 등급 외에 가입 기간, 연체 여부, 쿠폰 보유처럼 회원의 다른 상태도 함께 본다면, 그 판단은 그 상태를 모두 가진 Member에 두어야 한다. 기준은 판단에 필요한 정보를 누가 가지고 있는가이다. 이 글의 예제는 등급만 보지만, 실무에서 할인 정책은 대개 여러 조건이 겹치므로 Member 쪽에 두는 형태로 설명한다. 어느 쪽에 두든 판단이 호출하는 쪽에서 사라진다는 점은 같다.

무엇이 달라지는가

데이터 추상화로 달라지는 것은 크게 네 가지다. 변경의 국소화, 정보 은닉, 중복 지식 제거, 도메인 언어와의 일치.

상수화가 해결한 것은 20 → 19처럼 값(Value)의 변경이다. 데이터 추상화는 한 단계 더 나아가 “어떤 회원이 할인 대상인가?”라는 정책(Policy)의 변경까지 한 곳에서 처리한다. 앞 절에서 든 PREMIUM 등급 추가도 canReceiveDiscount() 메서드 하나만 수정하면 끝나고, 이 메서드를 호출하는 코드는 아무것도 바꾸지 않아도 된다. 변경 범위가 객체 경계 안으로 완전히 들어온다.

David Parnas는 1972년 논문 “On the Criteria To Be Used in Decomposing Systems into Modules”에서 모듈 분해의 핵심 기준으로 변경 가능성이 있는 설계 결정을 숨기는 것 을 제시했다. 그가 강조한 것은 단순히 데이터를 감추는 것이 아니라, 변할 가능성이 있는 결정(decision) 자체를 모듈 경계 뒤에 숨기는 것이다. 회원 할인 정책은 비즈니스 환경이 바뀔 때마다 변경된다. 이 결정을 grade == GOLD || grade == VIP라는 형태로 코드 곳곳에 노출하는 대신 member.canReceiveDiscount() 뒤에 숨기면 Parnas가 말한 정보 은닉이 실현된다. 호출자는 “이 회원이 할인 대상인가”라는 질문의 답만 얻고, 그 판단 근거는 알 필요가 없다.

DRY(Don’t Repeat Yourself)의 원래 의미도 같은 방향을 가리킨다. The Pragmatic Programmer에서 Andy Hunt와 Dave Thomas가 정의한 것처럼 시스템 안의 모든 지식은 단 하나의 명확한 표현을 가져야 한다. “할인 가능 회원 판정 규칙”은 하나의 지식이다. 이 지식이 showDiscountBanner(), applyDiscount(), issueCoupon() 등 여러 곳에 같은 형태로 복제되어 있다면, 정책이 변경될 때 모든 복제본을 동기화해야 하는 책임이 생긴다. 하나라도 빠지면 시스템은 일관성을 잃는다. 데이터 추상화는 이 지식을 한 객체 안에 단 한 번만 표현한다.

도메인 언어 측면에서도 차이가 있다. 비즈니스 담당자는 “회원 등급이 GOLD 또는 VIP입니다”라고 말하지 않는다. “이 회원은 할인을 받을 수 있습니다”라고 말한다. Eric Evans가 Domain-Driven Design에서 제시한 유비쿼터스 언어(Ubiquitous Language)는 도메인 전문가와 개발자가 같은 언어를 사용해야 한다는 원칙이다. member.canReceiveDiscount()는 비즈니스 언어 그대로를 코드로 표현한다. 반면 grade == GOLD || grade == VIP는 구현 세부 사항이며, 도메인 언어와 거리가 있다.

이름 붙이기의 마지막 단계

Arlo Belshee는 Naming is a Process에서 좋은 이름은 한 번에 나오지 않고 일곱 단계를 거쳐 진화한다고 설명한다. 뜻 없는 이름에서 시작해 정직한 이름, 완전한 이름을 거쳐, 마지막 두 단계인 의도(Intent)와 도메인 추상(Domain Abstraction)에 이르러서야 이름이 설계가 된다. 이 글의 네 단계는 그 흐름을 상수와 Enum이라는 구체적인 수단에 맞춰 압축한 것이다.

3 - 값
↓
VIP - 이름(상수화)
↓
MemberGrade - 개념(Enum)
↓
member.canReceiveDiscount() - 행동(데이터 추상화)

세 번째 단계인 MemberGrade.VIP에서 멈추는 코드가 많다. 그러나 호출하는 쪽이 알고 싶은 것은 “회원 등급이 무엇인가”가 아니라 “이 회원이 할인을 받을 수 있는가”이기 때문에, 실제 목적지는 네 번째 단계인 member.canReceiveDiscount()다. Enum은 개념을 정확히 모델링했지만, 그 개념을 활용해 판단을 내리는 행동은 여전히 외부에 위임되어 있다. 데이터 추상화는 그 판단까지 객체 안으로 흡수한다. Belshee의 마지막 단계 이름이 도메인 추상인 것은 우연이 아니다.

이 단계 구분은 Barbara Liskov와 Stephen Zilles가 1974년 제안한 추상 데이터 타입(ADT) 개념과도 연결된다. ADT는 “사용자는 인터페이스만 알면 되고, 구현은 숨겨진다”는 원칙을 기반으로 한다. canReceiveDiscount()는 인터페이스다. 내부에서 GOLD와 VIP를 어떻게 비교하는지는 구현이다. 사용자는 구현을 알 필요가 없고, 인터페이스가 제공하는 질문에만 집중하면 된다.

Enum을 공개하는 라이브러리는 잘못된 설계인가

4절의 기준을 그대로 적용하면 반례처럼 보이는 설계가 있다. HTTP 상태 코드를 나타내는 HttpStatus 같은 타입은 대부분의 라이브러리에서 Enum으로 공개되고, 401이나 404가 호출하는 쪽에 그대로 보인다.

라이브러리가 상태 코드를 Enum으로 공개하는 것은 라이브러리가 사용 맥락을 모르기 때문이다. 401을 받아서 재시도할지, 재로그인 화면으로 이동할지, 로그만 남길지. 이 판단은 라이브러리 쪽에 없다. 사용하는 애플리케이션마다 다르다. Parnas가 말한 정보 은닉은 “변하기 쉬운 판단”을 숨기라는 뜻이며, 판단이 모듈 안에 없으면 숨길 것도 없다.

판단은 사용하는 쪽에 있다. 401을 “재인증이 필요한 상태”로 해석하고, 403이나 만료된 토큰과 함께 처리할지 분리할지를 결정하는 것은 그 애플리케이션의 도메인 판단이다. 따라서 if (res.statusCode == HttpStatus.UNAUTHORIZED)를 곳곳에 복제하는 대신, 그 판단을 authResult.requiresReauthentication()과 같이 자신의 도메인 타입에 담아야 한다. HttpStatus를 isUnauthorized() 같은 메서드로 일대일 치환하는 것만으로는 Enum을 메서드 이름으로 바꿨을 뿐, 판단을 호출하는 쪽에 남긴 채이기는 마찬가지다.

기준은 레이어의 차이도, 라이브러리인지 애플리케이션인지의 구분도 아니다. 그 코드가 값에 대한 판단을 갖고 있는가 여부다. 판단을 갖는 쪽이 데이터 추상을 만들고, 판단이 없는 쪽은 값을 공개해도 된다. 범용 라이브러리가 Enum을 공개할 수 있는 것은 “범용이기 때문”이 아니라, 판단을 갖지 않는다는 조건을 충족하기 때문이다.

결론

상수화, Enum, 데이터 추상화는 각각 다른 문제를 해결한다. 상수화는 값에 이름을 붙이고, Enum은 허용 가능한 값을 타입으로 정의하며, 데이터 추상화는 값에 대한 판단을 객체 안으로 가져온다. Enum 도입에서 리팩토링을 멈추면 타입 안전성은 얻지만 판단의 중복은 그대로 남는다.

매직 넘버를 발견했다면 단순히 상수로 추출하는 데서 멈추지 말자. 그 값이 어떤 비즈니스 개념을 나타내는지, 그 개념에 대한 판단을 어떤 객체가 책임져야 하는지를 고민해 보자. 그 질문이 바로 데이터 추상화와 도메인 모델링의 출발점이다.

참조 사이트


Mimul

Written byMimul
Mimul is a programmer, technologist, exercise enthusiast and more.
Connect

Related ArticlesView All