Um levantamento imparcial, com fontes citadas, das opções de cliente OpenAPI e geração de código disponíveis para desenvolvedores Delphi e C++ Builder em 2026: sgcOpenAPI, OpenAPI Generator, Swagger Codegen, mORMot 2, TMS XData com seu companheiro OpenAPI Delphi Generator e o caminho de clientes REST escritos à mão. Cada afirmação sobre recursos tem link para a documentação oficial do projeto.
Um resumo de um parágrafo para cada opção, com link para a documentação ou repositório oficial. A comparação detalhada está na matriz abaixo.
eSeGeCe · Comercial
Suite comercial de componentes para Delphi / C++ Builder. Analisa especificações OpenAPI 3.x JSON / YAML e Swagger 1.x / 2.x e gera interfaces, records e enumerações nativas em Object Pascal que compilam sem problemas sob VCL e FireMonkey do Delphi 7 ao RAD Studio 13. Também inclui um componente de servidor OpenAPI que publica endpoints como um documento OpenAPI ao vivo e associa handlers a partir de uma spec. Inclui mais de 1.195 SDKs Pascal pré-compilados para Amazon AWS (280+), Google Cloud (250+), Microsoft Azure (650+) e Microsoft Graph (15+). O código gerado não tem dependências externas além do runtime do sgcOpenAPI.
Comunidade OpenAPI Tools · Apache 2.0 (código aberto)
Ferramenta Java de código aberto, originalmente derivada do Swagger Codegen, com mais de 60 geradores de clientes e 40 geradores de stubs de servidor. Gera clientes e/ou servidores para C, C#, C++ (cpp-restsdk, Qt5, Oat++, Tizen, Unreal Engine 4), Go, Java, Kotlin, PHP, Python, Rust, TypeScript e muito mais. A lista oficial de geradores não inclui um alvo Delphi / Object Pascal / Free Pascal.
SmartBear / comunidade · Apache 2.0 (código aberto)
O projeto Java original de geração de código da SmartBear, do qual o OpenAPI Generator foi derivado em 2018. Suporta 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. A linha 3.x suporta OpenAPI 3.0; a linha 2.x suporta apenas OpenAPI 2.0 (Swagger). Não existe gerador Delphi ou Object Pascal em nenhuma das linhas.
Arnaud Bouchez / Synopse · MPL / GPL / LGPL (código aberto)
O mORMot 2 inclui mormot.net.openapi.pas, que lê um documento OpenAPI 3.x ou Swagger 2.0 (arquivo ou URL) e emite units Pascal cliente para FPC / Delphi — records de alto nível e arrays dinâmicos como DTOs, enumerações Pascal para valores de enum e tradução de códigos de status HTTP em exceções. A unit tem como alvo FPC e Delphi 7 / 2009 e posteriores, e roda como parte do framework mais amplo de SOA / ORM do mORMot.
TMS Software / Landgraf Software · Comercial (XData) / Apache 2.0 + Commons Clause (gerador)
O TMS XData é um framework comercial de remoting REST / JSON / ORM para Delphi. Um servidor XData pode publicar um documento OpenAPI (anteriormente Swagger) em /openapi/swagger.json para seus próprios endpoints, e funciona com SwaggerUI / Redoc. O companheiro OpenAPI Delphi Generator (originalmente incluído no XData, agora um projeto open source separado em landgraf-dev/openapi-delphi-generator) consome documentos Swagger 2.0 / OpenAPI 3.0 e emite interfaces Delphi mais classes DTO para uso com TXDataClient.
Indy Project / Embarcadero · BSD / MPL (Indy) · EULA do RAD Studio (THTTPClient)
Uma realidade comum: desenvolvedores escrevem o cliente REST à mão usando TIdHTTP (Indy) ou System.Net.HttpClient.THTTPClient (incluído com o Delphi). Sem geração de código, sem esquema; marshalling JSON manual com as units JSON do RTL (ou TJSONObject). Autenticação, lógica de retry e paginação também são implementadas manualmente.
Um check () significa que o projeto documenta suporte nativo. Um traço (—) significa que o projeto não o fornece nativamente. Um til (~) significa parcial / via add-on / não documentado explicitamente — consulte a seção Fontes para o que foi possível verificar.
| Recurso | sgcOpenAPI | OpenAPI Generator | Swagger Codegen | mORMot 2 OpenAPI client generator | TMS XData & OpenAPI Delphi Generator | Hand-coded REST clients (Indy / THTTPClient) |
|---|---|---|---|---|---|---|
| Gera cliente Delphi Cliente Object Pascal nativo a partir de OpenAPI 3.x | — | — | — | |||
| Gera código para C++ Builder Alvos C++ Builder VCL / FMX (BCC32 / BCC64) | ~ | ~ | ~ | ~ | — | |
| Gera stubs de servidor Scaffolding no lado do servidor a partir de uma spec OpenAPI | — | |||||
| Runtime de servidor Delphi nativo Componente de servidor HTTP embarcado que hospeda os endpoints gerados em um processo Delphi / C++ Builder | — | — | ~ | — | ||
Publica documento OpenAPI ao vivo
O servidor expõe seu próprio openapi.json / openapi.yaml em tempo de execução para descoberta e SwaggerUI / Redoc
|
— | — | — | — | ||
| Validação de requisição / resposta no servidor Requisições de entrada e respostas de saída validadas em tempo de execução contra os schemas OpenAPI | ~ | ~ | ~ | ~ | — | |
| Cliente HTTP/2 Transporte HTTP/2 nativo no cliente gerado | ~ | ~ | — | ~ | ~ | |
| DTOs JSON tipados Classes / records / enums fortemente tipados | ~ | |||||
| Helpers de OAuth2 / JWT Fluxos OAuth2 e helpers JWT integrados | ~ | |||||
| Helpers assíncrono / síncrono Padrões de chamada assíncrona e síncrona | ~ | |||||
| Runtime multiplataforma Win / macOS / Linux / iOS / Android | ||||||
| SDKs de fornecedores incluídos AWS / Azure / GCP / Microsoft Graph pré-compilados | — | — | — | — | — | |
| Uso comercial permitido A licença permite uso comercial de código fechado | ||||||
| Manutenção ativa Lançamento ou atividade com tag nos últimos 12–18 meses | ~ | |||||
| Modelo de licença Tipo de licença | Commercial | Apache 2.0 (open source) | Apache 2.0 (open source) | MPL / GPL / LGPL | Commercial (XData) + Apache 2.0 + CC (generator) | BSD / MPL (Indy) · RAD Studio EULA (THTTPClient) |
Notas breves sobre as diferenças ao migrar de uma das opções acima. Sem confronto — apenas o mapeamento prático.
O OpenAPI Generator não tem Delphi como alvo, então "migração" aqui significa gerar clientes C# / Java / TS junto com o cliente Delphi do sgcOpenAPI a partir da mesma spec. Se a configuração anterior era um wrapper C# gerado pelo OpenAPI Generator consumido a partir do Delphi via COM ou REST, o sgcOpenAPI elimina essa camada ao produzir o cliente Delphi diretamente.
O Swagger Codegen não tem Delphi como alvo. Se o fluxo anterior exportava um cliente C# ou Java genérico e o envolvia para Delphi, o sgcOpenAPI permite gerar o cliente Delphi diretamente a partir da mesma spec e elimina a camada de wrapper.
O gerador de cliente OpenAPI do mORMot vive dentro do framework mais amplo. Se sua aplicação usa apenas o gerador e não as camadas SOA / ORM / WebSocket, o sgcOpenAPI oferece um conjunto de componentes autônomo e drop-in sem as units extras. Por outro lado, se você também usa os contratos SOA e o ORM do mORMot, mudar puramente pelo gerador OpenAPI significa reimplementar essas partes, o que o sgcOpenAPI não fornece.
Se você atualmente usa o importador integrado do XData para gerar clientes a partir de specs Swagger de terceiros, observe que o importador foi separado no projeto open source landgraf-dev/openapi-delphi-generator — as classes dentro do XData estão documentadas como obsoletas. O sgcOpenAPI é um gerador diferente, com suporte comercial, que lê nativamente OpenAPI 3.x, inclui SDKs para as principais plataformas de nuvem e tem como alvo Delphi 7–13 mais C++ Builder.
Clientes escritos à mão envelhecem mal quando a superfície da API cresce ou quando o serviço upstream publica novos endpoints. O sgcOpenAPI pode gerar os mesmos DTOs e assinaturas de método a partir da spec publicada em segundos, liberando a lógica escrita à mão para as partes que genuinamente precisam dela (retries personalizados, telemetria, cola de negócio). O código gerado usa transporte HTTP similar, então o modelo mental do desenvolvedor permanece próximo.
Cada célula da matriz acima remete a uma dessas páginas de documentação oficial, repositórios ou notas de versão. Todos os URLs foram verificados no momento da redação.