Spring Boot 기반 SAP RFC / OData 테스트 콘솔 만들기

Github

https://github.com/Sunghyun01/SAP-INTEGRATION-CONSOLE

1. 전체 구성

전체 구조는 단순하게 잡았다.

Browser
  ↓
Spring Boot
  ├─ Static HTML / CSS / jQuery
  ├─ OData Test API
  └─ RFC Test API
        ↓
      SAP System

React, Vue 같은 프론트엔드 프레임워크는 사용하지 않았다.
테스트 콘솔 목적이라 Spring Boot에서 정적 리소스를 직접 제공하는 방식이 가장 간단했다.


2. 사용 기술

Backend     : Spring Boot
Frontend    : HTML, CSS, jQuery
SAP OData   : Java HttpClient
SAP RFC     : SAP JCo
Runtime     : Docker
Build Tool  : Gradle

3. 프로젝트 구조

sap-integration-console/
├─ backend/
│  ├─ libs/
│  │  ├─ sapjco3.jar
│  │  └─ libsapjco3.so
│  │
│  ├─ src/main/java/com/sapconsole/app/
│  │  ├─ client/
│  │  │  ├─ SapODataClient.java
│  │  │  └─ SapRfcClient.java
│  │  │
│  │  ├─ controller/
│  │  │  ├─ ODataTestController.java
│  │  │  ├─ RfcTestController.java
│  │  │  └─ SystemController.java
│  │  │
│  │  ├─ service/
│  │  │  ├─ ODataServiceTest.java
│  │  │  └─ RfcServiceTest.java
│  │  │
│  │  ├─ config/
│  │  │  └─ SapProperties.java
│  │  │
│  │  └─ dto/
│  │     ├─ ApiResponse.java
│  │     ├─ ODataActionRequest.java
│  │     └─ RfcCallRequest.java
│  │
│  └─ src/main/resources/
│     ├─ application.yml
│     └─ static/
│        ├─ index.html
│        ├─ css/style.css
│        └─ js/app.js
│
└─ docker-compose.yml

4. SAP JCo 설정

RFC 호출을 위해 SAP JCo 파일을 프로젝트에 추가했다.

JCo 파일은 아래 저장소에서 내려받았다.

https://github.com/easonjim/jco-sdk

Docker Linux 컨테이너에서 실행할 것이므로 Linux용 파일을 사용했다.

backend/libs/
├─ sapjco3.jar
└─ libsapjco3.so

Gradle에는 로컬 jar 의존성을 추가했다.

implementation files('libs/sapjco3.jar')

Docker 실행 시 native library 경로를 잡아주기 위해 아래 옵션을 사용했다.

ENV LD_LIBRARY_PATH=/app/libs

ENTRYPOINT ["java", "-Djava.library.path=/app/libs", "-jar", "app.jar"]

5. Dockerfile 구성

Spring Boot 애플리케이션을 Docker에서 실행하기 위해 멀티 스테이지 빌드로 구성했다.

FROM gradle:8.10.2-jdk17 AS build

WORKDIR /app

COPY build.gradle settings.gradle ./
COPY libs ./libs
COPY src ./src

RUN gradle clean bootJar --no-daemon


FROM eclipse-temurin:17-jre

WORKDIR /app

