Smithy modelini içe aktarma

Smithy, AWS’nin API modelleme dilidir. Restorm onun iki gösterimini de içe aktarır.

İçe aktarma

Dosya ▸ İçe aktar (Ctrl+I), ardından:

• bir .smithy dosyası (modelleme dilinin kendisi);
• ya da smithy build komutunun ürettiği JSON AST.

İkisi de aynı iç modelde birleşir.

İçe aktarılanlar

Öğe	Restorm’un yaptığı
Her service / resource	Bir klasör
@http taşıyan her işlem	Bir HTTP isteği
@httpLabel	Bir yol parametresi
@httpQuery	Bir sorgu parametresi
@httpHeader	Bir başlık
Dokümantasyon ve türler	API dokümantasyonu ve numaralandırmalar

Sınırlar (içe aktarmanın 1. sürümü)

• @http niteliği olmayan bir işlem yalnızca belgeseldir: API dokümantasyonunda görünür ama istek üretmez.
• SigV4 kimlik doğrulaması önceden bağlanmaz: onu elle yapılandırın.
• REST dışı protokol bağlamaları (awsJson1_1, awsQuery…) modellenmez.
• Listeler, eşlemeler ve birleşimler birinci sınıf biçimler değildir.
• Doğrulama nitelikleri (@pattern, @length, @paginated, @readonly…) sessizce yok sayılır.
• Smithy protokol testleri yok sayılır.

Güncelleme

Smithy, yeniden eşitlenebilir biçimler arasındadır. Bkz. Kaynaktan güncelleme.