ABAP Base64 인코딩과 디코딩 구현 (Feat. CL_HTTP_UTILITY)

레거시와 인터페이스 구현시 상대방 쪽에서 base64로 인코딩해서 주거나 받기를 요청하는 경우가 있다. Base64가 무엇인지 어떻게 사용되는지에 대해 알아보도록 하자.

---

1. Base64란 무엇인가?

Base64는 바이너리 데이터를 텍스트 데이터로 변환하는 인코딩 방식이다. 0과 1로 구성된 바이너리 데이터를 사람이 읽을 수 있는 문자(AZ, az, 0~9, +, /)로 변환해 주는 것이다.

• 3바이트(24비트) → 4개의 6비트 블록 → 4문자로 변환
• 변환된 결과는 원본보다 약 33% 커지지만, 텍스트 시스템에서도 안전하게 다룰 수 있다.

즉, 이미지, 파일, 바이너리 데이터를  "텍스트처럼 안전하게 전송하거나 저장" 할 수 있도록 변환하는 과정이 Base64이다.

---

2. Base64는 어떤 경우에 사용될까?

사용 사례	설명
파일 전송	SAP 시스템에서 외부 서버로 PDF, 이미지 파일을 전송할 때
API 통신	외부 REST API 호출 시, Authorization 헤더 등에 사용
DB 저장	바이너리 데이터를 텍스트로 변환하여 데이터베이스에 저장
이메일 전송	첨부파일을 Base64로 인코딩하여 메일에 포함

---

3.  Base64의 장점

항목	설명
시스템 호환성	모든 플랫폼에서 문제 없이 처리 가능 (텍스트 기반)
안전성	데이터 손실 없이 전송 가능
표준화	웹, 메일, 통신 프로토콜 등 다양한 곳에서 표준 지원
간결성	인코딩/디코딩 로직이 간단하여 빠르게 구현 가능

---

4. ABAP에서 Base64 인코딩/디코딩 방법

1) Function Module 사용 (SCMS_BASE64_ENCODE_STR, SCMS_BASE64_DECODE_STR)

 

▶ Base64 인코딩 ( xstring → string )

DATA: lv_raw TYPE xstring,      "기존 바이트 타입의 바이너리 데이터 
           lv_base64 TYPE string.

CALL FUNCTION 'SCMS_BASE64_ENCODE_STR'
     EXPORTING
          input = lv_raw
     IMPORTING
          output = lv_base64.

 

▶ Base64 디코딩 ( string → xstring )

DATA: lv_base64 TYPE string,    "base64로 인코딩된 데이터 
           lv_raw TYPE xstring.

CALL FUNCTION 'SCMS_BASE64_DECODE_STR'
      EXPORTING
           input = lv_base64
      IMPORTING
           output = lv_raw.

 

 

2) 클래스 사용 (CL_HTTP_UTILITY )

클래스를 통한 인코딩/디코딩 사용하면 코드가 훨씬 깔끔해지고 가독성이 좋아진다. 

 

▶ Base64 인코딩 ( xstring → string )

DATA(lv_base64) = cl_http_utility=>encode_x_base64( lv_raw ).

 

▶ Base64 디코딩 ( string → xstring )

DATA(lv_raw) = cl_http_utility=>decode_x_base64( lv_base64 ).

 

추가로 CL_ABAP_CODEPAGE 클래스로도 변환 가능하다.( Method : convert_from, convert_to )

 

💡바이너리 데이터를 인터널 테이블로 가지고 있는 경우 펑션 SCMS_BINARY_TO_XSTRING 을 사용하여 xstring으로 변환이 가능하다. 

---

5. Base64 인코딩할 때 주의할 점

✅ Base64 데이터 길이 계산 공식

• Base64 데이터 길이 = ((원본 길이 + 2) / 3) * 4
• 데이터 크기가 약 33% 증가
• 대량 파일 전송 시 데이터 크기 초과 주의 필요 ( 이메일 전송 같은 경우 용량 제한 체크 필요 )

✅ Base64 패딩(Padding) 처리

• 패딩(Padding) 처리는 입력 데이터의 길이가 3바이트의 배수가 아닐 때 발생
  • Base64 는 바이트(24비트) 단위로 처리하여, 이를 4개의 Base64 문자로 인코딩하므로 결과는 항상 4의 배수 길이가 되어야 함.
• 부족할 경우 '=' 문자로 패딩 추가 (ex: 2바이트 남은 경우: 'TQ==', 1바이트 남은 경우 'TWE=' )
• ABAP의 표준 인코딩 기능은 자동 패딩 처리됨

✅ Base64 줄바꿈(Line Break) 문제

• 기본적으로 줄바꿈 없이 긴 문자열로 생성
• 일부 구형 시스템은 76자마다 줄바꿈 요구 (MIME 표준)
• ABAP 기본 인코딩은 줄바꿈 없이 처리 (현대 API 표준에 적합)

 

---

ℹ️ 같이 읽으면 좋은 포스팅

🔗 ABAP Byte 타입과 Hexadecimal(16진수) 관계

ABAP Byte 타입과 Hexadecimal(16진수) 관계