Een neutraal, met bronnen onderbouwd overzicht van de OpenAPI-client- en codegeneratie-opties voor Delphi- en C++ Builder-ontwikkelaars in 2026: sgcOpenAPI, OpenAPI Generator, Swagger Codegen, mORMot 2, TMS XData met de bijbehorende OpenAPI Delphi Generator, en de route van handgeschreven REST-clients. Elke functieclaim verwijst naar de eigen documentatie van het project.
Een samenvatting van één alinea per optie, met een link naar de officiële documentatie of repository. De gedetailleerde vergelijking staat in de matrix hieronder.
eSeGeCe · Commercieel
Commerciële Delphi-/C++ Builder-componentsuite. Parseert OpenAPI 3.x JSON-/YAML- en Swagger 1.x-/2.x-specificaties en genereert vervolgens native Object Pascal-interfaces, -records en -enumeraties die schoon compileren onder VCL en FireMonkey, van Delphi 7 tot en met RAD Studio 13. Levert 1.195+ kant-en-klare Pascal-SDK's voor Amazon AWS (280+), Google Cloud (250+), Microsoft Azure (650+) en Microsoft Graph (15+). Gegenereerde code heeft geen externe afhankelijkheden buiten de sgcOpenAPI-runtime.
OpenAPI Tools-community · Apache 2.0 (open source)
Open-source Java-tool, oorspronkelijk een fork van Swagger Codegen, met 60+ client-generators en 40+ server-stub-generators. Genereert clients en/of servers voor C, C#, C++ (cpp-restsdk, Qt5, Oat++, Tizen, Unreal Engine 4), Go, Java, Kotlin, PHP, Python, Rust, TypeScript en nog veel meer. De officiële generator-lijst bevat geen Delphi-/Object Pascal-/Free Pascal-target.
SmartBear / community · Apache 2.0 (open source)
Het oorspronkelijke Java-codegeneratorproject van SmartBear, waarvan OpenAPI Generator in 2018 werd geforkt. Ondersteunt 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 en TypeScript. De 3.x-tak ondersteunt OpenAPI 3.0; de 2.x-tak alleen OpenAPI 2.0 (Swagger). In geen van beide takken is een Delphi- of Object Pascal-generator aanwezig.
Arnaud Bouchez / Synopse · MPL / GPL / LGPL (open source)
mORMot 2 levert mormot.net.openapi.pas, dat een OpenAPI 3.x- of Swagger 2.0-document (bestand of URL) inleest en FPC-/Delphi-Pascal-client-units uitvoert — high-level records en dynamische arrays als DTO's, Pascal-enumeraties voor enum-waarden en vertaling van HTTP-statuscodes naar excepties. De unit richt zich op FPC en Delphi 7 / 2009 en nieuwer, en draait als onderdeel van het bredere mORMot SOA-/ORM-framework.
TMS Software / Landgraf Software · Commercieel (XData) / Apache 2.0 + Commons Clause (generator)
TMS XData is een commercieel Delphi REST-/JSON-/ORM-remoting-framework. Een XData-server kan een OpenAPI- (voorheen Swagger-)document publiceren op /openapi/swagger.json voor de eigen endpoints en werkt samen met SwaggerUI / Redoc. De bijbehorende OpenAPI Delphi Generator (oorspronkelijk meegeleverd in XData, nu een afzonderlijk open-sourceproject op landgraf-dev/openapi-delphi-generator) verwerkt Swagger 2.0-/OpenAPI 3.0-documenten en geeft Delphi-interfaces plus DTO-classes uit voor gebruik met TXDataClient.
Indy Project / Embarcadero · BSD / MPL (Indy) · RAD Studio EULA (THTTPClient)
Een veelvoorkomende realiteit: ontwikkelaars schrijven de REST-client met de hand met TIdHTTP (Indy) of System.Net.HttpClient.THTTPClient (meegeleverd met Delphi). Geen codegeneratie, geen schema; handmatige JSON-marshalling met de RTL-JSON-units (of TJSONObject). Authenticatie, retry-logica en paginatie worden ook met de hand geschreven.
Een vinkje () betekent dat het project native ondersteuning documenteert. Een streepje (—) betekent dat het project dit niet native levert. Een tilde (~) betekent gedeeltelijk / via add-on / niet expliciet gedocumenteerd — zie het hoofdstuk Bronnen voor wat we konden verifiëren.
| Functie | sgcOpenAPI | OpenAPI Generator | Swagger Codegen | mORMot 2 OpenAPI-clientgenerator | TMS XData & OpenAPI Delphi Generator | Handgeschreven REST-clients (Indy / THTTPClient) |
|---|---|---|---|---|---|---|
| Genereert Delphi-client Native Object Pascal-client vanuit OpenAPI 3.x | — | — | — | |||
| Genereert C++ Builder-code C++ Builder VCL-/FMX-targets (BCC32 / BCC64) | ~ | ~ | ~ | ~ | — | |
| Genereert serverstubs Server-side scaffolding vanuit een OpenAPI-spec | — | — | ||||
| HTTP/2-client Native HTTP/2-transport in de gegenereerde client | ~ | ~ | — | ~ | ~ | |
| Getypeerde JSON-DTO's Sterk getypeerde classes / records / enums | ~ | |||||
| OAuth2-/JWT-helpers Ingebouwde OAuth2-flows en JWT-helpers | ~ | |||||
| Async-/sync-helpers Zowel asynchrone als synchrone call-patronen | ~ | |||||
| Multiplatform-runtime Win / macOS / Linux / iOS / Android | ||||||
| Meegeleverde leverancier-SDK's AWS / Azure / GCP / Microsoft Graph kant-en-klaar | — | — | — | — | — | |
| Commercieel gebruik toegestaan Licentie staat closed-source commercieel gebruik toe | ||||||
| Actief onderhoud Release of tagged activiteit in de laatste 12–18 maanden | ~ | |||||
| Licentiemodel Licentietype | Commercieel | Apache 2.0 (open source) | Apache 2.0 (open source) | MPL / GPL / LGPL | Commercieel (XData) + Apache 2.0 + CC (generator) | BSD / MPL (Indy) · RAD Studio EULA (THTTPClient) |
Elke optie hier heeft een reële doelgroep. De juiste keuze hangt ervan af of je naast clients ook serverstubs nodig hebt, welke Pascal-toolchains je ondersteunt, je licentievoorkeur en of meegeleverde leverancier-SDK's je tijd besparen.
Kies sgcOpenAPI als je één commerciële tool wilt die Delphi 7–13- en C++ Builder-clientcode genereert vanuit elke OpenAPI 3.x- of Swagger 2.x-spec, als je kant-en-klare Pascal-SDK's voor AWS, Azure, Google Cloud of Microsoft Graph meegeleverd wilt hebben, als je VCL plus FireMonkey voor macOS / Linux / iOS / Android target, en als je geen externe runtime-afhankelijkheden buiten de sgcOpenAPI-units nodig hebt.
Kies OpenAPI Generator als je team clients of serverstubs bouwt in andere talen dan Delphi — C#, Java, Go, TypeScript, Rust, Python — vanuit dezelfde OpenAPI-spec, als je zowel clients als serverstubs uit één tool nodig hebt, of als Apache 2.0-licentie en een grote community van template-bijdragers belangrijk voor je zijn.
Kies Swagger Codegen als je het SmartBear-/Swagger-ecosysteem (SwaggerHub, Swagger Editor) end-to-end gebruikt, als je de dichtstbijzijnde officieel onderhouden opvolger van de historische Swagger 2.0-codegenerator wilt, en als je targets mainstream JVM-/.NET-/scriptingtalen zijn in plaats van Delphi.
Kies de mORMot 2 OpenAPI-generator als je project al mORMot gebruikt voor ORM, SOA of hosting, als je een open-source Pascal-native codegenerator onder MPL / GPL / LGPL wilt, of als je FPC op Linux / BSD / macOS target voor zowel de clientgenerator als de resulterende code.
Kies TMS XData als je de server ook in Delphi bouwt en server + client + ORM-remoting van één leverancier wilt, als SwaggerUI-/Redoc-browsing van je eigen servicecontracten een vereiste is, of als je al TMS Business / All-Access licentieert. Kies de zelfstandige OpenAPI Delphi Generator als je alleen client-side codegeneratie nodig hebt en de voorkeur geeft aan Apache 2.0 + Commons Clause-licentie.
Kies een handgeschreven REST-client als het API-oppervlak klein is (een handvol endpoints), als je geen componenten van derden mag meeleveren wegens licentie- of compliance-redenen, of als de API geen gepubliceerde OpenAPI-spec heeft en een generator je niets oplevert. Indy en THTTPClient worden beide met RAD Studio meegeleverd, dus er is geen extra afhankelijkheid.
Korte notities over de verschillen als je overstapt van een van de bovenstaande opties. Niet polemisch — gewoon de praktische mapping.
OpenAPI Generator target geen Delphi, dus "migratie" betekent hier dat je C#-/Java-/TS-clients naast de sgcOpenAPI Delphi-client genereert vanuit dezelfde spec. Als je vorige opzet een door OpenAPI Generator gebouwde C#-wrapper was die vanuit Delphi via COM of REST werd gebruikt, verwijdert sgcOpenAPI die laag door direct de Delphi-client te produceren.
Swagger Codegen target geen Delphi. Als je vorige workflow een generieke C#- of Java-client exporteerde en die voor Delphi wrapte, kun je met sgcOpenAPI de Delphi-client direct vanuit dezelfde spec genereren en verdwijnt de wrapperlaag.
De OpenAPI-clientgenerator van mORMot zit in het bredere framework. Als je toepassing alleen de generator gebruikt en niet de SOA-/ORM-/WebSocket-lagen, geeft sgcOpenAPI je een zelfstandige, drop-in componentset zonder de extra units. Andersom geldt: als je ook mORMot's SOA-contracten en ORM gebruikt, betekent overstappen puur voor de OpenAPI-generator dat je die onderdelen opnieuw moet implementeren, en die levert sgcOpenAPI niet.
Als je momenteel XData's ingebouwde importer gebruikt om clients te genereren vanuit Swagger-specs van derden, let dan op: de importer is afgesplitst in het open-sourceproject landgraf-dev/openapi-delphi-generator — de in-XData classes worden gedocumenteerd als deprecated. sgcOpenAPI is een andere, commercieel ondersteunde generator die OpenAPI 3.x native inleest, SDK's voor de grote cloudplatforms meelevert en Delphi 7–13 plus C++ Builder target.
Handgeschreven clients verouderen snel wanneer het API-oppervlak groeit of de upstreamservice nieuwe endpoints publiceert. sgcOpenAPI kan in seconden dezelfde DTO's en methode-signatures genereren vanuit de gepubliceerde spec, zodat de handgeschreven logica vrijkomt voor de delen die het echt nodig hebben (custom retries, telemetry, business glue). De gegenereerde code gebruikt vergelijkbaar HTTP-transport, dus het mentale model van de ontwikkelaar blijft dichtbij.
Elke cel in de matrix hierboven is herleidbaar tot een van deze officiële documentatiepagina's, repositories of release notes. Alle URL's zijn op het moment van schrijven met een HEAD-check geverifieerd.