2026'da Delphi ve C++ Builder geliştiricilerinin kullanımına sunulan OpenAPI istemci ve kod üretme seçeneklerinin tarafsız, kaynak gösterimli bir incelemesi: sgcOpenAPI, OpenAPI Generator, Swagger Codegen, mORMot 2, tamamlayıcısı OpenAPI Delphi Generator ile TMS XData ve elle kodlanmış REST istemci yolu. Her özellik iddiası, projenin kendi belgelerine bağlanır.
Her seçeneğin tek paragraflık bir özeti, resmi belgelere veya depoya bir bağlantıyla birlikte. Ayrıntılı karşılaştırma aşağıdaki matristedir.
eSeGeCe · Ticari
Ticari Delphi / C++ Builder bileşen paketi. OpenAPI 3.x JSON / YAML ve Swagger 1.x / 2.x spesifikasyonlarını ayrıştırır, ardından Delphi 7'den RAD Studio 13'e kadar VCL ve FireMonkey altında sorunsuz derlenen yerel Object Pascal arabirimleri, kayıtları ve numaralandırmaları üretir. Ayrıca uç noktaları canlı bir OpenAPI belgesi olarak yayınlayan ve bir spesifikasyondan işleyicileri bağlayan bir OpenAPI sunucu bileşeni içerir. Amazon AWS (280+), Google Cloud (250+), Microsoft Azure (650+) ve Microsoft Graph (15+) için 1.195'ten fazla önceden derlenmiş Pascal SDK'si sunar. Üretilen kodun sgcOpenAPI çalışma zamanının ötesinde harici bağımlılığı yoktur.
OpenAPI Tools topluluğu · Apache 2.0 (açık kaynak)
Başlangıçta Swagger Codegen'den çatallanmış, 60'tan fazla istemci üreticisi ve 40'tan fazla sunucu taslak üreticisi sağlayan açık kaynaklı bir Java aracı. C, C#, C++ (cpp-restsdk, Qt5, Oat++, Tizen, Unreal Engine 4), Go, Java, Kotlin, PHP, Python, Rust, TypeScript ve daha pek çoğu için istemciler ve/veya sunucular üretir. Resmi üretici listesi bir Delphi / Object Pascal / Free Pascal hedefi içermez.
SmartBear / topluluk · Apache 2.0 (açık kaynak)
SmartBear'ın, OpenAPI Generator'ın 2018'de çatallandığı orijinal Java kod üreticisi projesi. 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 ve TypeScript'i destekler. 3.x serisi OpenAPI 3.0'ı destekler; 2.x serisi yalnızca OpenAPI 2.0'ı (Swagger) destekler. Her iki seride de Delphi veya Object Pascal üreticisi yoktur.
Arnaud Bouchez / Synopse · MPL / GPL / LGPL (açık kaynak)
mORMot 2, bir OpenAPI 3.x veya Swagger 2.0 belgesini (dosya veya URL) okuyan ve FPC / Delphi Pascal istemci birimleri üreten mormot.net.openapi.pas dosyasını sunar — DTO olarak üst düzey kayıtlar ve dinamik diziler, enum değerleri için Pascal numaralandırmaları ve HTTP durum kodlarının istisnalara çevrilmesi. Birim, FPC ile Delphi 7 / 2009 ve sonrasını hedefler ve daha geniş mORMot SOA / ORM çerçevesinin bir parçası olarak çalışır.
TMS Software / Landgraf Software · Ticari (XData) / Apache 2.0 + Commons Clause (üretici)
TMS XData, ticari bir Delphi REST / JSON / ORM uzaktan erişim çerçevesidir. Bir XData sunucusu, kendi uç noktaları için /openapi/swagger.json adresinde bir OpenAPI (eski adıyla Swagger) belgesi yayınlayabilir ve SwaggerUI / Redoc ile eşleşir. Tamamlayıcı OpenAPI Delphi Generator (başlangıçta XData ile birlikte gelirdi, şimdi landgraf-dev/openapi-delphi-generator adresinde ayrı bir açık kaynak projesi), Swagger 2.0 / OpenAPI 3.0 belgelerini tüketir ve TXDataClient ile kullanım için Delphi arabirimleri ile DTO sınıfları üretir.
Indy Project / Embarcadero · BSD / MPL (Indy) · RAD Studio EULA (THTTPClient)
Yaygın bir gerçek: geliştiriciler REST istemcisini TIdHTTP (Indy) veya System.Net.HttpClient.THTTPClient (Delphi ile birlikte gelir) kullanarak elle yazar. Kod üretimi yok, şema yok; RTL JSON birimleriyle (veya TJSONObject) manuel JSON sıralama. Kimlik doğrulama, yeniden deneme mantığı ve sayfalama da elle yapılır.
Bir onay işareti (), projenin yerel desteği belgelediği anlamına gelir. Bir tire (—), projenin bunu yerel olarak sağlamadığı anlamına gelir. Bir tilde (~), kısmi / eklenti aracılığıyla / açıkça belgelenmemiş anlamına gelir — doğrulayabildiklerimiz için Kaynaklar bölümüne bakın.
| Özellik | sgcOpenAPI | OpenAPI Generator | Swagger Codegen | mORMot 2 OpenAPI istemci üreticisi | TMS XData ve OpenAPI Delphi Generator | Elle kodlanmış REST istemcileri (Indy / THTTPClient) |
|---|---|---|---|---|---|---|
| Delphi istemcisi üretir OpenAPI 3.x'ten yerel Object Pascal istemcisi | — | — | — | |||
| C++ Builder kodu üretir C++ Builder VCL / FMX hedefleri (BCC32 / BCC64) | ~ | ~ | ~ | ~ | — | |
| Sunucu taslakları üretir Bir OpenAPI spesifikasyonundan sunucu tarafı iskelet | — | |||||
| Yerel Delphi sunucu çalışma zamanı Üretilen uç noktaları bir Delphi / C++ Builder işleminde barındıran gömülü HTTP sunucu bileşeni | — | — | ~ | — | ||
Canlı OpenAPI belgesi yayınlar
Sunucu, keşif ve SwaggerUI / Redoc için çalışma zamanında kendi openapi.json / openapi.yaml belgesini sunar
|
— | — | — | — | ||
| Sunucu tarafı istek / yanıt doğrulaması Gelen istekler ve giden yanıtlar çalışma zamanında OpenAPI şemalarına göre doğrulanır | ~ | ~ | ~ | ~ | — | |
| HTTP/2 istemcisi Üretilen istemcide yerel HTTP/2 taşıması | ~ | ~ | — | ~ | ~ | |
| Tipli JSON DTO'ları Güçlü tipli sınıflar / kayıtlar / enum'lar | ~ | |||||
| OAuth2 / JWT yardımcıları Yerleşik OAuth2 akışları ve JWT yardımcıları | ~ | |||||
| Asenkron / senkron yardımcılar Hem asenkron hem de senkron çağrı kalıpları | ~ | |||||
| Çok platformlu çalışma zamanı Win / macOS / Linux / iOS / Android | ||||||
| Pakete dahil sağlayıcı SDK'leri AWS / Azure / GCP / Microsoft Graph önceden derlenmiş | — | — | — | — | — | |
| Ticari kullanıma izin verilir Lisans, kapalı kaynak ticari kullanıma izin verir | ||||||
| Etkin bakım Son 12–18 ayda sürüm veya etiketli etkinlik | ~ | |||||
| Lisans modeli Lisans türü | Ticari | Apache 2.0 (açık kaynak) | Apache 2.0 (açık kaynak) | MPL / GPL / LGPL | Ticari (XData) + Apache 2.0 + CC (üretici) | BSD / MPL (Indy) · RAD Studio EULA (THTTPClient) |
Yukarıdaki seçeneklerden birinden geçiş yapıyorsanız farklılıklar hakkında kısa notlar. Karşıt değil — yalnızca pratik eşleme.
OpenAPI Generator, Delphi'yi hedeflemez, bu nedenle buradaki "geçiş", aynı spesifikasyondan sgcOpenAPI Delphi istemcisinin yanı sıra C# / Java / TS istemcileri üretmek anlamına gelir. Önceki kurulumunuz, Delphi'den COM veya REST aracılığıyla tüketilen, OpenAPI-Generator ile oluşturulmuş bir C# sarmalayıcıysa, sgcOpenAPI Delphi istemcisini doğrudan üreterek bu katmanı kaldırır.
Swagger Codegen, Delphi'yi hedeflemez. Önceki iş akışınız genel bir C# veya Java istemcisi dışa aktardıysa ve onu Delphi için sardıysa, sgcOpenAPI Delphi istemcisini doğrudan aynı spesifikasyondan üretmenize olanak tanır ve sarmalayıcı katmanını kaldırır.
mORMot'un OpenAPI istemci üreticisi, daha geniş çerçevenin içinde yer alır. Uygulamanız yalnızca üreticiyi kullanıyor ve SOA / ORM / WebSocket katmanlarını kullanmıyorsa, sgcOpenAPI size ek birimler olmadan bağımsız, hazır bir bileşen seti sunar. Buna karşılık, mORMot'un SOA sözleşmelerini ve ORM'sini de kullanıyorsanız, yalnızca OpenAPI üreticisi için geçiş yapmak, sgcOpenAPI'nin sağlamadığı bu parçaları yeniden uygulamak anlamına gelir.
Şu anda üçüncü taraf Swagger spesifikasyonlarından istemciler üretmek için XData'nın yerleşik içe aktarıcısını kullanıyorsanız, içe aktarıcının açık kaynaklı landgraf-dev/openapi-delphi-generator projesine ayrıldığını unutmayın — XData içindeki sınıflar kullanımdan kaldırılmış olarak belgelenmiştir. sgcOpenAPI; OpenAPI 3.x'i yerel olarak okuyan, başlıca bulut platformları için SDK'ler içeren ve Delphi 7–13 ile C++ Builder'ı hedefleyen farklı, ticari olarak desteklenen bir üreticidir.
API yüzeyi büyüdüğünde veya yukarı akış hizmeti yeni uç noktalar yayınladığında elle kodlanmış istemciler kötü yaşlanır. sgcOpenAPI, yayınlanan spesifikasyondan aynı DTO'ları ve metot imzalarını saniyeler içinde üretebilir, böylece elle kodlanmış mantığı gerçekten ihtiyaç duyan parçalar için serbest bırakır (özel yeniden denemeler, telemetri, iş yapıştırması). Üretilen kod benzer HTTP taşıması kullanır, bu nedenle geliştiricinin zihinsel modeli yakın kalır.
Yukarıdaki matristeki her hücre, bu resmi belge sayfalarından, depolardan veya sürüm notlarından birine dayanır. Tüm URL'ler yazıldığı sırada HEAD ile kontrol edildi.