OpenAPI Ayrıştırıcı
OpenAPI 3.0, 3.1 ve 3.2 spesifikasyonlarını okuyan, Swagger 2.0 belgelerini okurken dönüştüren ve her uç noktaya, şemaya ve güvenlik tanımına programatik erişim sağlayan yerel bir Delphi sınıfı.
OpenAPI 3.0, 3.1 ve 3.2 spesifikasyonlarını okuyan, Swagger 2.0 belgelerini okurken dönüştüren ve her uç noktaya, şemaya ve güvenlik tanımına programatik erişim sağlayan yerel bir Delphi sınıfı.
Forma bırakılacak bir şey yok. sgcOpenAPI hiçbir bileşen kaydetmez ve tasarım zamanı paketi içermez, bu yüzden sgcOpenAPI_Classes.pas içindeki TsgcOpenAPI sınıfını kodda oluşturur ve herhangi bir spesifikasyonu onun içine okursunuz.
ReadFromFile bir yol, Read ise belgeyi dize olarak alır; URL'yi önce komut satırı aracı indirir. JSON da YAML da yerel olarak okunur ve bir Swagger 2.0 belgesi de yerel olarak OpenAPI 3.0'a dönüştürülür.
Paths, Webhooks, Components, Security, Servers, Tags ve Info nesnenin özellikleridir; böylece yollara, işlemlere, parametrelere, istek ve yanıt gövdelerine, şemalara ve güvenlik şemalarına güçlü tipli bir model üzerinden erişirsiniz.
TsgcOpenAPI_Parser_Client_Pascal aynı sınıftan türer, yani üretici, okuyucunun üzerine bir yazıcı eklenmiş halidir. Pascal birimleri üretmek için ondan türetin veya özel araçlar ve otomasyon için modeli kendiniz dolaşın.
Bir $ref satır içine alınmaz, nesnede _Ref olarak durur; dolayısıyla model size referansları çözülmüş halde gelmez. Harici dosya ve URL referanslarını önceden TsgcOpenAPI_Bundle getirir, satır içine alır, daha önce ziyaret ettiklerini hatırlar ve azami derinlikte durur.
AllOf, OneOf ve AnyOf, Discriminator ve eşlemesiyle birlikte şema nesnesine okunur ve kod üreticisi bunları Pascal sınıflarına düzleştirir.
Warnings, eksik bir info nesnesinden üreticinin yok saydığı bir anahtar sözcüğe kadar okuyucunun karşılayamadığı her şeyi toplar ve her okumada temizlenir. Satır ve sütun bilgisi, ayrıştırılamayan bir YAML belgesi için bildirilir.