Yeni bir REST stili API yazmak istiyorum ve ServiceStack baktım ve oldukça beğendim. Ancak, Microsoft'un yeni MVC 4 beta sürümünün bir parçası olarak ASP.Net Web API projesini yayımladığını gördüm. Yeni Web API projesine bakan var mı? Her sistemin artılarını / eksilerini verebilir misiniz?
Yanıtlar:
ServiceStack projesinin öncü yöneticisi olarak çok benzer kullanım durumları var, ServiceStack'ın avantajları ve mesaj tabanlı tasarımının birçok doğal faydası hakkında iyi bir fikrim var .
ServiceStack, 2008 yılından bu yana, sürtünmesiz uzak hizmetlerin doğru tasarımını ve uygulanmasını teşvik etmek amacıyla, kuruluşundan bu yana OSS tarafından yürütülen bir proje olarak faaliyet göstermektedir.
Nihai sadelik arayışında, MVC, WebApi'nin yaptığı gibi (özelliklerinin çoğu Microsoft'un ürettiği diğer tüm Web Servis Çerçevelerinin yanı sıra denetleyicilerinize değil, modellerinize doğal olarak bağlanan özelliklerinin çoğu ile basit ve zarif bir çekirdek etrafında inşa edilmiştir. ).
İleti tabanlı bir tasarımı benimsemek, daha genişletilebilir ve daha az kırılgan hizmetleri teşvik etmeleri, erişim ve arama kalıplarını basitleştirmeleri ve ücretsiz olarak elde ettiğiniz diğer birçok doğal faydaları içermeleri bakımından uzak hizmetler için üstün bir yaklaşım sunar .
Temel bir görev olarak, görünmez ve müdahaleci olmayan bir API tutmayı ve bugün .NET veya web hizmeti geliştiricilerine henüz aşina olmayan yeni konseptleri veya yapay yapıları tanıtmaktan kaçınarak her aşamada karmaşıklıkla mücadele ediyoruz.
Örnek olarak, IService<T>hizmet uygulamanız yalnızca otomatik kablolu bağımlılıkları olan standart bir C # sınıfıdır. İnce ve hafif sarmalayıcılar, temel çalışma zamanı IHttpRequest ve IHttpResponse türleri etrafında tutarlı ve birleşik bir API sağlamak için kullanılır . Ayrıca, temel ASP.NET veya HttpListener'ın İstek ve Yanıt sınıflarına erişime izin verir, böylece ServiceStack kullanırken asla kısıtlanmazsınız.
ServiceStack ve WCF'nin tanıdığı zıt API stillerine kısa bir genel bakış . WebApi, REST-ful API tasarımını teşvik ettiği için WCF'den farklıdır. 2 arasındaki örneklere gelince, bu, ServiceStack ve WebApi'de yazılmış aynı hizmetle sahip olduğum bilinen tek örnektir .
ServiceStack, sadelik, performans ve Martin Fowlers uzaktan hizmet tasarım desenlerini olabildiğince idiomatik C # ile kucaklamak üzerine odaklanan web / uzaktan hizmet en iyi uygulamalarını tanıtmaya odaklanmıştır:
Cephe Desen Eğer işlem sınırları boyunca iletişim kurduğunuzda hiç batchful, iri taneli arayüzleri kullanımını önerir -.
DTO desen ( MSDN ) - özel amaçlı Poços kullanımını Dikte web servisleri yanıtların tel biçimini oluşturmak için.
Ağ Geçidi Desen ( MSDN ) İstemci Ağ Geçidi / DTO modelleri ve Servis Arayüz katman arasındaki istemci ve sunucu iletişimi saklanması.
Bu kalıplar, endişelerin temiz bir şekilde ayrılmasını ve sürtünmesiz yinelemeli geliştirme deneyimini sağlar.
Özünde bir ServiceStack web hizmeti, IService<T>temiz POCO'ları kullanarak kendi İstek ve Yanıt DTO'larınızla web hizmeti sözleşmenizi tanımlamak için tam bir özgürlük sağlayan bağımlılık gerektirmeyen ve otomatik kablolu saf C # arayüzü etrafında merkezlenmiştir - ServiceStack API'sini pratikte görünmez ve olmayan hale getirir -invaziv, yani C # hizmetleri mantığınızı ayıklamak ve bir ServiceStack ana bilgisayarının dışında çalıştırmak çok önemlidir.
Bu öz, ServiceStack'ta yalnızca 1 C # .cs sınıfıyla elde ettiğinize iyi bir örnektir :
RestServiceBase ve ServiceBase sınıfları, mümkün olan en yüksek olası yeniden kullanım için özel C # mantığınızı barındırmayı amaçlamaktadır; örn. DTO-ilk tasarımı, aynı C # Hizmetinizin de bir MQ Ana Bilgisayarında da barındırılabileceği ve yürütülebileceği ertelenmiş ve proxy uygulamasına izin verir RedisMQ ana bilgisayarınaIMessageService benzer bir kayıt yaptırıp hizmetinizi /asynconewayson nokta üzerinden aradığınızda (yani client.SendOneWay()C # İstemcilerde) olan
Ayrıca base.ResolveService<T>(), Nortwind CustomerDetails Service örneğinde görüldüğü gibi, seçilen hizmetin otomatik kablolu örneğini döndüren yöntemi kullanarak kolayca bileşik temsilci oluşturabilir ve oluşturabilirsiniz :
var ordersService = base.ResolveService<OrdersService>();
var ordersResponse = (OrdersResponse)ordersService.Get(
new Orders { CustomerId = customer.Id });
Çoğunlukla ServiceStack, çoğu C # nesnesini beklendiği gibi serileştirir - olası dönüş türlerinin listesi ( bu yanıttan ):
Aşağıdaki türler dönüştürülmez ve doğrudan Yanıt Akışı'na yazılır:
Özel HTTP üstbilgileri desteğinin bir örneği, HTTP Üstbilgilerini global olarak veya hizmet başına bazda yapılandırabileceğiniz bu CORS örneği tarafından görülebilir .
ServiceStack'ta HTML'yi döndürmek için burada ayrıntılı olarak açıklanan birden fazla seçenek vardır .
Esnek ve hızlı serializers hızlı tepki süreleri ve ServiceStack içerir neden olan mevcut müşterilerine kesilmez bir versionable API sağlamak için bir API birincil öneme sahip .NET için en hızlı metin serializers etkinleştirmek için bir Nuget seçeneğiyle @marcgravell 'ın Protokolü Tamponlar (.NET'in en hızlı ikili serileştiricisi).
ServiceStack'ın metin serileştiricileri çok esnektir ve hatasız aşırı sürümlere dayanabilir .
ServiceStack'ın fikirli doğası, herhangi bir kod genine sahip olmadan Sync / Async C # /. NET ve Async Silverlight istemcileri için yerleşik desteğe sahip hızlı, yazılan, kısa bir web hizmeti API'sına uçtan uca izin verir :
var response = client.Send<HelloResponse>(new Hello { Name = "World!" });
client.SendAsync<HelloResponse>(new Hello { Name = "World!" },
r => Console.WriteLine(r.Result), (r, ex) => { throw ex; });
Sadece saf JSON döndürdüğü için, diğer HTTP İstemcileriyle de önemsiz bir şekilde tüketilir, örn. JQuery kullanan JS istemcisi örneği :
$.getJSON("http://localhost/Backbone.Todo/todos", function(todos) {
alert(todos.length == 1);
});
Tüm C # /. NET ServiceClients , aynı birimleri test edebileceğiniz noktaya kadar son derece test edilebilir ve değiştirilebilir hale getiren aynı arayüzleri paylaşır; ayrıca XML, JSON, JSV, SOAP Entegrasyon Testi olarak da hizmet eder .
Sürtünmesiz ve temiz bir geliştirme deneyimi sağlama görevinde, ServiceStack ayrıca bir C # İstisnası atmanın veya yerleşik Akıcı doğrulamanın kullanılmasının istemcilere web hizmeti istemcilerinde kolayca erişilebilmesini sağlayan yerleşik doğrulama ve hata işleme içerir. , Örneğin:
try {
var client = new JsonServiceClient(BaseUri);
var response = client.Send<UserResponse>(new User());
} catch (WebServiceException webEx) {
/*
webEx.StatusCode = 400
webEx.ErrorCode = ArgumentNullException
webEx.Message = Value cannot be null. Parameter name: Name
webEx.StackTrace = (your Server Exception StackTrace - if DebugMode is enabled)
webEx.ResponseDto = (your populated Response DTO)
webEx.ResponseStatus = (your populated Response Status DTO)
webEx.GetFieldErrors() = (individual errors for each field if any)
*/
}
JavaScript hatalarını önemsiz hale getirmek için , yanıt hatalarınızı HTML form alanlarınıza tek bir kod satırıyla önemsiz bir şekilde bağlamak için hafif ss-validation.js JavaScript kitaplığını kullanabilirsiniz. SocialBootstrapApi örnek proje buna iyi tanıtım sağlar.
ServiceStack MVC PowerPack yeniden yazıyor ve düzeltmeler onun için değiştirmeler ile ASP.NET ve MVC yerli diziler bir sürü felç edici Oturum ICacheClient ve ISession API'leri kendi temiz ve bağımlılık içermeyen uygulamasıyla ve Caching XML ipotekli ASP.NET sağlayıcılar.
ServiceStack ayrıca, birkaç farklı AuthProvider'in yerleşik olduğu daha yeni ve daha temiz bir kimlik doğrulama ve otomatikleştirme sağlayıcı modeli içerir:
Kimlik Doğrulama modülü tamamen isteğe bağlıdır ve oturumlarınızın Bellek, Redis veya Memcached'de saklanmasına izin veren temiz ICacheClient / ISession API'leri ve OrmLite üzerine kurulmuştur ve UserAuth bilgileriniz OrmLite'ın desteklenen RDBMS'leri SQLServer, MySql, PostgreSQL, Sqlite as yanı sıra Redis veri deposu veya InMemory (geliştirme / test için yararlıdır).
ServiceStack, çerçeve hakkındaki bilgilerin çoğunun GitHub wiki'de barındırıldığı yerlerde çok iyi belgelenmiştir . Çerçeve (örneğin Serileştiriciler, Redis, OrmLite) diğer parçaları için belgeler bulunabilir servicestack.net/docs/
ServiceStack.Examples iken Proje ServiceStack canlı demolar ve Starter şablonları tümü için kaynak kodu sağlar SocialBoostsrapApi projesi Twitterlar Bootstrap şablonu temel ServiceStack ve MVC ile backbone.js Tek Sayfa App geliştirme harika bir başlangıç noktası sağlamaktadır.
Yukarıdakilere ek olarak, Google Grubu içinde son yıllarda oldukça genişleyen bir bilgi hazinesi bulunmaktadır .
ServiceStack, ASP.NET ve HttpListener ana bilgisayarlarında çalışan ve .NET veya Mono'da barındırılabilen bir .NET 3.5 çerçevesidir (trivia: www.servicestack.net , CentOS / Mono tarafından desteklenmektedir). Bu, ServiceStack web hizmetlerinizin şunlardan birinde barındırılmasını sağlar:
ServiceStack, açık kaynaklarda aktif olarak geliştirildiği ve kuruluşundan bu yana her zaman liberal bir OSS lisansı (Yeni BSD) altında barındırıldığı Açık Kaynak geliştirme modeline güçlü bir inanandır . Bugün itibariyle 47'den fazla geliştiriciden katkı almıştır ve şu anda GitHub'da en çok izlenen 3. C # projesinde yer almaktadır .
En büyük dezavantajın, Microsoft tarafından geliştirilmediği (veya kullanılabilir bir seçenek olarak listelenen) diğer OSS .NET projelerinin çoğu için aynı olduğuna inanıyorum. Bu, bir çerçeveyi değerlendirirken nadiren ilk tercih olduğu anlamına gelir. Çoğu benimseyen, ServiceStack'i yalnızca WCF'nin sürtünme ve kırılganlığı ya da tercih edilen Microsoft Stack'in performansı ile ilgili hayal kırıklığına uğradıkları son çare olarak değerlendirecektir.
ServiceStack, posta grubundaki olumlu duyguların görebildiği şekilde değerlendiren çoğu kişi tarafından sağlanan olumlu geri bildirimlerle çok iyi karşılandı . Bu yıl itibariyle @ServiceStack twitter hesabı, favorilerinden bahsetti ve geri bildirimleri takip ediyor .
Topluluk Kaynakları wiki sayfası Yayınlar, bakla atmalarını, Sunumlar, jeologlar ve daha Blog bağlantıları olan vahşi daha ServiceStack öğrenmek için iyi bir yerdir.
Hesaplanması gereken yeni bir ana fark var - ServiceStack v4'ten itibaren artık ücretsiz değil. SS pro's üzerinde oldukça kesin bir cevap olduğundan, Web API için bir çift dışarı atmak istedim
Profesyoneller:
Eksileri :
Yan Avantajlar
(Lütfen, Web API'nın neden ekleyebileceğine veya ekleyebileceğim artıları / eksileri olduğunu ekleyerek aşağıdaki yorumları bırakmaktan çekinmeyin)
ServiceStack hakkında çok fazla şey söyleyemem, ancak Web API'nin birçok harika özelliği var ve şu anda sürüm 2'de.
Web API ile yapabileceğiniz şeylerden bazıları:
asyncve await.ServiceStack müşterisi olarak burada benim için en önemli ServiceStack profesyonelidir.
https://github.com/ServiceStack/Issues/issues/606
Yani. Hata bulundu, hata tespit edildi, hata düzeltildi. Aynı gün. Olağanüstü destek!
SS'yi kullanmam bir yıl oldu ve hepsi harika. ORMLite saf bir sihirdir. Mobil uygulamalara entegre etmek için kötü bir MySQL DB'yi yeniden eşleştirebildim. Veritabanında değişiklik olmaması, başka bir uygulama ile bir php arka ucuyla kullanılmasına neden olur ...
Mythz destek ve açıklama ile ilgili bir örnektir. Uygulama tasarımı ve bakımla ilgili basitlik hakkındaki bilgilerimi yükseltti. Lütfen deneyin ve anlayacaksınız.
Ayrıca, SS'yi WebAPI ile karşılaştırmayın. Bu yeterli değil, SS araç kutunuza çok daha fazlasını getiriyor. ServiceStack.Text de harika bir Automapper.