ServiceStack vs ASP.Net Web API [zamknięty]


299

Chcę napisać nowy interfejs API stylu REST i spojrzałem na ServiceStack i całkiem mi się podoba. Widziałem jednak, że Microsoft wydał projekt ASP.Net Web API jako część nowej wersji MVC 4 beta. Czy ktoś spojrzał na nowy projekt Web API? Czy możesz podać jakieś zalety / wady każdego systemu?

Odpowiedzi:


389

Mają bardzo podobne przypadki użycia, ponieważ jako główny opiekun projektu ServiceStack mam dobry wgląd w zalety ServiceStack i wiele naturalnych korzyści jego projektu opartego na komunikatach .

ServiceStack istnieje od 2008 r. Jako projekt prowadzony przez OSS od samego początku, którego jednym celem jest promowanie prawidłowego projektowania i wdrażania zdalnych usług wolnych od tarcia.

Prosty i elegancki design

W pogoni za najwyższą prostotą zbudowano go wokół prostego i eleganckiego rdzenia - z większością funkcji naturalnie wiążących się z modelami , a nie z kontrolerami - co właśnie robi MVC, WebApi (a także każdy inny program Web Service Framework produkowany przez Microsoft ).

Przyjęcie projektu opartego na wiadomościach oferuje lepsze podejście do usług zdalnych, ponieważ promują one bardziej rozszerzalne i mniej kruche usługi, upraszczają wzorce dostępu i połączeń oraz zawierają wiele innych naturalnych korzyści, które otrzymujesz za darmo .

Jako podstawowa misja, walczymy ze złożonością na każdym etapie, dążąc do utrzymania niewidocznego i nieinwazyjnego API oraz unikania wprowadzania jakichkolwiek nowych koncepcji lub sztucznych konstrukcji, które nie są jeszcze znane twórcom platformy .NET lub serwisów internetowych.

Na przykład IService<T>implementacja usługi jest tylko standardową klasą C # z zależnościami okablowanymi automatycznie. Cienkie i lekkie opakowania są używane w celu zapewnienia spójnego i zunifikowanego API wokół głównych typów IHttpRequest i IHttpResponse w czasie wykonywania . Umożliwiają również dostęp do bazowych klas Request and Response ASP.NET lub HttpListener, dzięki czemu nigdy nie jesteś ograniczony podczas korzystania z ServiceStack.

W przeciwieństwie do WCF i WebApi

Oto krótki przegląd kontrastowych stylów API promowanych przez ServiceStack i WCF . WebApi różni się od WCF tym, że zachęca do projektowania API REST-full. Jeśli chodzi o przykłady między 2, jest to jedyny znany przykład, który mam z tą samą usługą napisaną zarówno w ServiceStack, jak i WebApi .

Zdalne usługi najlepszych praktyk

ServiceStack koncentruje się przede wszystkim na prostocie, wydajności i promowaniu najlepszych praktyk w zakresie usług internetowych / zdalnych, koncentrując się wokół obejmujących wzorce projektowania usług zdalnych Martina Fowlersa w możliwie idiomatycznym języku C #:

  • Fasada Wzór - co sugeruje użycie batchful, interfejsy gruboziarnistych gdy kiedykolwiek komunikować poprzez granice procesowych.

  • Wzór DTO ( MSDN ) - Nagrania użycie Poços celowych do generowania formatu drutu swoich odpowiedziach usług internetowych.

  • Brama Wzór ( MSDN ) do hermetyzacji Twojego klienta i serwera komunikacji między modelami Client Bramka / dto i szczeblami interfejs usługi.

Te wzory zapewniają czyste rozdzielenie problemów i beztarciowe iteracyjne doświadczenie twórców.

Wzmocnienie Twoich usług

Usługa sieci Web ServiceStack w jej rdzeniu koncentruje się wokół niezależnego i automatycznie okablowanego IService<T>interfejsu czystego języka C # , który daje całkowitą swobodę w definiowaniu umowy o usługę internetową z własnymi DTO żądania i odpowiedzi przy użyciu czystych POCO - dzięki czemu interfejs API usługi ServiceStack jest praktycznie niewidoczny i nie jest -inwazyjne, tzn. wyodrębnienie logiki usług C # i uruchomienie jej poza hostem ServiceStack jest banalne.

