Bindings Binding Elements BasicHttpBinding NetTcpBinding (WCF-PC WCF-PC) NetNamedPipeBinding (WCF-APP WCF-APP an einem PC)...

Transkript

1 WCF Namespaces... 5 Hosting... 5 IIS... 5 WAS... 5 SelfHosting... 5 Konsolen/Winforms/WPF-Hosting... 6 Windows Service-Hosting... 6 WCF-ServiceHosting... 6 WCF-Service konsumieren / Proxy... 7 svcutil... 7 Visual Studio Dienstverweis... 7 Manuelle Integration... 7 Dynamische Integration... 7 App.config... 8 ABC... 9 Address... 9 Contract ServiceContract DataContract Klassendefinition Enumdefinition Collectiondefinition Vererbung Versionierung OperationContract MessageParameter MEP Message-Exchange Pattern FaultContract / FaultException MessageContract MessageContract MessageHeader MessageBodyMember Verwendungsbeispiel Serialisierung / Encoder DataContractSerializer XmlSerializerFormat... 15

2 Bindings Binding Elements BasicHttpBinding NetTcpBinding (WCF-PC WCF-PC) NetNamedPipeBinding (WCF-APP WCF-APP an einem PC) NetMsmqBinding (binäre SOAP über MSMQ) NetPeerTcpBinding (P2P über TCP) WsDualHttpBinding (Duplex) BasicHttpContextBinding(Cookies, SOAP-Headers) MsmqIntegrationBinding (Msmq für COM, C++) NetTcpContextBinding (SOAP Headers) WebHttpBinding (HTTP/S ohne SOAP) WsFederationHttpBinding (Federation Security) WsHttpContextBinding (SOAP Headers) Ws2007FederationHttpBinding (Federation Security) Ws2007HttpBinding BindingSetting ReliableSession MessageSize TransmissionTimeout BindingConfiguration Transactions Quotas Behaviors ServiceBehaviors ServiceDebugging Instancing Metadata Publishing Concurrency Synchronization ServiceBehavior BEST PRACTICE Weitere Serviceeinstellungen Instanzdeaktivierung ReleaseInstanceMode ClientBehaviors ClientCredentials Credentialtypen: CallbackDebug CallbackTimeout WCF-mit SSL-Security... 29

3 1. Anpassung der Web.Config Zertifikat erstellen IIS Assign WCF veröffentlichen PerformanceMonitoring Tracing Traceinfo publizieren Traceinfo abonieren WCF Tracing aktivieren End-to-End-Tracing Security TransportSecurity BasicHttpBinding WsHttpBinding WsDualHttpBinding NetTcpBinding NetNamedPipeBinding MsmqIntegrationBinding NetMsmqBinding MessageSecurity ClientCredentialTypes AlgorithmSuite EstablishSecurityContext NegotiateServiceCredential Authentication Authenticationarten Client Credentials ServiceCredentials Custom Authentication Authorization Process Identity Security Principal ServiceSecurityContext Client-Based Authorization CustomAuthorizationPolicy SecurityTokenAuthorization Impersonation ImpersonationLevel TransportImpersonation... 40

4 SOAP-Using Impersonation Impersonation implementieren Standard Securitykonfigurationen Internet WebService Konfiguration SOAP 1.1 UserName SSL SOAP 1.2 UserName SSL SOAP 1.2 UserName SOAP 1.2 UserName SecureSession SOAP 1.2 Userame ReliableSession Intranet Konfiguration CardSpace-Konfiguration Untyped Messages... 44

5 Namespaces System.ServiceModel Hosting IIS Nur http/https-services Installation: zuerst IIS, danach.net-framework Benötigt.svc-Datei mit folgender Codezeile Language= C# Service= IOrderService %> Benötigt Unterordner AppCode. Hier werden alle Code-cs-Dateien abgelegt (sowohl Interface- als auch Implementierungsdateien Alternativ kann kompilierter Code im bin-verzeichnis abgelegt werden Benötigt web.config im IIS zur Konfiguration des Service Benötigt keine Baseadresse, da dies der virtuelle Ordner des Webservice darstellt WAS Alle WCF-Services Ab IIS 7.0 = Windows Vista / Server 2008 Administration mittels IIS-Administration, daher keine BaseAddress Benötigt kein installiertes IIS, lediglich WAS muss installiert sein Hosting ähnlich IIS mit virtuellem Ordner,.svc, App-Code und web.config Alle 29 Stunden wird App-Domain recyclet, daher eher für PerCall-Services geeignet WAS für NonHttp-Services aktivieren Systemsteuerung Programme Windows-Programme.Net Framework 3.0 WCF NonHttp-Activation aktivieren NonHttp-Requests werden vom SMSvcHost.exe-Prozess bedient Services.msc folgende Dienste müssen gestartet sein: Net.Pipe Listener Adapter Net.Tcp Listener Adapter Net.Tcp Port Sharing Service WAS-Bindings konfigurieren (Ab Windows Server 2008 schon konfiguriert) %windir%\system32\inetsrv\appcmd.exe set site Default Web Site -+bindings*protocol= net.tcp, bindinginformation= 808:* + (bindet die DefaultSeite an den Port 8080) %windir%\system32\inetsrv\appcmd.exe set app Default Web Site/OrderServiceHost /enableprotocols:http,net.tcp (konfiguriert die Protokolle für eine Applikation) Daraus resultieren Änderungen im Ordner %windir%\inetsrv\config z.b. in der applicationhost.config SelfHosting Alle WCF-Services Hosting in Konsolenanwendung Hosting in Windows Forms / WPF Anwendung Hosting in Windows Dienst WCF-ServiceHosting Konfiguration der Endpunkte im Code oder in app.config