COPY --from=build /app/build/libs/*.jar app.jar
COPY libs ./libs

ENV LD_LIBRARY_PATH=/app/libs

EXPOSE 8080

ENTRYPOINT ["java", "-Djava.library.path=/app/libs", "-jar", "app.jar"]

backend/libs에 있는 JCo 파일은 Docker 이미지 내부의 /app/libs로 복사된다.


6. docker-compose 구성

Spring Boot 컨테이너 하나만 실행하도록 구성했다.

services:
  app:
    build:
      context: ./backend
      dockerfile: Dockerfile
    container_name: sap-integration-console
    ports:
      - "8080:8080"
    extra_hosts:
      - "vhcala4hci:host-gateway"

SAP Trial 환경이 로컬 Docker 또는 로컬 호스트에서 실행 중인 경우, 컨테이너 내부에서 vhcala4hci 호스트명을 찾을 수 있도록 extra_hosts를 추가했다.


7. application.yml 설정

SAP 접속 정보는 application.yml에서 관리했다.

server:
  port: 8080

sap:
  odata:
    base-url: "http://vhcala4hci:50000"
    service-path: "/sap/opu/odata4/sap/zui_zedu_enroll_edit_o4/srvd/sap/zui_zedu_enroll_edit/0001"
    client: "001"
    username: "DEVELOPER"
    password: "********"

  rfc:
    ashost: "vhcala4hci"
    sysnr: "00"
    client: "001"
    user: "DEVELOPER"
    passwd: "********"
    lang: "EN"

로컬 테스트 목적이라 OData는 HTTP 포트로 호출했다.

http://vhcala4hci:50000

8. 화면 구성

화면은 하나의 테스트 콘솔 형태로 만들었다.

SAP Integration Console

1. System Test
   - Health Check

2. OData Test
   - Service Root
   - Metadata
   - EntitySet 조회
   - 단건 조회
   - Bound Action 호출

3. RFC Test
   - Function Module명 입력
   - Import Parameter JSON 입력
   - RFC 호출

4. Result
   - 응답 JSON 출력

응답 결과는 pre 영역에 출력하고, JSON 문자열은 프론트에서 한 번 더 파싱해 보기 좋게 표시했다.

function showResult(data, isError) {
    const formatted = formatResult(data);

    $('#result')
        .removeClass('is-success is-error')
        .addClass(isError ? 'is-error' : 'is-success')
        .text(formatted);
}

9. OData 호출 흐름

OData 호출은 Spring Boot 백엔드에서 Java HttpClient를 사용해 처리했다.

주요 API는 다음과 같이 구성했다.

GET  /api/odata/service-root
GET  /api/odata/metadata
GET  /api/odata/entity?entitySet=Enrollment
GET  /api/odata/entity/{entitySet}/{keyName}/{keyValue}
POST /api/odata/action

Bound Action 호출 요청 예시는 다음과 같다.

{
  "entitySet": "Enrollment",
  "keyName": "EnrollId",
  "keyValue": "ENR000000001",
  "actionName": "set_completed"
}

실제 호출 URL은 아래 형태로 생성했다.

/sap/opu/odata4/sap/{service_binding}/srvd/sap/{service_definition}/0001/Enrollment(EnrollId='ENR000000001')/SAP__self.set_completed?sap-client=001

변경성 요청인 Action 호출 전에는 CSRF Token을 먼저 조회한 뒤, Token과 Cookie를 함께 전달했다.

1. GET EntitySet with X-CSRF-Token: Fetch
2. 응답 Header에서 x-csrf-token, set-cookie 추출
3. POST Bound Action 호출 시 Token과 Cookie 전달

10. RFC 호출 흐름

RFC 호출은 SAP JCo를 사용했다.

화면에서는 Function Module명과 Import Parameter를 JSON으로 입력받는다.

요청 예시:

{
  "functionName": "STFC_CONNECTION",
  "importParams": {
    "REQUTEXT": "Hello SAP RFC"
  }
}

백엔드에서는 입력받은 Function Module을 조회하고, Import Parameter를 세팅한 뒤 실행한다.

1. JCoDestination 생성
2. Function Repository에서 Function Module 조회
3. Import Parameter 세팅
4. function.execute(destination)
5. Export Parameter 결과 반환

11. 실행 방법

SAP Trial 컨테이너 또는 SAP 시스템을 먼저 실행한다.

docker start -ai a4h

이후 테스트 콘솔을 실행한다.

docker compose up --build

브라우저에서 접속한다.

http://localhost:8080

12. 테스트 항목

OData 테스트

Service Root 호출
Metadata 조회
Enrollment EntitySet 조회
Enrollment 단건 조회
set_completed Bound Action 호출

RFC 테스트

STFC_CONNECTION 호출
사용자 정의 RFC Function Module 호출
Import Parameter 전달
Export Parameter 확인

13. 정리

이번 구성은 SAP 연동을 빠르게 확인하기 위한 테스트 콘솔이다.

복잡한 프론트엔드 구조를 제외하고 Spring Boot 단일 애플리케이션으로 구성했기 때문에 실행과 디버깅이 단순하다.

HTML / CSS / jQuery
        ↓
Spring Boot API
        ↓
SAP OData / SAP RFC

OData와 RFC 호출을 한 화면에서 테스트할 수 있어 SAP 연동 개발 초기 검증용으로 활용하기 좋다.


Profile picture

@shyun_im

COMMENTS

댓글

GitHub 계정으로 로그인하면 댓글을 남길 수 있습니다.

댓글을 불러오는 중입니다.