Ta lista jest dobrym przykładem tego, co otrzymujesz za pomocą tylko 1 klasy C # .cs w ServiceStack :

  • Strony metadanych dla wszystkich zarejestrowanych formatów
    • Z linkami do przykładów WSDL, XSD i klientów C #
  • Widok raportu HTML przyjazny dla człowieka
    • Pojedyncza migawka strony HTML (tzn. Brak zewnętrznych odnośników). Obejmuje osadzoną odpowiedź usługi internetowej JSON - umożliwia programowy dostęp do migawek danych.
  • Wbudowany Mini Profiler (port doskonałego Mini Profiler MVC )
    • Obejmuje profilowanie SQL
  • Punkty końcowe JSON / JSONP, XML, JSV, CSV i SOAP

Klasy RestServiceBase i ServiceBase są przeznaczone do hostowania niestandardowej logiki C # w celu maksymalnego potencjalnego ponownego wykorzystania, jak to możliwe, np. Jego pierwszy projekt w DTO pozwala na odroczone i proxy wykonanie, w którym ta sama usługa C # może być również hostowana i wykonywana na hoście MQ czyli to, co się dzieje po zarejestrowaniu IMessageServicejak gospodarz RedisMQ i wywołać usługę za pośrednictwem /asynconewaypunktu końcowego (czyli client.SendOneWay()C # Klientów)

Można również łatwo delegować i tworzyć usługi złożone przy użyciu base.ResolveService<T>()metody, która zwraca automatycznie okablowane wystąpienie wybranej usługi, jak pokazano w przykładzie usługi Nortwind CustomerDetails :

var ordersService = base.ResolveService<OrdersService>();
var ordersResponse = (OrdersResponse)ordersService.Get(
    new Orders { CustomerId = customer.Id });

Zwraca zwykłe obiekty C #

W większości przypadków ServiceStack serializuje większość obiektów C # zgodnie z oczekiwaniami - oto lista możliwych typów zwrotów ( z tej odpowiedzi ):

  • Dowolny obiekt DTO -> zserializowany do Response ContentType
  • HttpResult, HttpError, CompressedResult (IHttpResult) dla niestandardowej odpowiedzi HTTP

Następujące typy nie są konwertowane i są zapisywane bezpośrednio do strumienia odpowiedzi:

  • Strunowy
  • Strumień
  • IStreamWriter
  • byte [] - z typem treści application / octet-stream.

Przykład obsługi niestandardowych nagłówków HTTP można zobaczyć w tym przykładzie CORS, w którym można skonfigurować nagłówki HTTP globalnie lub dla poszczególnych usług.

Obsługa HTML

Istnieje wiele opcji zwracania HTML w ServiceStack, które szczegółowo wyjaśniono tutaj .

Obejmuje najszybsze serializatory tekstowe i binarne dla platformy .NET

Elastyczne i szybkie serializers mają podstawowe znaczenie w API, aby zapewnić szybki czas reakcji i versionable API, które nie łamie istniejących klientów, dlatego ServiceStack obejmuje najszybsze serializers tekstowe dla .NET z opcją Nuget umożliwienia @marcgravell „s protokół Bufory (najszybszy serializator binarny .NET).

Serializatory tekstu ServiceStack są bardzo odporne i potrafią wytrzymać ekstremalne wersje bez błędów.

Bezproblemowe doświadczenie deweloperów End-to-End

Zdecydowana natura ServiceStack pozwala na szybki, typowy, zwięzły interfejs API usług internetowych typu end-to-end z wbudowaną obsługą klientów Sync / Async C # / .NET i Async Silverlight bez żadnego kodu:

Przykład synchronizacji C #

var response = client.Send<HelloResponse>(new Hello { Name = "World!" });

Przykład asynchronicznego języka C #