6 Konsolen/Winforms/WPF-Hosting using(servicehost host = new ServiceHost(typeof(OrderService))) host.open(); //host is running host.close(); Windows Service-Hosting Service beinhaltet den Host; public ServiceHost host = null; public xyservice() ServiceName = x and y Service ; Main initialisiert den Windows-Dienst public static void Main() ServiceBase.Run(new xyservice()); In Service Start- und Stop Methode Host starten und beenden protected override void OnStart(string[] args) if(host!= null) host.close(); host = new ServiceHost(typeof(xyService)); host.open(); protected override void onstop() if(host!= null) host.close(); host = null app.config Konfiguration Installer-Klasse für die Installation [RunInstaller(true)] public class ProjectInstaller:Installer private ServiceProcessInstaller process; private ServiceInstaller service; public ProjectInstaller() process = new ServiceProcessInstaller(); process.account = ServiceAccount.LocalSystem; service = new ServiceInstaller(); service.servicename = x and y Service ;//analog zum Service Installers.Add(process); Installers.Add(service); Installation mittels VisualStudio-Eingabeaufforderung Installutil pfad zur exe\xyservice.exe WCF-ServiceHosting Visual Studio Hosting WcfSvcHost.exe /service=servicepfad\xy.dll /config:configpfad\app.config

