Co nowego w wersji 4.5 programu WCF (Windows Communication Foundation)?
W tym temacie omówiono funkcje nowe w programie Windows Communication Foundation (WCF) w wersji 4.5.
gRPC jako alternatywa dla programu WCF
gRPC to nowoczesna struktura RPC, która jest popularną alternatywą dla platformy WCF. Usługa gRPC jest oparta na protokole HTTP/2, który zapewnia wiele zalet w porównaniu z platformą WCF, w tym:
- Wydajność: gRPC jest znacznie wydajniejszy niż WCF, szczególnie w przypadku długotrwałych połączeń.
- Skalowalność: gRPC jest przeznaczony do skalowania do dużej liczby klientów i serwerów.
- Zabezpieczenia: usługa gRPC obsługuje różne mechanizmy zabezpieczeń, w tym tls i uwierzytelnianie.
- Międzyplatformowe: gRPC jest neutralna dla platformy i może być używana z różnymi językami programowania.
Aby uzyskać więcej informacji na temat tworzenia lub migrowania aplikacji WCF do usługi gRPC, zobacz:
- Dlaczego zalecamy gRPC dla deweloperów WCF
- Porównywanie programu WCF z biblioteką gRPC
- Wprowadzenie do usługi gRPC dla deweloperów WCF
Funkcje upraszczania programu WCF
Wykonano wiele prac, aby ułatwić tworzenie i konserwację aplikacji WCF 4.5. Aby uzyskać więcej informacji, zobacz Funkcje uproszczenia programu WCF.
Obsługa asynchronizowa oparta na zadaniach
Domyślnie funkcja Dodaj odwołanie do usługi generuje metody operacji asynchronicznego zwracania zadań. Odbywa się to zarówno w przypadku metod synchronicznych, jak i asynchronicznych. Umożliwia to asynchroniczne wywoływanie operacji usługi przy użyciu nowego modelu programowania asynchronicznego opartego na zadaniach. Podczas wywoływania wygenerowanej metody serwera proxy program WCF konstruuje obiekt Task reprezentujący operację asynchroniczną i zwraca to zadanie. Zadanie kończy się po zakończeniu operacji. Podczas implementowania operacji asynchronicznych można zaimplementować ją jako operację asynchroniową opartą na zadaniach. Aby uzyskać więcej informacji, zobacz Operacje synchroniczne i asynchroniczne.
Uproszczone wygenerowane pliki konfiguracji
Po dodaniu odwołania do usługi w programie Visual Studio lub użyciu narzędzia SvcUtil.exe zostanie wygenerowany plik konfiguracji klienta. W poprzednich wersjach programu WCF te pliki konfiguracji zawierały wartość każdej właściwości powiązania, nawet jeśli jej wartość jest wartością domyślną. W programie WCF 4.5 wygenerowane pliki konfiguracji zawierają tylko te właściwości powiązania ustawione na wartość inną niż domyślna.
Aby uzyskać więcej informacji, zobacz Funkcje uproszczenia programu WCF.
Programowanie kontraktu pierwszego kontraktu
WCF ma teraz wsparcie dla opracowywania kontraktów po raz pierwszy. Svcutil.exe ma przełącznik /serviceContract, który umożliwia generowanie kontraktów usług i danych z dokumentu WSDL.
Dodawanie odwołania do usługi z przenośnego projektu podzestawu
Przenośne projekty podzestawu umożliwiają programistom zestawów .NET obsługę pojedynczego drzewa źródłowego i systemu kompilacji, jednocześnie obsługując wiele platform .NET (desktop, Silverlight, Windows Telefon i Xbox). Przenośne projekty podzestawu odwołują się tylko do bibliotek przenośnych platformy .NET, które są zestawami, które mogą być używane na dowolnej platformie .NET. Środowisko deweloperskie jest takie samo jak dodawanie odwołania do usługi w dowolnej innej aplikacji klienckiej WCF. Aby uzyskać więcej informacji, zobacz Add Service Reference in a Portable Subset Project (Dodawanie odwołania do usługi w projekcie przenośnego podzestawu).
ASP.NET tryb zgodności został zmieniony domyślnie
Program WCF zapewnia ASP.NET tryb zgodności umożliwiający deweloperom pełny dostęp do funkcji w potoku HTTP ASP.NET podczas pisania usług WCF. Aby użyć tego trybu, należy ustawić aspNetCompatibilityEnabled
atrybut na wartość true w <sekcji serviceHostingEnvironment> pliku web.config. Ponadto każda usługa w tej aplikacjiDomain musi mieć właściwość ustawioną RequirementsMode
na AspNetCompatibilityRequirementsAttribute wartość Allowed lub Required. Domyślnie AspNetCompatibilityRequirementsAttribute jest teraz ustawiona wartość Allowed. Aby uzyskać więcej informacji, zobacz Usługi WCF i ASP.NET.
Nowe wartości domyślne transportu
Aby uprościć konfigurację, zmieniono wiele wartości domyślnych właściwości transportu. Aby uzyskać więcej informacji, zobacz Funkcje uproszczenia programu WCF.
XmlDictionaryReaderQuotas
XmlDictionaryReaderQuotas Zawiera konfigurowalne wartości przydziału dla czytników słowników XML, które ograniczają ilość pamięci używanej przez koder podczas tworzenia komunikatu. Chociaż te limity przydziału można konfigurować, wartości domyślne zmieniły się tak, aby zmniejszyć możliwość jawnego ustawienia ich przez dewelopera. Aby uzyskać więcej informacji, zobacz Funkcje uproszczenia programu WCF.
Walidacja konfiguracji programu WCF
W ramach procesu kompilacji w programie Visual Studio pliki konfiguracji programu WCF są teraz weryfikowane pod kątem atrybutów zdefiniowanych w projekcie. Lista błędów weryfikacji lub ostrzeżeń jest wyświetlana w programie Visual Studio, jeśli walidacja zakończy się niepowodzeniem.
Etykietki narzędzi edytora XML
Aby ułatwić nowym i istniejącym deweloperom usług WCF konfigurowanie swoich usług, edytor XML programu Visual Studio udostępnia teraz etykietki narzędzi dla każdego elementu konfiguracji i jego właściwości, które są częścią pliku konfiguracji usługi.
Ulepszenia przesyłania strumieniowego
Dodano obsługę rzeczywistego przesyłania strumieniowego asynchronicznego, gdzie strona wysyłania nie blokuje teraz wątków, jeśli strona odbierająca nie odczytuje lub nie działa wolno w odczytywaniu, co zwiększa skalowalność. Usunięto ograniczenie buforowania komunikatów, gdy klient wysyła strumień komunikatu do hostowanej usługi WCF usług IIS. Aby uzyskać więcej informacji, zobacz Funkcje uproszczenia programu WCF.
Upraszczanie uwidaczniania punktu końcowego za pośrednictwem protokołu HTTPS za pomocą usług IIS
Dodano mapowanie protokołu HTTPS w celu uproszczenia uwidaczniania punktu końcowego za pośrednictwem protokołu HTTPS. Aby włączyć punkt końcowy HTTPS, upewnij się, że witryna internetowa ma skonfigurowane powiązanie HTTPS i certyfikat SSL, a następnie po prostu włączyć protokół HTTPS dla katalogu wirtualnego, który hostuje usługę. Jeśli metadane są włączone dla usługi, zostaną również uwidocznione za pośrednictwem protokołu HTTPS.
Generowanie pojedynczego dokumentu WSDL
Niektóre stosy przetwarzania WSDL innych firm nie mogą przetwarzać dokumentów WSDL, które mają zależności od innych dokumentów za pośrednictwem xsd:import. Program WCF umożliwia teraz określenie, że wszystkie informacje WSDL zostaną zwrócone w jednym dokumencie. Aby zażądać pojedynczego dokumentu WSDL dołącz element "?singleWSDL" do identyfikatora URI podczas żądania metadanych z usługi.
Obsługa protokołu WebSocket
WebSockets to technologia, która zapewnia prawdziwą dwukierunkową komunikację przez porty 80 i 443 z charakterystyką wydajności podobną do tcp. Dodano dwa nowe powiązania w celu obsługi komunikacji za pośrednictwem transportu protokołu WebSocket. NetHttpBinding i NetHttpsBinding. Aby uzyskać więcej informacji, zobacz: Powiązania dostarczone przez system.
Nowe wartości domyślne transportu
W poniższej tabeli opisano ustawienia, które zostały zmienione i gdzie można znaleźć dodatkowe informacje.
Właściwości | Włączone | Nowa wartość domyślna | Aby uzyskać więcej informacji, zobacz |
---|---|---|---|
channelInitializationTimeout | NetTcpBinding | 30 sekund | ChannelInitializationTimeout |
listenBacklog | NetTcpBinding | 12 * liczba procesorów | ListenBacklog |
Maxpendingaccepts | ConnectionOrientedTransportBindingElement Smsvchost.exe |
2 * liczba procesorów do transportu 4 * liczba procesorów dla SMSvcHost.exe |
MaxPendingAcceptsKonfigurowanie usługi współużytkowania portów Net.TCP |
maxPending Połączenie ions | ConnectionOrientedTransportBindingElement | 12 * liczba procesorów | MaxPendingConnections |
Receivetimeout | Smsvchost.exe | 30 sekund | Konfigurowanie usługi współużytkowania portów Net.TCP |
Konfigurowanie usług WCF w kodzie
Program Windows Communication Foundation (WCF) umożliwia deweloperom konfigurowanie usług przy użyciu plików konfiguracji lub kodu. Pliki konfiguracji są przydatne, gdy po wdrożeniu należy skonfigurować usługę. W przypadku korzystania z plików konfiguracji specjalista IT musi tylko zaktualizować plik konfiguracji, nie jest wymagana ponowna kompilacja. Jednak pliki konfiguracji mogą być złożone i trudne do utrzymania. Nie ma obsługi debugowania plików konfiguracji i elementów konfiguracji są przywoływania przez nazwy, co sprawia, że tworzenie plików konfiguracji jest podatne na błędy i trudne. Program WCF umożliwia również konfigurowanie usług w kodzie. We wcześniejszych wersjach programu WCF (4.0 i starszych) konfigurowanie usług w kodzie było łatwe w scenariuszach hostowanych samodzielnie, ServiceHost klasa umożliwiała konfigurowanie punktów końcowych i zachowań przed wywołaniem elementu ServiceHost.Open. Jednak w scenariuszach hostowanych w internecie nie masz dostępu do ServiceHost klasy. Aby skonfigurować usługę hostowaną w internecie, musisz utworzyć usługę, która System.ServiceModel.ServiceHostFactory
utworzyła ServiceHostFactory i wykonała wymaganą konfigurację. Począwszy od programu .NET Framework 4.5, program WCF zapewnia łatwiejszy sposób konfigurowania zarówno usług hostowanych samodzielnie, jak i hostowanych w internecie w kodzie. Aby uzyskać więcej informacji, zobacz Konfigurowanie usług WCF w kodzie.
Buforowanie ChannelFactory
Aplikacje klienckie WCF używają ChannelFactory<TChannel> klasy do tworzenia kanału komunikacyjnego z usługą WCF. Tworzenie ChannelFactory<TChannel> wystąpień wiąże się z pewnym obciążeniem, ponieważ obejmuje następujące operacje:
Konstruowanie ContractDescription drzewa
Emocje wszystkich wymaganych typów CLR
Konstruowanie stosu kanału
Usuwanie zasobów
Aby zminimalizować to obciążenie, program WCF może buforować fabryki kanałów w przypadku korzystania z serwera proxy klienta WCF. Aby uzyskać więcej informacji, zobacz Channel Factory i Buforowanie.
Kompresja i koder binarny
Począwszy od WCF 4.5 koder binarny WCF dodaje obsługę kompresji. Typ kompresji jest skonfigurowany z właściwością CompressionFormat . Zarówno klient, jak i usługa muszą skonfigurować CompressionFormat właściwość . Kompresja będzie działać dla protokołów HTTP, HTTPS i TCP. Jeśli klient określa użycie kompresji, ale usługa nie obsługuje go, zgłaszany jest wyjątek protokołu wskazujący niezgodność protokołu. Aby uzyskać więcej informacji, zobacz Wybieranie kodera komunikatów.
UDP
Dodano obsługę transportu UDP, który umożliwia deweloperom pisanie usług korzystających z komunikatów "fire and forget". Klient wysyła komunikat do usługi i oczekuje braku odpowiedzi z usługi.
Obsługa wielu uwierzytelniania
Dodano obsługę wielu trybów uwierzytelniania obsługiwanych przez usługi IIS w jednym punkcie końcowym programu WCF podczas korzystania z transportu HTTP i zabezpieczeń transportu. Usługi IIS umożliwiają włączenie wielu trybów uwierzytelniania w katalogu wirtualnym. Ta funkcja umożliwia pojedynczemu punktowi końcowemu WCF obsługę wielu trybów uwierzytelniania w katalogu wirtualnym, w którym jest hostowana usługa WCF.
Obsługa sieci IDN
Dodano obsługę zezwalania na usługi WCF z nazwami domen międzynarodowych. Aby uzyskać więcej informacji, zobacz WCF i nazwy domen międzynarodowych.
HttpClient
Dodano nową klasę o nazwie HttpClient , aby ułatwić pracę z żądaniami HTTP. Aby uzyskać więcej informacji, zobacz HttpClient i Wskazówki dotyczące korzystania z obiektu HttpClient.
Konfiguracja funkcji IntelliSense
Wartości atrybutów w plikach konfiguracji atrybutów niestandardowych zdefiniowanych w projekcie obsługują teraz funkcję IntelliSense, aby ułatwić pracę z konfiguracjami szybko i dokładnie.
Etykietki narzędzi konfiguracji
Elementy i atrybuty programu WCF mają teraz etykietki narzędzi w edytorze XML, aby łatwiej i dokładnie zidentyfikować cel elementu lub atrybutu.
Wklej dane jako klasy
W projekcie WCF typy danych zdefiniowane w formacie XML (takie jak uwidocznione w usłudze) mogą być wklejane bezpośrednio na stronie kodu. Typ XML zostanie wklejony jako typ CLR. Aby uzyskać więcej informacji, zobacz Generowanie klas typów danych z formatu XML .
WebServiceHost i domyślne punkty końcowe
W programie Visual Studio 2010 webServiceHost automatycznie utworzył domyślny punkt końcowy niezależnie od tego, czy jawnie określono punkt końcowy. W programie Visual Studio 2012 lub nowszym webServiceHost tworzy domyślny punkt końcowy tylko wtedy, gdy nie zostaną jawnie dodane żadne punkty końcowe. Jeśli klient oczekuje domyślnego punktu końcowego, możesz jawnie dodać punkt końcowy i wskazać go klientowi. Alternatywnie możesz poinformować usługę WCF o powrocie do poprzedniego zachowania, dodając następujące ustawienie do pliku konfiguracji aplikacji
<appSettings>
<add key="wcf:webservicehost:enableautomaticendpointscompatability" value="true"/>
</appSettings>
IHttpCookieContainerManager
Ten interfejs, udostępniany przez IChannelFactory<TChannel>program , sprawia, że praca z plikami cookie po stronie klienta jest znacznie łatwiejsza. Jeśli ustawienie AllowCookies ma wartość true w powiązaniu, możesz uzyskać dostęp do plików cookie przy użyciu następującego kodu:
IHttpCookieContainerManager cookieManager = factory.GetProperty<IHttpCookieContainerManager>();
System.Net.CookieContainer container = cookieManager.CookieContainer;
Następnie możesz pobrać lub ustawić pliki cookie z pliku CookieContainer. Jeśli ustawienie AllowCookies ma wartość false, możesz ręcznie pobrać pliki cookie i OperationContext wysłać je w innych żądaniach przy użyciu innego OperationContext lub inspektora wiadomości. Interfejs IHttpCookieContainerManager umożliwia uwierzytelnianie użytkownika za pomocą usługi i używanie pliku cookie uwierzytelniania zwróconego przez usługę w celu uwierzytelnienia się w innych usługach.