client.SendAsync<HelloResponse>(new Hello { Name = "World!" },
    r => Console.WriteLine(r.Result), (r, ex) => { throw ex; });

Ponieważ zwraca tylko czysty JSON, jest także trywialnie wykorzystywany przez innych klientów HTTP, np. Przykład klienta JS używającego jQuery :

$.getJSON("http://localhost/Backbone.Todo/todos", function(todos) {
    alert(todos.length == 1);
});

Wysoce testowalne

Wszystkie usługi C # / .NET ServiceClient mają te same interfejsy, dzięki czemu są wysoce testowalne i można je zamieniać do tego stopnia, że ​​ten sam test jednostkowy służy również jako test integracji XML, JSON, JSV, SOAP .

Wbudowane bogate sprawdzanie poprawności i obsługa błędów

W swojej misji zapewnienia bezproblemowego i czystego działania deweloperów, ServiceStack obejmuje również wbudowaną weryfikację typów i obsługę błędów, w której zgłoszenie wyjątku C # lub użycie jego wbudowanej płynnej weryfikacji zapewnia klientom uporządkowane, wpisane błędy łatwo dostępne na klientach usług WWW , np .:

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)
    */
}

Aby korzystanie z błędów w JavaScript było banalne, możesz użyć lekkiej biblioteki JavaScript ss-validation.js, aby w prosty sposób powiązać błędy odpowiedzi z polami formularza HTML za pomocą jednego wiersza kodu. Przykład projekt SocialBootstrapApi zapewnia dobrą prezentację tego produktu.

Bogata integracja z ASP.NET i MVC

W ServiceStack MVC PowerPack re-write i poprawki Dużo dolega ASP.NET i MVC z zamienników dla jego kalectwo sesji i buforowania XML obciążone dostawców ASP.NET z własnym czyste i wolne od uzależnień realizacji ICacheClient i ISession API.

ServiceStack obejmuje również nowszy i czystszy model dostawcy uwierzytelniania i autoryzacji z wbudowaną liczbą różnych AuthProvider:

  • Poświadczenia - do uwierzytelniania przy użyciu poświadczeń nazwy użytkownika / hasła przez wysłanie do usługi / auth / credentials
  • Uwierzytelnianie podstawowe - Zezwalanie użytkownikom na uwierzytelnianie przy użyciu uwierzytelniania podstawowego
  • Twitter OAuth - Zezwól użytkownikom na rejestrację i uwierzytelnianie za pomocą Twittera
  • Facebook OAuth - Zezwól użytkownikom na rejestrację i uwierzytelnianie za pomocą Facebooka

Moduł Uwierzytelniania jest całkowicie opcjonalny i jest oparty na czystych interfejsach API ICacheClient / ISession i OrmLite, co pozwala na przechowywanie Sesji w pamięci, Redis lub Memcached, a dane UserAuth są przechowywane w RDBMS SQLServer, MySql, PostgreSQL, Sqlite obsługiwanych przez OrmLite a także magazyn danych Redis lub InMemory (przydatne do tworzenia / testowania).

Świetna dokumentacja

ServiceStack jest bardzo dobrze udokumentowany, gdzie większość informacji o frameworku znajduje się na wiki GitHub . Dokumentację dla innych części frameworka (np. Serializery, Redis, OrmLite) można znaleźć na stronie servicestack.net/docs/

Projekt ServiceStack.Examples zapewnia kod źródłowy dla wszystkich wersji demonstracyjnych i szablonów startowych ServiceStack, podczas gdy projekt SocialBoostsrapApi stanowi świetny punkt wyjścia do opracowania aplikacji jednostronicowej Backbone.js z ServiceStack i MVC opartej na szablonie Twitters Bootstrap.

Oprócz tego grupa informacji Google zawiera skarbnicę informacji, która w ostatnich latach znacznie się rozwinęła.

Działa wszędzie

ServiceStack to platforma .NET 3.5, która działa na hostach ASP.NET i HttpListener i może być hostowana na platformie .NET lub Mono (ciekawostki: www.servicestack.net jest obsługiwany przez CentOS / Mono). Dzięki temu usługi sieciowe ServiceStack mogą być hostowane na:

