ABAP Clean Code : 변수와 리터럴(Variables and Literals) - 상수(Constants)

이 글은 『Clean ABAP – A Style Guide for Developers』 서적 (written by Klaus Haeuptle, Florian Hoffmann, Rodrigo Jordão, Michel Martin, Anagha Ravinarayan, Kai Westerholz)을 참고하여 작성하였습니다. 해당 내용을 좀 더 쉽고 이해할 수 있도록 요약/정리 및 개인적인 의견을 붙여 재구성한  포스팅입니다. 

 

 

 

ABAP을 처음 배우다 보면 변수와 상수의 차이를 헷갈리기 쉽다. 특히 유지보수나 확장이 쉬운 클린 코드를 작성하려면, 상수를 제대로 정의하고 사용하는 것이 굉장히 중요하다. 이번 글에서는 ABAP에서 상수를 활용해 코드를 더 읽기 쉽고, 오류로부터 방지할 수 방법을 알아보도록 하자.

---

1. 매직 넘버(Magic Number)를 피하자.

IF l_typecode = 'E'.
ENDIF.

 

처음 보는 사람은 'E'가 무엇을 의미하는지 알 수 없다. 이게 오류(Error)의 'E' 인지 아니면, 어떠한 비지니스 코드 값 중 하나인 'E' ( 예를 들어 언어키 'EN'의 'E' ) 인지 말이다. 이렇게 정체를 알 수 없는 리터럴 값을 코드에 박아두는 걸 매직 넘버라고 부른다. 마법처럼 의미가 숨겨져 있어서, 읽는 사람이 해석하기 어렵기 때문이다. 이런 경우 상수를 활용하여 의미를 부여해 보자.

CONSTANTS c_error TYPE zstatus VALUE 'E'. 

 

이제 'E'가 에러 상태를 의미한다는 것을 알 수 있다.

 

✍️  매직 넘버(Magic Number)와 하드코딩(Hard Coding)은 다른 걸까?

결론부터 말하자면 매직 넘버는 하드코딩의 일종이지만, 모든 하드코딩이 매직 넘버는 아니다.
📌 하드코딩(Hard Coding) = 값 직접 입력
      하드코딩은 값을 변수나 상수로 추출하지 않고 코드에 직접 써넣는 것을 말함. (의미를 알 수 있음)
📌매직 넘버(Magic Number) = 의미 없는 하드코딩
      하드코딩이지만 의미를 알 수 없음.

---

2. 같은 항목의 상수들끼리 그룹화 하여 묶어서 사용하자. (Grouping)

❌ Bad Case
CONSTANTS:
   c_success  TYPE sy-msgty VALUE 'S',
   c_error TYPE sy-msgty VALUE 'E',
   c_kr TYPE sy-langu VALUE '3',
   c_en TYPE sy-langu VALUE 'E'.

✅ Good Case
CONSTANTS:
  BEGIN OF cs_status,
      success  TYPE sy-msgty VALUE 'S',
      error TYPE sy-msgty VALUE 'E',
  END OF cs_status,
  BEGIN OF cs_language,  
     kr TYPE sy-langu VALUE '3',
     en TYPE sy-langu VALUE 'E'.
  END OF cs_language.

• 의미와 맥락이 명확 : 단일 상수는 이름만 보고 용도를 유추해야 하지만, 그룹 이름이 붙으면 무엇에 대한 상수인지 명확하게 알 수 있다.
• 가독성 향상 : 상수가 관련 주제별로 정리되어 있기 때문에 코드를 읽는 사람이 전체 상수 구조를 쉽게 이해할 수 있다.
• 재사용성과 유지보수 향상 : 하나의 구조 안에 정의해 두면, 상수 추가, 수정, 삭제 시 관리가 쉽고, 구조적으로 연결되어 있어 중복 방지 및 오류 가능성 감소된다.

---

3. 열거형 클래스 (Enumeration Class)를 활용하자.

상수를 묶는 더 진보된 방식이 바로 열거형 클래스이다. 이 클래스는 단순히 값만 가지는 게 아니라, 비교나 변환을 위한 메서드도 함께 포함할 수 있어 확장성까지 갖추었다.

CLASS zcl_example_enum DEFINITION PUBLIC ABSTRACT FINAL.
   PUBLIC SECTION.
      CONSTANTS:
          BEGIN OF category,
             food TYPE c VALUE 'F',
             drink TYPE c VALUE 'D',
          END OF category.

    CLASS-METHODS get_description 
         IMPORTING value TYPE c
         RETURNING VALUE(text) TYPE string.
ENDCLASS.

 

✍️  열거형 클래스(Enumeration Class)란?

특정한 값들의 집합을 미리 정의해 놓고, 의미 있는 이름으로 관리하는 클래스이다. 이 클래스는 상수(Constant)처럼 값을 저장하지만, 그저 값만 저장하는 게 아니라 추가로 메서드도 가질 수 있고, 타입 안정성(type safety)도 높일 수 있다.

✅ CLASS ... ABSTRACT FINAL로 선언
✅ CONSTANTS 안에 BEGIN OF ... 구조로 묶기
✅ (옵션) CLASS-METHODS로 메서드 추가