ASP.NET Web API 2: attribute routing ile URI sözleşmesi tasarlamak
ASP.NET Web API 2 döneminde attribute routing, URL kalıplarını denetleyici ve eylem tanımlarıyla doğrudan ilişkilendirmek için kullanıldı. Bu yaklaşım, özellikle iç içe kaynak adreslerinde yalnız genel rota tablosuna bağlı kalmadan daha okunabilir yollar kurmayı kolaylaştırdı.
Arşiv incelemesi · Konu yılı 2013
Web API 2 ve attribute routing
ASP.NET Web API 2 döneminde attribute routing, URL kalıplarını denetleyici ve eylem tanımlarıyla doğrudan ilişkilendirmek için kullanıldı. Bu yaklaşım, özellikle iç içe kaynak adreslerinde yalnız genel rota tablosuna bağlı kalmadan daha okunabilir yollar kurmayı kolaylaştırdı. Adresin okunabilir olması ile doğru kullanıcıya doğru kaynağı sunması ayrı konulardır. API yolunun anlaşılır olması özellikle uzun ömürlü istemci uygulamalarında değer taşır. Mobil uygulamanın gönderdiği URL bugün değiştirilirse eski sürümler hemen güncellenmeyebilir. Bu nedenle yeni rota tasarımı yapılırken önce mevcut çağrıların ve desteklenmesi gereken sürümlerin envanteri çıkarılmalıdır.
Kaynak hiyerarşisini rotada anlatmak
Bir müşteri ve müşteriye bağlı siparişler için müşteriler/kimlik/siparişler biçimindeki yol, kaynak ilişkisinin anlaşılmasını sağlar. Route attribute hangi eylemin çağrılacağını belirler; sorgu filtresi, nesne sahipliği ve kullanıcı yetkisi uygulamanın diğer katmanlarında doğrulanmalıdır. URI içindeki kimlik sayısal olarak doğru olsa bile başkasının kaydını görüntüleme hakkı doğmaz. Bir URL’de müşteri kimliği ile sipariş kimliği birlikte bulunuyorsa ikisinin aynı ilişkiye ait olduğu sunucuda doğrulanmalıdır. Yalnız sipariş kimliğinin veritabanında mevcut olması yeterli olmayabilir. Bu kontrol, yanlış kaynağın dönmesini ve başkasına ait bilginin sızmasını önleyebilir.
Rota kısıtı yetkilendirme değildir
Rota kısıtları, isteğe bağlı parametreler ve sürüm önekleri adres tasarımını etkiler. Çok benzer kalıplar yanlış eyleme eşleşebilir veya beklenmeyen sıralama hataları oluşturabilir. Ayrıca istemcilerin kullandığı mevcut adresleri değiştirmek geriye uyumluluk maliyeti yaratır. Sözleşme görünürlüğü için URI şeması yanında HTTP yöntemi ve hata yanıtı da belgelenmelidir. Rota şablonunda parametre türü kısıtı kullanmak geçersiz biçimleri erken elemek için yararlıdır. Ancak biçim kontrolü bir erişim izni değildir. Doğru sayısal kimliği bilen bir kullanıcının yine de yetkisi olmayabilir. İş kuralları ve rota çözümleme iki farklı katmanda yürütülmelidir.
Çakışan yolları test etmek
Testlerde geçerli ve geçersiz kaynak kimliklerini, çakışan rota kalıplarını ve farklı HTTP yöntemlerini deneyin. Yetkisiz kullanıcının doğru biçimli URI ile erişim kazanmadığını gösterin. Eski bir istemci yolunu da tekrar çalıştırarak yükseltmenin kırıcı olup olmadığını kontrol edin. Yalnız 200 yanıtı almak, doğru kaynağın döndüğünü kanıtlamaz. Yükseltme öncesi istemci testlerinde kök yol, alt kaynak yolu ve bilinmeyen yol ayrı denenmelidir. Hata kodlarının 400, 403 ve 404 arasındaki anlamı tutarlı tutulmalı; dışarıya gereksiz iç detay verilmemelidir. Sadece başarılı çağrıları denemek sözleşmenin en kritik kısmını gözden kaçırır.
URL sözleşmesini sürdürmek
Attribute routing’in önemli dersi, URL yapısının geliştiriciye bırakılmış bir ayrıntı değil, uzun ömürlü bir istemci sözleşmesi olmasıdır. Güncel ASP.NET Core yönlendirmesi tarihsel Web API 2 ile aynı API değildir. Ancak anlamlı adres, nesne düzeyi yetki ve geriye uyumluluk ilkeleri bugün de geçerlidir. İyi API tasarımı bir yönlendirme özelliğini kullanmaktan fazlasıdır. URL, HTTP yöntemi, kimlik doğrulama, kayıt sahipliği ve hata yanıtı birlikte anlamlı bir bütün oluşturur. Attribute routing bu yapının bir parçasını daha açık yazmayı sağlamıştır; diğer parçalar tasarım ve test sorumluluğu olarak kalır.
Yorumlar
Henüz yorum yok. İlk katkıyı sen yapabilirsin.
Yorum yaz
Örnek yorumlar ve editör yanıtı
Tartışma örneği — gerçek kullanıcı yorumu değildir. Bu alandaki isimler ve konuşmalar örnek olarak hazırlanmıştır. Beğeniler ve yanıtlar kaydedilmez; gerçek etkileşim sayılarına eklenmez.
Örnek sayaçlar: 20.056 okunma · 276 beğeni — gerçek ölçüm değildir
Rota parametresini sayıyla sınırladım. Bu aynı zamanda yetki kontrolü sayılır mı?
Rota kısıtı uygun action seçimine yardım eder; kaydı görme veya değiştirme yetkisini belirlemez. Beklenen 404 davranışını, doğrulama hatasını ve yetkisiz erişimi ayrı testler olarak ele alın.
Bence maliyet ve bakım yükü ayrıca tartışılmalı. İlk kurulumun kolay olması, sonraki sürümlerin de sorunsuz çalışacağı anlamına gelmiyor.
Bunu küçük ölçekte denemek isterdim. Ölçülebilir bir başarı kriteri belirlemeden uygulamaya geçmek riskli.
Bu konuyu bugün okurken dönem koşullarını da görmek isterim. “ASP.NET Web API 2: attribute routing ile URI sözleşmesi tasarlamak” için o gün geçerli olan hangi sınırlamalar hâlâ önemli?
Dönem bilgisi yazının konu yılıyla belirtiliyor. Arşivdeki bir sonucu bugüne uygularken kaynak tarihini ve güncel sürüm koşullarını yeniden kontrol etmek gerekir.
Konuya yeni başlayanlar için kaynaklardan hangisiyle başlamayı önerirsiniz? Özellikle yazilim başlığındaki teknik terimler için kısa bir açıklama yararlı olur.
Yazıdaki sonucu farklı bir ortamda karşılaştırırken hangi değişkenleri sabit tutmak gerekir? Yalnız tek bir ölçüme bakmak eksik kalabilir.
Arşivde aynı konuya farklı açıdan bakan bir yazıya bağlantı eklenebilir mi? Gelişimin zaman içindeki yönünü birlikte okumak isterim.
İlgili okumalar için yazının kaynakları ve arşiv bağlantıları başlangıç olabilir. Aynı başlık altındaki iddiaları karşılaştırırken yöntem ve kapsam farklarını da dikkate almak gerekir.
Burada kesinleşen bulgularla henüz yanıt bekleyen soruları ayırmak faydalı. Özellikle “ASP.NET Web API 2: attribute routing ile URI sözleşmesi tasarlamak” başlığındaki sonucun sınırlarını merak ediyorum.