2026년 Delphi와 C++ Builder 개발자가 사용할 수 있는 OpenAPI 클라이언트 및 코드 생성 옵션을 중립적으로, 출처와 함께 살펴봐요: sgcOpenAPI, OpenAPI Generator, Swagger Codegen, mORMot 2, TMS XData와 동반 도구 OpenAPI Delphi Generator, 그리고 수작업 REST 클라이언트 경로예요. 모든 기능 설명은 해당 프로젝트의 공식 문서에 링크되어 있어요.
각 옵션의 한 단락 요약과 공식 문서 또는 저장소 링크예요. 자세한 비교는 아래 매트릭스에 있어요.
eSeGeCe · 상용
상용 Delphi / C++ Builder 컴포넌트 모음이에요. OpenAPI 3.x JSON / YAML과 Swagger 1.x / 2.x 사양을 파싱한 다음, Delphi 7부터 RAD Studio 13까지 VCL과 FireMonkey에서 깔끔하게 컴파일되는 네이티브 Object Pascal 인터페이스, 레코드, 열거형을 생성해요. 엔드포인트를 실시간 OpenAPI 문서로 게시하고 사양에서 핸들러를 바인딩하는 OpenAPI 서버 컴포넌트도 번들로 제공돼요. Amazon AWS(280개 이상), Google Cloud(250개 이상), Microsoft Azure(650개 이상), Microsoft Graph(15개 이상)를 포함한 1,195개 이상의 미리 빌드된 Pascal SDK를 함께 제공해요. 생성된 코드는 sgcOpenAPI 런타임 외에 외부 의존성이 없어요.
OpenAPI Tools 커뮤니티 · Apache 2.0(오픈 소스)
원래 Swagger Codegen에서 포크된 오픈 소스 Java 도구로, 60개 이상의 클라이언트 생성기와 40개 이상의 서버 스텁 생성기를 제공해요. C, C#, C++(cpp-restsdk, Qt5, Oat++, Tizen, Unreal Engine 4), Go, Java, Kotlin, PHP, Python, Rust, TypeScript 등을 위한 클라이언트와 서버를 생성해요. 공식 생성기 목록에는 Delphi / Object Pascal / Free Pascal 대상이 포함되어 있지 않아요.
SmartBear / 커뮤니티 · Apache 2.0(오픈 소스)
SmartBear가 만든 원조 Java 코드 생성기 프로젝트로, 2018년에 OpenAPI Generator가 여기서 포크되었어요. ActionScript, Ada, Apex, Bash, C#, C++, Clojure, Dart, Elixir, Erlang, Go, Groovy, Haskell, Java, Kotlin, Lua, Node.js, Objective-C, Perl, PHP, PowerShell, Python, R, Ruby, Rust, Scala, Swift, TypeScript를 지원해요. 3.x 라인은 OpenAPI 3.0을 지원하고, 2.x 라인은 OpenAPI 2.0(Swagger)만 지원해요. 두 라인 모두 Delphi나 Object Pascal 생성기는 없어요.
Arnaud Bouchez / Synopse · MPL / GPL / LGPL(오픈 소스)
mORMot 2는 mormot.net.openapi.pas를 제공해요. 이 유닛은 OpenAPI 3.x나 Swagger 2.0 문서(파일 또는 URL)를 읽고 FPC / Delphi Pascal 클라이언트 유닛을 생성해요 — DTO 역할의 상위 레벨 레코드와 동적 배열, 열거 값에 대한 Pascal 열거형, HTTP 상태 코드를 예외로 변환하는 처리가 포함돼요. 이 유닛은 FPC와 Delphi 7 / 2009 이상을 대상으로 하며, 더 넓은 mORMot SOA / ORM 프레임워크의 일부로 동작해요.
TMS Software / Landgraf Software · 상용(XData) / Apache 2.0 + Commons Clause(생성기)
TMS XData는 상용 Delphi REST / JSON / ORM 리모팅 프레임워크예요. XData 서버는 자체 엔드포인트에 대해 /openapi/swagger.json 경로에 OpenAPI(이전 명칭 Swagger) 문서를 게시할 수 있고, SwaggerUI / Redoc과 함께 사용할 수 있어요. 동반 도구인 OpenAPI Delphi Generator(원래 XData에 번들되었지만 지금은 landgraf-dev/openapi-delphi-generator에서 별도의 오픈 소스 프로젝트)는 Swagger 2.0 / OpenAPI 3.0 문서를 소비해 Delphi 인터페이스와 TXDataClient에서 사용할 DTO 클래스를 생성해요.
Indy Project / Embarcadero · BSD / MPL(Indy) · RAD Studio EULA(THTTPClient)
흔한 현실이에요. 개발자가 TIdHTTP(Indy)나 System.Net.HttpClient.THTTPClient(Delphi에 번들됨)로 REST 클라이언트를 직접 작성해요. 코드 생성도 없고 스키마도 없이, RTL JSON 유닛(또는 TJSONObject)으로 수작업 JSON 마샬링을 해요. 인증, 재시도 로직, 페이지네이션도 직접 구현해야 해요.
체크()는 프로젝트가 네이티브 지원을 문서화하고 있다는 뜻이에요. 대시(—)는 네이티브로 제공되지 않는다는 뜻이에요. 물결 표시(~)는 부분 지원 / 애드온 경유 / 명시적 문서가 없다는 뜻이에요 — 확인 가능한 내용은 출처 섹션을 참고하세요.
| 기능 | sgcOpenAPI | OpenAPI Generator | Swagger Codegen | mORMot 2 OpenAPI 클라이언트 생성기 | TMS XData와 OpenAPI Delphi Generator | 수작업 REST 클라이언트(Indy / THTTPClient) |
|---|---|---|---|---|---|---|
| Delphi 클라이언트 생성 OpenAPI 3.x에서 네이티브 Object Pascal 클라이언트 생성 | — | — | — | |||
| C++ Builder 코드 생성 C++ Builder VCL / FMX 대상(BCC32 / BCC64) | ~ | ~ | ~ | ~ | — | |
| 서버 스텁 생성 OpenAPI 사양에서 서버 사이드 스캐폴딩 | — | |||||
| 네이티브 Delphi 서버 런타임 생성된 엔드포인트를 Delphi / C++ Builder 프로세스에서 호스팅하는 임베디드 HTTP 서버 컴포넌트 | — | — | ~ | — | ||
실시간 OpenAPI 문서 게시
서버가 자체 openapi.json / openapi.yaml을 런타임에 노출해 검색과 SwaggerUI / Redoc에서 사용
|
— | — | — | — | ||
| 서버 사이드 요청 / 응답 검증 인바운드 요청과 아웃바운드 응답을 런타임에 OpenAPI 스키마로 검증 | ~ | ~ | ~ | ~ | — | |
| HTTP/2 클라이언트 생성된 클라이언트에서 네이티브 HTTP/2 전송 | ~ | ~ | — | ~ | ~ | |
| 타입 지정 JSON DTO 강타입 클래스 / 레코드 / 열거형 | ~ | |||||
| OAuth2 / JWT 헬퍼 내장 OAuth2 플로우와 JWT 헬퍼 | ~ | |||||
| 비동기 / 동기 헬퍼 비동기와 동기 호출 패턴 모두 지원 | ~ | |||||
| 멀티 플랫폼 런타임 Win / macOS / Linux / iOS / Android | ||||||
| 번들된 벤더 SDK AWS / Azure / GCP / Microsoft Graph 미리 빌드 제공 | — | — | — | — | — | |
| 상용 사용 허용 라이선스가 비공개 소스 상용 사용을 허용 | ||||||
| 활발한 유지 보수 최근 12~18개월간 릴리스 또는 태그된 활동이 있음 | ~ | |||||
| 라이선스 모델 라이선스 유형 | 상용 | Apache 2.0(오픈 소스) | Apache 2.0(오픈 소스) | MPL / GPL / LGPL | 상용(XData) + Apache 2.0 + CC(생성기) | BSD / MPL(Indy) · RAD Studio EULA(THTTPClient) |
위 옵션 중 하나에서 전환할 때의 차이점에 대한 짧은 메모예요. 비판적인 글이 아니라 실용적인 매핑이에요.
OpenAPI Generator는 Delphi를 대상으로 하지 않으므로 여기서 "마이그레이션"이란 같은 사양에서 sgcOpenAPI Delphi 클라이언트와 함께 C# / Java / TS 클라이언트를 생성한다는 뜻이에요. 기존 구성이 OpenAPI-Generator로 만든 C# 래퍼를 COM이나 REST를 통해 Delphi에서 소비하는 형태였다면, sgcOpenAPI는 Delphi 클라이언트를 직접 생성해 그 계층을 제거해요.
Swagger Codegen은 Delphi를 대상으로 하지 않아요. 기존 워크플로가 일반적인 C# 또는 Java 클라이언트를 내보내고 Delphi용으로 래핑하는 형태였다면, sgcOpenAPI는 같은 사양에서 Delphi 클라이언트를 직접 생성하게 해 주고 래퍼 계층을 제거해요.
mORMot의 OpenAPI 클라이언트 생성기는 더 넓은 프레임워크 안에 있어요. 애플리케이션이 SOA / ORM / WebSocket 계층은 사용하지 않고 생성기만 사용한다면, sgcOpenAPI는 추가 유닛 없이 독립형 드롭인 컴포넌트 세트를 제공해요. 반대로 mORMot의 SOA 계약과 ORM도 함께 사용한다면, OpenAPI 생성기만을 위해 전환하면 그 부분들을 다시 구현해야 해요. sgcOpenAPI는 그러한 기능을 제공하지 않아요.
현재 XData의 내장 임포터로 서드 파티 Swagger 사양에서 클라이언트를 생성하고 있다면, 그 임포터는 오픈 소스 landgraf-dev/openapi-delphi-generator 프로젝트로 분리되었고 XData 내 클래스는 지원 중단으로 문서화되었다는 점에 유의하세요. sgcOpenAPI는 OpenAPI 3.x를 네이티브로 읽고, 주요 클라우드 플랫폼용 SDK를 번들로 제공하며, Delphi 7~13과 C++ Builder를 대상으로 하는, 상용으로 지원되는 별도의 생성기예요.
수작업 클라이언트는 API 표면이 커지거나 업스트림 서비스가 새 엔드포인트를 게시할 때 노후화돼요. sgcOpenAPI는 게시된 사양에서 동일한 DTO와 메서드 시그니처를 몇 초 만에 생성할 수 있어 수작업 로직을 정말 필요한 부분(커스텀 재시도, 텔레메트리, 비즈니스 연결)에만 쓸 수 있게 해 줘요. 생성된 코드는 유사한 HTTP 전송을 사용해 개발자의 사고 모델이 가깝게 유지돼요.
위 매트릭스의 각 셀은 다음 공식 문서 페이지, 저장소, 릴리스 노트 중 하나로 연결돼요. 모든 URL은 작성 시점에 HEAD로 확인했어요.