Windows z .NET 3.5 i 4.0

Linux / OSX z Mono

  • Apache + mod_mono
  • Nginx + MonoFastCGI
  • XSP
  • Aplikacja konsoli

Opracowany przy użyciu modelu programistycznego Open Source

ServiceStack mocno wierzy w model rozwoju Open Source, w którym jest aktywnie rozwijany w środowisku otwartym i od samego początku był hostowany na licencji liberalnej OSS (Nowa BSD). Na dzień dzisiejszy otrzymał wkład od ponad 47 programistów i obecnie zajmuje 3. najczęściej oglądany projekt C # na GitHub .

Niedogodności

Uważam, że największa wada jest taka sama dla większości innych projektów OSS .NET, w których nie została opracowana (lub nawet wymieniona jako dostępna opcja) przez Microsoft. Oznacza to, że rzadko jest to pierwszy wybór przy ocenie frameworka. Większość użytkowników adoptuje ServiceStack tylko w ostateczności, gdzie albo są sfrustrowani narzuconym tarciem i kruchością WCF, albo wydajnością preferowanego stosu Microsoft.

Informacje zwrotne i zasoby społeczności

ServiceStack został bardzo dobrze przyjęty z pozytywną opinią większości ludzi, którzy ocenili to jako widoczne pozytywne opinie w grupie mailingowej . Od tego roku konto na Twitterze @ServiceStack śledzi wzmianki i opinie w swoich ulubionych .

The wspólnotowych zasobów wiki strona to miejsce dobre, aby dowiedzieć się więcej o ServiceStack na dziko z linkami do blogi, pod odlewy, prezentacje, GIST i więcej.


30
Jako ktoś, kto próbował użyć WCF, webapi, a teraz ServiceStack, pozostań przy ServiceStack. 1) WCF jest niepotrzebnie zbyt skomplikowany dla większości. To stara delima „rozwiążmy wszystkie problemy”. 2) web-api jest zbyt nowy. Poczekaj na ostateczne wydanie. Nie obsługuje nawet postów form wieloczęściowych. Kod jest w stanie ciągłego przepływu. Nie uruchamiałbym na nim aplikacji komercyjnych. BTW, to pytanie nie powinno być zamknięte.
Michael Silver,

13
Czy możesz to edytować dla interfejsu API ASP.NET, który właśnie został wydany?
Blake Niemyjski

26
Uczyń swoją witrynę bardziej przyjazną dla użytkownika. To wydaje się świetnym narzędziem. Ale twoja strona jest myląca. Nie jest jasne, czym jest projekt i co zamierza rozwiązać. Natomiast ta odpowiedź jest fantastyczna.
Kugel

82
To naprawdę nie wygląda na porównanie z Web API. Ma to sens - w momencie odpowiedzi Web API był zupełnie nowy. Tak już nie jest. Bardzo chciałbym zobaczyć faktyczne załamanie i obawiam się, że ta odpowiedź jest nieaktualna.
George Mauer

35
Warto zauważyć, że ServiceStack przechodzi do dystrybucji komercyjnej / binarnej od wersji 4.0. Szczegółowe informacje można znaleźć w poście Demis w Google+ .
Nick Jones

137

Jest nowa główna różnica, którą należy uwzględnić - ServiceStack nie jest już darmowy od wersji 4. Ponieważ na SS-pro jest dość jednoznaczna odpowiedź, chciałem rzucić kilka na Web API

Web API

Pro's:

  1. Bezpłatnie używać w swoim projekcie (pod warunkiem, że masz licencję VS, która pozwala na wykorzystanie komercyjne)
  2. Niezwykle wysoki poziom bezpłatnej pomocy technicznej firmy Microsoft i całej sieci, w tym tutaj na StackOverflow.com.
  3. Szybko integruje się z innymi stosami technologii Microsoft, takimi jak ASP.NET MVC, który jest niezwykle popularny w sklepach Microsoft
  4. Wbudowana obsługa uwierzytelniania RESTful i autoryzacji w stosie Microsoft

