Una panoramica neutrale e con fonti citate delle opzioni di generazione client e codice OpenAPI disponibili per gli sviluppatori Delphi e C++ Builder nel 2026: sgcOpenAPI, OpenAPI Generator, Swagger Codegen, mORMot 2, TMS XData con il suo companion OpenAPI Delphi Generator e l'approccio del client REST scritto a mano. Ogni affermazione sulle funzionalità rimanda alla documentazione del progetto stesso.
Un riassunto di un paragrafo per ciascuna opzione, con un link alla documentazione o al repository ufficiale. Il confronto dettagliato è nella matrice qui sotto.
eSeGeCe · Commerciale
Suite di componenti commerciali per Delphi / C++ Builder. Analizza specifiche OpenAPI 3.x JSON / YAML e Swagger 1.x / 2.x, quindi genera interfacce, record ed enumerazioni Object Pascal native che compilano senza problemi con VCL e FireMonkey da Delphi 7 fino a RAD Studio 13. Include inoltre un componente server OpenAPI che pubblica gli endpoint come documento OpenAPI live e collega gli handler a partire da una specifica. Fornisce oltre 1.195 SDK Pascal precompilati per Amazon AWS (oltre 280), Google Cloud (oltre 250), Microsoft Azure (oltre 650) e Microsoft Graph (oltre 15). Il codice generato non ha dipendenze esterne oltre il runtime di sgcOpenAPI.
Comunità OpenAPI Tools · Apache 2.0 (open source)
Strumento Java open source, originariamente derivato da Swagger Codegen, che offre oltre 60 generatori client e oltre 40 generatori di stub server. Genera client e/o server per C, C#, C++ (cpp-restsdk, Qt5, Oat++, Tizen, Unreal Engine 4), Go, Java, Kotlin, PHP, Python, Rust, TypeScript e molti altri. L'elenco ufficiale dei generatori non include un target Delphi / Object Pascal / Free Pascal.
SmartBear / comunità · Apache 2.0 (open source)
Il progetto originale di generazione codice in Java di SmartBear, da cui OpenAPI Generator è stato derivato nel 2018. Supporta 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 e TypeScript. La linea 3.x supporta OpenAPI 3.0; la linea 2.x supporta solo OpenAPI 2.0 (Swagger). Non esiste un generatore Delphi o Object Pascal in nessuna delle due linee.
Arnaud Bouchez / Synopse · MPL / GPL / LGPL (open source)
mORMot 2 include mormot.net.openapi.pas, che legge un documento OpenAPI 3.x o Swagger 2.0 (file o URL) e produce unit client Pascal per FPC / Delphi — record di alto livello e array dinamici come DTO, enumerazioni Pascal per i valori enum e traduzione dei codici di stato HTTP in eccezioni. L'unit è destinata a FPC e Delphi 7 / 2009 o successivi e funziona come parte del framework SOA / ORM mORMot più ampio.
TMS Software / Landgraf Software · Commerciale (XData) / Apache 2.0 + Commons Clause (generatore)
TMS XData è un framework commerciale Delphi per remoting REST / JSON / ORM. Un server XData può pubblicare un documento OpenAPI (precedentemente Swagger) su /openapi/swagger.json per i propri endpoint e si integra con SwaggerUI / Redoc. Il companion OpenAPI Delphi Generator (originariamente integrato in XData, ora un progetto open source separato all'indirizzo landgraf-dev/openapi-delphi-generator) consuma documenti Swagger 2.0 / OpenAPI 3.0 e produce interfacce Delphi e classi DTO da utilizzare con TXDataClient.
Indy Project / Embarcadero · BSD / MPL (Indy) · EULA RAD Studio (THTTPClient)
Una realtà comune: gli sviluppatori scrivono il client REST a mano utilizzando TIdHTTP (Indy) o System.Net.HttpClient.THTTPClient (incluso in Delphi). Niente generazione di codice, niente schema; marshalling JSON manuale con le unit JSON della RTL (o TJSONObject). Anche l'autenticazione, la logica di retry e la paginazione sono scritte a mano.
Un segno di spunta () indica che il progetto documenta il supporto nativo. Un trattino (—) indica che il progetto non lo fornisce nativamente. Una tilde (~) indica supporto parziale / tramite add-on / non esplicitamente documentato — consulta la sezione Fonti per ciò che è stato possibile verificare.
| Funzionalità | sgcOpenAPI | OpenAPI Generator | Swagger Codegen | Generatore client OpenAPI di mORMot 2 | TMS XData e OpenAPI Delphi Generator | Client REST scritti a mano (Indy / THTTPClient) |
|---|---|---|---|---|---|---|
| Genera client Delphi Client Object Pascal nativo da OpenAPI 3.x | — | — | — | |||
| Genera codice C++ Builder Target C++ Builder VCL / FMX (BCC32 / BCC64) | ~ | ~ | ~ | ~ | — | |
| Genera stub server Scaffolding lato server da una specifica OpenAPI | — | |||||
| Runtime server Delphi nativo Componente server HTTP integrato che ospita gli endpoint generati in un processo Delphi / C++ Builder | — | — | ~ | — | ||
Pubblica documento OpenAPI live
Il server espone il proprio openapi.json / openapi.yaml a runtime per discovery e SwaggerUI / Redoc
|
— | — | — | — | ||
| Validazione richieste / risposte lato server Le richieste in ingresso e le risposte in uscita vengono validate a runtime rispetto agli schemi OpenAPI | ~ | ~ | ~ | ~ | — | |
| Client HTTP/2 Trasporto HTTP/2 nativo nel client generato | ~ | ~ | — | ~ | ~ | |
| DTO JSON tipizzati Classi / record / enum fortemente tipizzati | ~ | |||||
| Helper OAuth2 / JWT Flussi OAuth2 e helper JWT integrati | ~ | |||||
| Helper async / sync Pattern di chiamata sia asincroni che sincroni | ~ | |||||
| Runtime multipiattaforma Win / macOS / Linux / iOS / Android | ||||||
| SDK vendor inclusi AWS / Azure / GCP / Microsoft Graph precompilati | — | — | — | — | — | |
| Uso commerciale consentito La licenza consente l'uso commerciale closed-source | ||||||
| Manutenzione attiva Release o tag negli ultimi 12–18 mesi | ~ | |||||
| Modello di licenza Tipo di licenza | Commerciale | Apache 2.0 (open source) | Apache 2.0 (open source) | MPL / GPL / LGPL | Commerciale (XData) + Apache 2.0 + CC (generatore) | BSD / MPL (Indy) · EULA RAD Studio (THTTPClient) |
Brevi note sulle differenze se stai passando da una delle opzioni sopra. Non polemiche — solo la mappatura pratica.
OpenAPI Generator non ha Delphi come target, quindi qui "migrazione" significa generare client C# / Java / TS insieme al client Delphi di sgcOpenAPI dalla stessa specifica. Se la configurazione precedente era un wrapper C# costruito con OpenAPI Generator e consumato da Delphi tramite COM o REST, sgcOpenAPI elimina quel livello producendo direttamente il client Delphi.
Swagger Codegen non ha Delphi come target. Se il tuo flusso di lavoro precedente esportava un client C# o Java generico e lo incapsulava per Delphi, sgcOpenAPI ti consente di generare il client Delphi direttamente dalla stessa specifica eliminando il livello wrapper.
Il generatore client OpenAPI di mORMot vive all'interno del framework più ampio. Se la tua applicazione usa solo il generatore e non i livelli SOA / ORM / WebSocket, sgcOpenAPI ti offre un set di componenti standalone e drop-in senza le unit aggiuntive. Al contrario, se usi anche i contratti SOA e l'ORM di mORMot, passare solo per il generatore OpenAPI significherebbe reimplementare quelle parti, che sgcOpenAPI non fornisce.
Se attualmente usi l'importer integrato di XData per generare client da specifiche Swagger di terze parti, nota che l'importer è stato separato nel progetto open source landgraf-dev/openapi-delphi-generator — le classi interne di XData sono documentate come deprecate. sgcOpenAPI è un generatore diverso, supportato commercialmente, che legge nativamente OpenAPI 3.x, include SDK per le principali piattaforme cloud e ha come target Delphi 7–13 più C++ Builder.
I client scritti a mano invecchiano male quando la superficie dell'API cresce o quando il servizio upstream pubblica nuovi endpoint. sgcOpenAPI può generare gli stessi DTO e firme di metodo dalla specifica pubblicata in pochi secondi, liberando la logica scritta a mano per le parti che ne hanno davvero bisogno (retry personalizzati, telemetria, collante di business). Il codice generato utilizza un trasporto HTTP simile, quindi il modello mentale dello sviluppatore rimane vicino.
Ogni cella nella matrice sopra rimanda a una di queste pagine di documentazione ufficiale, repository o note di rilascio. Tutti gli URL sono stati verificati con HEAD al momento della scrittura.