ABAP Clean Code : 변수와 리터럴(Variables and Literals) - 문자열(String)

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

 

 

 

ABAP 개발을 하다 보면 코드 안에 문자열을 직접 작성해야 하는 경우가 있다. 예를 들어, 로그 메시지나 테스트 출력 문구처럼 개발자가 의도한 정보를 담는 경우이다. ABAP에서 문자열(STRING)을 클린하게 다루는 방법에 대해 알아보도록 하자.

---

1. 문자열 리터럴 사용  -  ' (작은따옴표) vs ` (백틱)

문자열 리터럴이란 소스 코드 내에 직접 입력한 텍스트 문자를 말한다. 하지만 텍스트 문자가 어떤 기호로 감싸졌느냐에 따라 타입과 동작 방식이 달라질 수 있다. 

 

🔍 '텍스트' (작은따옴표)

DATA text TYPE string.
text = 'Hello, Two ssun!'.

• 작은따옴표 ' '는 CHAR(문자) 타입 리터럴을 의미함
• STRING으로 선언한 변수에 CHAR 문자를 입력하는 형태
• CHAR 타입은 고정 길이 문자이기 때문에 대상 변수가 STRING 타입이면 암묵적 형변환이 발생

🔍 `텍스트` (백틱)

DATA text TYPE string.
text = `Hello, Two ssun!`.

• 백틱 `은 STRING(문자열) 타입 리터럴을 의미함
• STRING 타입 변수에 넣을 때 형변환이 필요 없이 안전하게 들어감

---

2. ⚠️Inline Declaration (인라인 선언)시 주의사항

DATA(log_message1) = 'Saved successfully'.

위 예시는 인라인 선언이어서 String(문자열) 타입으로 보이지만 실제로 ' (작은 따옴표)를 사용했으므로, 해당 변수는 CHAR(문자) 타입 리터럴 인 18자리 고정으로 선언된다. 

 

이렇게 되면 뒷부분 로직에서 해당 변수에 다른 메시지를 넣을 경우, 예를 들어 에러 메시지를 넣었을 때 메시지가 길어진다면 18자리로 잘려서 보일 수가 있다.  따라서 인라인 선언 시엔 반드시 ` (백틱)을 사용해 STRING 타입으로 정확히 지정하도록 하자.

DATA(log_message2) = `Saved successfully`.

 

< 디버깅 시 인라인 변수 선언시 ' 와 ` 으로 결정되는 데이터 타입 >

---

3. 고정 텍스트면 상수를 활용하자. 

변하지 않는 문자열이라면, CONSTANTS 구문을 사용하여 의도를 명확히 표현하는 것이 좋다. 그러면 코드의 의미도 더 명확해지고 유지보수 시 실수도 줄어들게 된다.

CONSTANTS success_message  TYPE string VALUE `Saved successfully`.

---

4. String Interpolation(문자열 보간) - 파이프 구문( |  | ) 올바른 사용방식.

실무에서는 대부분의 문자열은 그 메시지, 오류 응답, 테스트 결과 등과 같이 "고정된 문구 + 변수 값" 처럼동적으로 구성하여 사용하는 경우가 많다. 이처럼 정적인 문자열과 변수 값을 조합하려면, 문자열 보간(string interpolation)을 사용하는 것이 가독성과 유지보수 측면에서 훨씬 유리하다. 

DATA(order_message) = `Sales Order ` && l_vbeln && ` Created.'

 

위의 예제는 과거에 자주 사용되었던 방식으로 변수와 "&&" 는 문자열을 조합할 때 유용했지만 다음과 같은 단점이 있다.

• 문자열의 시작과 끝이 어디인지, 변수는 어디에 있는지 직관적으로 파악하기 어려움
• 변수 개수가 늘어나면 코드가 읽기 어렵고, 유지보수하기 힘들어짐

DATA(order_message) = |Sales Order { l_vbeln } Created.|.

 

위의 예제는 new syntax에 생긴 파이프 구문 " |  | " 사용한 문자열 보간으로 다음과 같은 장점이 있다. 

• 문자열 흐름 안에 변수 위치가 명확하게 보여 가독성이 매우 뛰어남
• ` (백틱) 없이도 바로 STRING 타입으로 인식함
• 변수에 담지 않고 바로 즉석에서 문자열 생성이 가능함 (ex. MESSAGE | Sales Order { l_vbeln } Created. | TYPE 'S'. )

 

⚠️ 보간법은 오직 변수나 표현식이 포함될 때만 사용하자.

❌ Bad Case
welcome_message = |Hello, Two ssun!|.

✅ Good Case
welcome_message = `Hello, Two ssun!`.

 

변수 또는 표현식 사용이 없는 일반적인 고정 문구를 굳이 파이프 구문 |   | 를 이용할 필요는 없다. 해당 문법은 문자열 보간을 위한 것이므로 `   `백틱으로도 충분히 선언 가능하다. 

 

---

✍️ 하드코딩 대신 메시지 클래스를 사용하자.

사용자에게 보여지는 문자열은 코드에 직접 하드코딩하지 말고, 메시지 클래스를 사용하는 것이 좋다. 이 방식은 다국어 지원
( 번역 시스템 연계 ), 중앙 관리, 유지보수 용이성(재사용),  등의 장점이 있다. 또한 변수 자리( & )를 지정할 수 있어 문자열 보간 없이도 상황별 메시지를 효과적으로 전달할 수 있다.