7 WCF-Service konsumieren / Proxy svcutil svcutil /l:csharp /out:file /config:configfile /async /namespace:*,svcutilproxy /serializer:xmlserializer Visual Studio Dienstverweis Webverweis hinzufügen und den Service auswählen Proxy-Klasse wird automatisch generiert Manuelle Integration [ServiceContract] public interface IOrderService [OperationContract] OrderAknowledgment SubmitOrder(Order order); Standardproxy public class OrderServiceProxy:ClientBase<IOrderService>, IOrderService public OrderServiceProxy(Binding binding, EndpointAddress address) :base(binding, address) public OrderServiceProxy(string endpointconfigurationname) :base(endpointconfigurationname) public OrderAknowledgment SubmitOrder(Order order) return this.channel.submitorder(order); Duplexproxy public class DuplexProxy:DuplexClientBase<IDuplexService>,IDuplexService public DuplexProxy(InstanceContext inputinstance) :base(inputinstance, new NetTcpBinding(), net.tcp:// ) Instanzierung des Duplexproxy InstanceContext context = new InstanceContext(this); DuplexProxy proxy = new DuplexProxy(context); //Aufrufer sollte vom gleichen Interface abgeleitet sein Dynamische Integration Binding binding = new NetTcpBinding(); ChannelFactory<IOrderService> factory; factory = new ChannelFactory<IOrderService>(binding, net.tcp:// ); try IOrderService proxy = factory.createchannel; Order o = new Order(1,2,3); var ack = proxy.submitorder(o); catch

8 App.config Beinhaltet dynamisch verwaltbare Konfigurationen o Service app.config <configuration> <system.servicemodel> <services> <service name="vollqualifizierter Name des Service"> <endpoint address="uri des Service" binding="typ des Binding" contract="vollqualifitzierter Name des Contract" bindingconfiguration="name der Binding-Konfiguration"/> </service> </services> </system.servicemodel> </configuration> o Client app.config <configuration> <system.servicemodel> <client> <endpoint address="uri des Service" binding="typ des Binding" contract="vollqualifitzierter Name des Contract" bindingconfiguration="name der Binding-Konfiguration"/> </client> </system.servicemodel> </configuration>

9 ABC A = Address o beinhaltet die Uri unter der der Service erreichbar ist <endpoint address=" binding="typ des Binding" contract="vollqualifitzierter Name des Contract" bindingconfiguration="name der Binding-Konfiguration"/> o kann leer bleiben, wenn BaseAddresses definiert wurde = relativer Pfad zu Base-Address, nur eine BaseAddress je verwendetes Binding <service name="vollqualifizierter Name des Service"> <host> <baseaddresses> <add baseaddress=" <add baseaddress="net.tcp://localhost:8001/orderservice/"/> </baseaddresses> </host> <endpoint address="" binding="typ des Binding" contract="vollqualifitzierter Name des Contract" bindingconfiguration="name der Binding-Konfiguration"/> </service> B = Binding o Definiert welcher Transportweg verwendet wird o Unterschiedliche Eigenschaften und Konfigurationen C = Contract o Definiert die Schnittstelle und ihre Member o DataContracts KEINE BUSINESSOBJEKTE FÜR DATACONTRACT VERWENDEN!!! interface [DataContract] [DataMember] enum [DataContract] [EnumMember] o ServiceContracts [ServiceContract] [OperationContract] Address address = new EndpointAddress("msmq.formatname:DIRECT=OS:.\\private$\\Orders"); address = new EndpointAddress ("net.tcp://localhost:9000/servicemodels/service") <endpoint address="mex" binding="mexhttpbinding" contract="imetadataexchange" /> <endpoint address=" binding="wshttpbinding" contract=" ICalculator" />

10 Contract ServiceContract Definiert ein Interface als WCF-Schnittstelle [ServiceContract] public interface IMyService [OperationContract] [FaultContract(typeof(DemoFault)] string Hello(string name); DataContract Definiert die Klasse und ihre Member für den WCF-Service OPT-IN nur die definierten Member sind Teil des Service sind und werden serialisiert Klassendefinition [DataContract( Name=, Namespace= ] public class WcfClass [DataMember( Name=, Order= 1, IsRequired= false, EmitDefaultValue= true )] o Order Reihenfolge der De-/Serialisierung Zuerst die die keinen Orderwert haben, alfabetisch, danach die Orderreihenfolge o IsRequired default = false, also ist der Member optional Immer Wert setzen, auch wenn es Defaultvalue ist o EmitDefaultValue default = true, also werden auch Defaultwerte serialisiert Enumdefinition [DataContract] public enum Position [EnumMember(Value = "Emp")] Employee, [EnumMember(Value = "Mgr")] Manager, [EnumMember(Value = "Ctr")] Contractor, NotASerializableEnumeration o Value Serialisierter Wert der Enumeration Collectiondefinition [CollectionDataContract(Name= MyCollectionOf0 )] public class MyCollection<T> : IEnumerable<T> //IEnumerable implementieren [OperationContract] MyCollection<Task> GetTasks(); //List<Task> wird beim Proxy angezeigt Vererbung [DataContract] public class SpecialTask : Task

11 [DataContract] [KnownType(typeof(SpecialTask))] public class Task Versionierung Mit Versionierung lässt sich beim Kommunikationsweg New version Service Old version Client New version Service verhindern, dass Daten verloren gehen Es muss die Schnittstelle IExtensibleDataObject implementiert werden Wenn bei der Deserialisierung erkannt wird, dass es keine passenden Member gibt, werden die überschüssigen Member im IExtensibleDataObject abgelegt Bei der Deserialisierung in der aktualisierten Version werden die fehlenden Member aus dem IExtensibleDataObject-Objekt ausgelesen OperationContract Definiert eine Methode als WCF-Methode [ServiceContract] public interface IMyService [OperationContract] [FaultContract(typeof(DemoFault)] string Hello(string name); MessageParameter Ruft das Namensattribut des Parameters im XML-Schema (XSD) ab, bzw. legt ihn fest. [ServiceContract] Public interface IMyInterface [OperationContract)] [return: MessageParameter(name= Output )] string DoSomething([MessageParameter(Name= Input )]string msg); MEP Message-Exchange Pattern Definiert, wie die Antwort auf einen Request erfolgt Request/Response Standard Der Client sendet einen Request und wartet (auch bei void) auf Rückantwort [ServiceContract] [OperationContract] OneWay Der Client sendet den Request und wartet nicht auf eine Antwort [ServiceContract] [OperationContract(IsOneWay=true)] Duplex Client sendet Request als OneWay, Service sendet Responce als OneWay Nicht geeignet, wenn an Firewalls vorbei kommuniziert werden muss Nicht geeignet für Kommunikation übers Internet [ServiceContract] public interface IGreetingHandler [OperationContract(IsOneWay=true)] void GreetingProduces(string greeting); [ServiceContract(CallbackContract=typeof(IGreetingHandler)]

12 interface IGreetingService [OperationContract(IsOneWay=true)] void RequestGreeting(string name); [ServiceBehavior(InstanceContextMode=InstanceContextMode.PerSession)] public class GreetingService : IGreetingService Public void RequestGreeting(string name) IGreetingHandler callbackhandler = OperationContext.Current.GetCallbackChannel<IGreetingHandler>(); callbackhandler.greetingproduced( Hello + name); FaultContract / FaultException BEST PRACTICE: Klasse für FaultException definieren und generische Faultexception verwenden 1. Klasse für FaultException definieren [DataContract] public class DemoFault [DataMember] public string ErrorTextget;set; public DemoFault(string message) this.errortext = message; 2. Methode mit FaultContract-Attribut und typ der FaultException definieren [ServiceContract] public interface IMyService [OperationContract] [FaultContract(typeof(DemoFault)] string Hello(string name); 3. In der Implementierung die Exception werfen public string Hello(string name) throw new FaltException<DemoFault>(new DemoFault("Kaputt"), new FaultReason("Fehler")); 4. Im catch die FaultException abfangen und mittels Details oder Message auslesen... string message = String.Empty; try proxy.hello("wcf"); catch(faultexception<demofault> ex) message = ex.details.errortext; catch(faultexception<string> ex) message = ex.detail; catch(faultexception ex) message = ex.message;

13 catch(communicationexception ex) message = ex.message; MessageContract Ermöglicht das Bestimmen des Aufbaus der SOAP-Nachricht und derer Serialisierung Ermöglicht eigenen Header [MessageContract] [MessageHeader] [MessageBodyMember] MessageContract IsWrapped <!-- true --> <wrappername> <!-- default = Name der Aufruffunktion --> <items> </items> </wrappername> <!-- false --> <items> <!-- ohne wrappername-tag --> </items> WrapperName Name des Tags bei IsWrapped=true WrapperNamespace Namespace des Wrapper-Tags ProtectionLevel Level der Transportsicherheit o None keine Protection o Sign Signieren o EncryptAndSign Verschlüsseln und Signieren MessageHeader Name Name des Headers Namespace Namespace des Headers ProtectionLevel Level der Transportsicherheit siehe MessageContract Actor URI Ziel des Headers, standardmäßig der Empfänger-Dienst MustUndestand Gibt an, ob der Empfänger (Actor) den Header zu verarbeiten hat Relay Gibt an, ob der Header an einen weiteren Empfänger weitergeleitet werden soll, wenn er nicht verarbeitet werden kann MessageBodyMember Name Name des Headers Namespace Namespace des Headers ProtectionLevel Level der Transportsicherheit siehe MessageContract Order Reihenfolge der Serialisierung. Zuerst alle ohne Order-Wert, alfabetisch, danach entsprechend Orderwert

14 Verwendungsbeispiel [DataContract] public class ContactInfo [DataMember] public string Telefon; [DataMember] public string ; [MessageContract(IsWrapped=false)] public class ContactInfoRequestMessage //da IsWrapped =false kein umschließendes ContactInfoRequestMessage-Tag [MessageHeader] public string LicenseKey; //licensekey als KindElement vom Header-Tag [MessageContract(IsWrapped=false)] public class ContactInfoResponseMessage [MessageHeader] public ContactInfo ProviderContactInfo; [ServiceContract] public interface ISomeService [OperationContract] [FaultContract(typeof(string))] ContactInfoResponseMessage GetProviderContactInfo( ContactInfoRequestMessage msg); public class SomeService : ISomeService private const string validkey = ; public ContactInfoResponseMessage GetProviderContactInfo( ContactInfoRequestMessage msg) if(msg.licensekey!= validkey) throw new FaultException<string>( Invalid Key ); return new ContactInfoResponseMessage() ProviderContactInfo = new ContactInfo() =, Telefon = ; Serialisierung / Encoder Definiertdie Art und Weise wie Serialisiert/Encodiert wird Zwei Arten: o DataContractSerializer o XmlSerializer Style-Attribut o OperationFormatStyle.Document (standard) o OperationFormatStyle.Rpc (veraltet, alte SOAP-Services) Use-Attribut o OperationFormatUse.Literal (standard) o OperationFormatUse.Encoded (veraltet, alte SOAP-Services)

15 DataContractSerializer Standard bei WCF Schneller als XmlSerializer OPT-IN nur markierte Elemente werden Serialisiert [ServiceContract] [DataContractFormat(Style = OperationFormatStyle.Document)] public interface IMyService XmlSerializerFormat Xml-Serialisierung OPT-OUT mit [XmlIgnore]-markierte Elemente werden nicht serialisiert [ServiceContract, XmlSerializerFormat(Style = OperationFormatStyle.Rpc, Use = OperationFormatUse.Encoded)] public interface ICalculator [OperationContract, XmlSerializerFormat(Style = OperationFormatStyle.Rpc, Use = OperationFormatUse.Encoded)] string Hello(string name); Bindings Binding Elements BasicHttpBinding Securitymode None TextMessageEncoding MaxReadPoolSize Anzahl der gleichzeitigen hereinkommenden Request-Reader MaxWritePoolSize max ausgehende Nachrichten MessageVersion SOAP, WS-Adressing-Version ReaderQuotas Nachrichten-Längen WriteEncoding Nachrichten-Encodierung HttpTransport AllowCookies, AuthenticationScheme, BypassProxyOnLocal, HostNameComparisonMode, KeepAliveEnabled, ProxyAddress, ProxyAuthenticationScheme, Realm, TransferMode (buuffered, streamed), UnsafeConnectionNtlmAuthentication, UseDefaultWebProxy Securitymode Transport HttpsTransport RequireClientCertificate bool für SSL-Verwendung Scheme https Securitymode Message TransportWithMessageCredential AsymetricSecurity TransportSecurity MessageEncoding MTOM MtomMessageEncoding

16 NetTcpBinding (WCF-PC WCF-PC) BinaryMessageEncoding (binäre Umwandlung), TransactionFlow (OleTransaction, WS- Atomic), TcpTransport, ChannelInitializationTimeout, ConnectionBufferSize, ConnectionPoolSettings, ListenBacklog (max. Nachrichten im Queue), PortSharingEnabled, ToredoEnabled (true = kann Clients hinter Firewalls kontaktieren), TransferMode (buffered, streamed) NetNamedPipeBinding (WCF-APP WCF-APP an einem PC) BinaryMessageEncoding, TransactionFlow (OleTransaction, WS-Atomic), NamedPipeTransport, ChannelInitializationTimeout, ConnectionBufferSize, ConnectionPoolSettings, TransferMode NetMsmqBinding (binäre SOAP über MSMQ) BinaryMessageEncoding binäre Umwandlung MsmqTransport CustomDeadLetterQueue (Uri, an die die unzustellbarkeit einer Nachricht gemeldet wird), Durable (Nachrich dauerhaft oder flüchtig), ExactlyOnce (einmaliger Versand), MaxRetryCycles, MsmqTransportSecurity, QueueTransferProtocol (native MSMQ bei UseActiveDirectory true, SOAP Reliable Message Protocol SRMP, SRMP secure), ReceiveErrorHandlig (Enumeration), ReceiveRetryCount, RetryCycleDelay, TimeToLive (wie lange aktiv, bis DeadLockQueue), TransactedReceiveEnabled (Nachrichtenempfang über Transaktion), UseActiveDirectory (Queue-Adresse vom AD konvertiert), UseMsmqTracing, UseSourceJournal NetPeerTcpBinding (P2P über TCP) BinaryMessageEncoding, PnrpPeerResolver (Peer Name Resolution Protocol für P2P Connection) ReferalPolicy (Share, DoNotShare), PeerTransport (ListenIpAddress, Port, Security) WsDualHttpBinding (Duplex) TransactionFlow, TextMessageEncoding, HttpTransport, CompositeDuplex mit ClientBaseAddress (erlaubt Callbacks an angegebene Adresse) BasicHttpContextBinding(Cookies, SOAP-Headers) TextMessageEncoding, HttpTransport mit AllowCookies = true MsmqIntegrationBinding (Msmq für COM, C++) BinaryMessageEncoding, MsmqTransport NetTcpContextBinding (SOAP Headers) BinaryMessageEncoding, TransactionFlow, TcpTransport WebHttpBinding (HTTP/S ohne SOAP) TextMessageEncoding, HttpTransport (formatting ist vorgegeben) WsFederationHttpBinding (Federation Security) TransactionFlow, TextMessageEncoding, HttpTransport WsHttpContextBinding (SOAP Headers) TransactionFlow, TextMessageEncoding, HttpTransport Ws2007FederationHttpBinding (Federation Security) TransactionFlow, TextMessageEncoding, HttpTransport Ws2007HttpBinding TransactionFlow, TextMessageEncoding, HttpTransport

17 BindingSetting Im Service und Client <system.servicemodel> <services> <service name="vollqualifizierter name des Service"> <host> <baseaddresses> <add baseaddress=" <add baseaddress="net.tcp://localhost:8001/orderservice/"/> </baseaddresses> </host> <endpoint address="" binding="nettcpbinding" contract="vollqualifitzierter Name des Contract" bindingconfiguration="mybindingconfiguration"/> </service> </services> <bindings> <binding name="mybindingconfiguration" recievetimeout = 00:10:00 sendtimeout = 00:10:00 opentimeout = 00:10:00 closetimeout = 00:10:00 > <reliablesession enabled="true" ordered="true" /> </binding> </bindings> </system.servicemodel> ReliableSession TAG Enabled-Attribut NetTcpBinding + WsHttpBinding Ermöglicht die automatisierte Abfragewiederholung Erzwingt das die Abfragen nacheinander statt u.u. gleichzeitig erfolgen bei Attribut ordered= true MessageSize ATTRIBUT Standar 64K Alle Bindings Bei Verwendung von Listen muss dieser Wert auf z.b. 5MB geändert werden TransmissionTimeout ATTRIBUT Alle Bindings Die maximale Übertragungszeit Optimal zwischen 20 und 25 Sekunden Binding binding = new BasicHttpBinding( NameOfBinding ); Binding bindin2 = NetTcpBinding( NameOfBinding2, SecurityMode..); BindingConfiguration Transactions WCF stellt einen Transaktionsmanager mit vollem Umfang dar Services können eigene Transaktionen starten oder sich in bestehende einreihen Jeder einzelne Client kann eine Transaktion einleiten Automatische Teilnahme am 2-Phasen-Commit (nur wenn alle teilnehmenden Transaktionen den commit ausführen können, wird dieser ausgeführt, sonst rollback)

18 Protokolle: o LTM - Lightweight Transaction Protocol mittels TransactionScope, wenn auf nur eine Ressource zugegriffen wird o MSDTC Microsoft Distributed Transaction Controller mittels TransactionScope, wenn auf verteilte Systeme zugegriffen wird Umschaltung von LTM nach MSDTC erfolgt automatisch Transaction trans = Transaction.Current; if(trans==null) trans = new Transaction(); Guid ltmid = trans.transactioninformation.localidentifier; Guid msdtcid = trans.transactioninformation.distributedidentifier; //DistributedIdentifier wird nur gesetzt, wenn MSDTC verwendet wird. o o OLETx OLE Transaction Protocol Zwischen Windows Systemen über Internet, an Firewalls vorbei WS-AT WS-Atomic Protocol wie OLETx, auch Non-Windows Systeme Muss in der Bindingkonfiguration aktiviert werden <service name="" bindingconfiguration="binding1"> <endpoint address="" binding="" contract="" /> </service> <bindings> <nettcpbinding> <binding name=binding1" transactionflow="true" /> </nettcpbinding> </bindings> Im ServiceContract bekommen die transaktionalen Methoden das TransactionFlow-Attribut o NotAllowed keine transaktionale Verarbeitung erlaubt o Allowed eingehende oder wenn nicht vorhanden, dann neue Transaktion o Mandatory eingehende Transaktion erforderlich [ServiceContract( SessionMode=SessionMode.Required )] public interface ITransService [OperationContract] [TransactionFlow(TransactionFlowOption.Mandatory)] string Do(string message); In der Implementierung TransactionScopeRequired auf true [OperationBehavior( TransactionAutoComplete = true,transactionscoperequired = true)] public string Do(string message) //wenn erfolgreich COMMIT, sonst Exception und ROLLBACK Quotas Schränkt die Speichernutzung ein, um Denial of Service(DoS)-Attacken zu verhindern MaxReceivedMessageSize Maximale Nachrichtenlänge Größere Nachrichten werden abgelehnt mit QuotaExceededException, Service lebt weiter Standard bytes <binding name= maxreceivedmessagesize= > binding.maxreceivedmessagesize = ;

19 ReaderQuotas Definiert die Komplexität der Nachricht MaxDepth Standard 32 Ebenen (Paren-Child im XML) MaxStringContentLength Standard 8192 Zeichen in MessageString (InnerText des Node) MaxArrayLength Standard Elemente im Array MaxBytesPerRead Standard 4096 Bytes je Read() MaxNameTableCharCount Standard max Zeichen in TableName Behaviors Einstellungen für Service/Client Betrifft nicht die Transportschicht Als config-tags oder Attribute, teilweise auch kombiniert Behaviorarten o ServiceBehavior o ClientBehavior ServiceBehaviors <service name="" behaviorconfiguration="beh1"> <endpoint... /> </service> <behaviors> <servicebehaviors> <behavior name="beh1"> <... /> </behavior> </servicebehaviors> </behaviors> [ServiceBehavior(...)] public class MyService : IMyService... ServiceDebugging Legt fest, ob Errordetails mit der FaultException weitergeleitet werden Standard = false Sollte nur innerhalb des debuggens verwendet werden <behaviors> <servicebehaviors> <behavior name="beh1"> <servicedebug includeexceptiondetailsinfaults="true" /> </behavior> </servicebehaviors> </behaviors> [ServiceBehavior(IncludeExceptionDetailsInFaults = true)] Instancing Servicebahavior Regelt die Instanzengenerierung der Serviceklasse PER CALL [ServiceBehavior(InstanceContextMode = InstanceContextMode.PerCall)] public class UpdateService Jeder Aufruf erhält eigene Instanz

20 PER SESSION 1. [ServiceContract(SessionMode = SessionMode.Required)] public interface IUpdateService 2. [ServiceBehavior(InstanceContextMode = InstanceContextMode.PerSession)] public class UpdateService Jeder Client erhält eigene Instanz Nicht für BasicHttpBinding da reliablesession erforderlich (Client + Server) Probleme bei Transactions möglich Max einige 100 User Standard Timeout 10 Minuten Timeout ändern: o cs o binding.reliablesession.enabled = true; binding.reliablesession.inactivitytimeout = TimeSpan.FromHours(1); xml <nettcpbinding> <binding name="abc"> <reliablesession enabled="true" inactivitytimeout="01:00:00" /> </binding> </nettcpbinding> Timeouts bei Client und Server => kleinerer Wert siegt, da er als erster erreicht wird und eine TimeoutException auslöst SINGLETON [ServiceBehavior(InstanceContextMode = InstanceContextMode.Single)] public class UpdateService Alle Requests auf eine Instanz Locks nötig, was die Performance herabsetzt Instanzübergabe an ServiceHost möglich nur bei Singleton UpdateService serv = new UpdateService(); ServiceHost host = new ServiceHost(service); UpdateService s = host.singletoninstance as UpdateService; s = (OperationContext.Current.Host as ServiceHost).SingletonInstance as UpdateService; SHARING INSTANCES Selbstdefiniert, Übergabe von Instanzen möglich IInstanceContextProvider, MessageHeader, SessionClient, OperationContextScope Metadata Publishing Regelt, ob die Schnittstelle über http(s)//:uri/?wsdl abrufbar ist Benötigt MEX (Metadata Exchange)-Endpoint und httpgetenabled= true im Servicebehavior <service name="" behaviorconfiguration="beh1"> <!-- mexhttpbinding / mexnamedpipebinding / mextcpbinding --> <endpoint address="mex" binding="mexhttpbinding" contract="imetadataexchange" /> </service> <behaviors> <servicebehaviors> <behavior name="beh1"> <servicemetadata httpgetenabled="true" />

21 </behavior> </servicebehaviors> </behaviors> ServiceHost host = new ServiceHost(typeOf(OrderService)); ServiceMetadataBehavior mexbehavior; mexbehavior = host.description.behaviors.find<servicemetadatabehavior>(); if( mexbehavior == null ) host.ddescription.behaviors.add( new ServiceMetadataBehavior() HttpGetEnabled = true ); else mexbehavior.httpgetenabled = true; BasicHttpBinding basicbinding = new BasicHttpBinding(); host.addserviceendpoint(typeof(mynamespace.iorderservice), basicbinding, "http//..."); host.addserviceendpoint(servicemetadatabehavior.mexcontractname, MetadataExchangeBindings.CreateMexHttpBinding(), "mex");

22 Concurrency Regelt in welcher Reihenfolge die Clients auf die Serviceinstanz zugreifen können und ob WCF den Service mit Locks sperren muss WCF erkennt generell keine Deadlocks resultiert in TimeoutException [ServiceBehavior(ConcurrencyMode=ConcurrencyMode.Single)] public class ServiceImplementation : IServiceInterface Single Es kann nur ein Thread gleichzeitig eine ServiceInstanz ansprechen, FIFO, sicherster Modus Die komplette ServiceInstanz wird gelockt, bis der Request/Methodenaufruf abgearbeitet wurde Queue für nachkommende Requests Keine ClientCallbacks oder externe aufrufe mit Callbacks möglich, da sonst Deadlocks!!! Dies wird von WCF erkannt und endet in einer InvalidOperationException Bei InstancingMode.PerCall/PerSession sind mehrere Instanzen vorhanden. Zeitgleicher Zugriff auf gemeinsame Ressourcen muss manuell mit Locks gesichert werden Multiple Keine WCF-seitigen Locks Im Falle eines Deadlocks muss der Channel neu geöffnet werden, bei Singleton muss ServiceInstanz geschlossen und neu instanziiert werden Reentrant In der Regel nur in seltenen Fällen nötig WCF löst Lock, wenn externe (auch Client-) Callbackmethoden aufgerufen werden, somit rennt der Callback nicht gegen eine gelockte ServiceInstanz nachdem er im Queue landet Status der Instanz oder gemeinsamen Ressourcen kann sich bei Eintreffen des Callbacks verändert haben. Manuelle Locks lösen dieses Problem, wenn erforderlich Synchronization WCF bedient sich aus IO-ThreadPool (1000 Threads) und keiner ist mit Form synchronisiert Synchronisierung mit Form-Thread: [ServiceBehavior(UseSynchronizationContext=true)] public class UpdateService:IUpdateService Host muss innerhalb des Host-Threads instanziiert werden, da sonst keine Synchronisierung Lock des Form-Threads blockiert auch den Host-Thread CallbackSynchronisierung [CallbackBehavior(ConcurrencyMode = ConcurrencyMode.Reentrant, UseSynchronizationContext = true)] public class CallbackClient:ICallback Deadlocks vermeiden

23 ServiceBehavior BEST PRACTICE Single Concurrency als default [ServiceBehavior( InstanceContextMode = InstanceContextMode.PerCall, ConcurrencyMode = ConcurrencyMode.Single)] Multiple Concurrency, nur wenn ausdrücklich nötig, da kein Performanceanstieg bei RequestCount > CPU-Count An Locking denken Reentrant nur bei Callbacks Zirkuläre Aufrufe vermeiden Während Entwicklung ExceptionInDetail = true PerCall benutzen, außer Singleton oder Sessions zwingend erforderlich Weitere Serviceeinstellungen Demarcating Operations Reihenfolge der Operationen bestimmen Nur bei PER SESSION oder SINGLETON Definiert welche Methode eine neue Session öffnen kann und welche die Session schließt Falsche Reihenfolge resultiert in InvalidOperationException IsInitiating o Default = true o Bestimmt, das eine Session generiert wird, falls keine besteht, bestehende wird übernommen IsTerminating o Default = false o Schließt die Session nach Abschluss der Methode, lässt den Host dabei offen!!! Host.Close(); [ServiceContract] Public interface IUpdateService [OperationContract(IsInitating=true)] // neue Session, wenn nicht vorhanden Void InitializeOrder(int customerid); [OperationContract(IsInitiating=false)]// Session muss bestehen Void AddOrderLine(string product int quantity); [OperationContract(IsInitiating=false, IsTerminating=true)]// wird geschlossen bool SubmitOrder(); Throttling Begrenzt zeitgleiche Zugriffe und Instanzierungen MaxConcurrentCalls Max. zeitgleiche Zugriife Standard 16 Betrifft alle Requests unabhängig vom Binding Bei Problemen TimeoutException mit Send()-Methode im StackTrace MaxConcurrentSessions Max. gleichzeitige Sessions Standard 10 Nur bei Bindings mit Sessionunterstützung Bei Problemen TimeoutException mit SetPreamble() im StackTrace

24 MaxConcurrentInstances Max. Anzahl von Instanzen Standard Int32.MaxValue PerCallMode MaxConcurrentCall PerSessionMode MaxConcurrentSession Singleton Mode 1 Nur bei SharedInstances von Bedeutung <behaviors> <servicebehaviors> <behavior name="beh1"> <servicethrottling </behavior> </servicebehaviors> </behaviors> //SET host.description.behaviors.add( new ServiceThrottlingBehavior() MaxConcurrentCalls = 10, MaxConcurrentSessions = 5, MaxConcurrentInstances = 10 ); maxconcurrentcalls="10" maxconcurrentsessions="5" maxconcurrentinstances="10" /> //GET (OperationContext.Current.Host.ChannelDispathers[0] as ChannelDispather).ServiceThrottle.Max Instanzdeaktivierung ReleaseInstanceMode Bestimmt, wann eine ServiceInstanz neu instanziert wird, in Bezug auf die aktuelle Methode Instanz wird disposed OperationContext.Current.InstanceContext.ReleaseServiceInstance(); public class UpdateService [OperationBehavior(ReleaseInstanceMode = ReleaseInstanceMode.None)] void Send(string message) None o o Default Es wird keine neue ServiceInstanz benötigt BeforeCall o o AfterCall o o Vor dem Abarbeiten der Methode Es wird z.b. sichergestellt, dass ausreichend Ressourcen zur Verfügung stehen Nach Abarbeiten der Methode Ressourcen werden freigegeben BeforeAndAfterCall o Vor und nach Ausführen der Methode o Entspricht PerCall-Instanziierung