Cons :

  1. Nie obsługuje SOAP

Korzyści dodatkowe

(Zachęcamy do pozostawienia komentarzy poniżej, wyjaśniających, dlaczego Web API ma zalety lub zalety / wady, które mogę dodać)


84
Nie jestem pewien, czy brak obsługi SOAP to con
D.Rosado,

11
Współistnienie MVC i WebAPI to CON.
Phill

4
ServiceStack v3 jest nadal darmowy i AFAIK zawsze będzie, nie sądzę, żeby cokolwiek wspomniano w mythz jest specyficzne dla v4.
Kyle Gobel

14
Wow, „już nie wolny” to mało powiedziane. 999 USD na programistę dla firmy zatrudniającej więcej niż dziesięciu pracowników?
Ryan Lundy,

7
Moim największym powodem do przejścia z Service Stack na Web API jest to, że Service Stack v3 nie jest już obsługiwany w iOS (przy użyciu Xamarin) z nowym wymaganiem architektury 64-bitowej. Oczywiście aktualizacje są w wersji v4, która jest wersją płatną.
SgtRock

21

Naprawdę nie mogę powiedzieć wiele o ServiceStack, ale Web API ma wiele świetnych funkcji i jest obecnie w wersji 2.

Niektóre rzeczy, które możesz zrobić za pomocą interfejsu API sieci Web:

  • Samo host w aplikacji OWIN (tzn. Działa w dowolnym miejscu).
  • Pełne wsparcie dla asynci await.
  • Dobre domyślne szablony i mnóstwo przykładów open source.
  • Używany świetny serializator Json.Net JSON.
  • Reszta domyślnie (będziesz musiał sam zrobić hipermedia).
  • i więcej...

1
Wszystko na tej liście jest również obecne w ServiceStack lub może być postrzegane jako oszustwo. ServiceStack za JSON serializer, chociaż jest mniej popularna, jest znacznie znacznie szybciej niż Json.NET. Obsługa OWIN raczej nie zostanie zaimplementowana, ponieważ @mythz ma mocne opinie na temat tej technologii, które są dość solidne ( patrz jego komentarze do tego żądania funkcji ).
ygormutti

3
Patrząc na pakiet nuget OWIN, który nie został zaktualizowany od czasu opublikowania go trzy lata temu, tak naprawdę nie widzę sensu w całym tym szumie wokół obsługi OWIN. Wygląda na to, że ludzie naprawdę chcą mieć OWIN, ponieważ Microsoft powiedział kiedyś, że jest fajny. W przeciwnym razie prawdopodobnie nigdy nie usłyszysz o OWIN. Microsoft szczęśliwie upuścił go na korzyść swojej nowej zabawki K. Łagodzi to argument „Microsoft stoi za tym, aby żył wiecznie”, ponieważ Microsoft ma silną tendencję do zabijania projektów, które zostały mocno popchnięte przez nich.
Aleksiej Zimariew

Po co odpowiadać, jeśli nie masz doświadczenia z ServiceStack?
Brian Ogden,


3

Minął rok, kiedy używam SS i to wszystko świetnie. ORMLite to czysta magia. Udało mi się zmienić mapowanie okropnej bazy danych MySQL do integracji z aplikacjami mobilnymi. Brak zmian w bazie danych, ponieważ jest ona używana z zapleczem php z innymi aplikacjami ...

Mythz jest przykładem dotyczącym wsparcia i wyjaśnień. Podniosło to moją wiedzę na temat projektowania aplikacji i prostoty obsługi. Spróbuj, a zrozumiesz.

Nie porównuj też SS z WebAPI. To nie wystarczy, SS przynosi znacznie więcej do Twojego zestawu narzędzi. ServiceStack.Text to także świetny Automapper.

Korzystając z naszej strony potwierdzasz, że przeczytałeś(-aś) i rozumiesz nasze zasady używania plików cookie i zasady ochrony prywatności.
Licensed under cc by-sa 3.0 with attribution required.