SOAP- und HTTP-Endpunkte
Das SoapAndHttpEndpoints-Beispiel veranschaulicht, wie ein RPC-basierter Dienst implementiert und im SOAP-Format und POX-Format (Plain Old XML) mit dem WCF-Webprogrammiermodell verfügbar gemacht wird. Weitere Informationen zur HTTP-Bindung für den Dienst finden Sie im Beispiel für einen einfachen HTTP-Dienst. Dieses Beispiel befasst sich mit den Details der Bereitstellung des gleichen Diensts über SOAP und HTTP, allerdings mit unterschiedlichen Bindungen.
Zeigt
Die Bereitstellung eines RPC-Diensts über SOAP und HTTP mit WCF
Diskussion (Discussion)
Dieses Beispiel besteht aus zwei Komponenten: einem Webanwendungsprojekt (Dienst), das einen WCF-Dienst enthält, und einer Konsolenanwendung (Client), mit dem Dienstvorgänge über SOAP- und HTTP-Bindungen aufgerufen werden.
Der WCF-Dienst macht die beiden Vorgänge GetData und PutData verfügbar, die die als Eingabe übergebene Zeichenfolge wiederholen. Die Dienstvorgänge werden mit WebGetAttribute und WebInvokeAttribute kommentiert. Diese Attribute steuern die HTTP-Projektion dieser Vorgänge. Außerdem werden sie mit OperationContractAttribute kommentiert, sodass sie über SOAP-Bindungen verfügbar gemacht werden können. Die PutData-Methode des Diensts löst eine WebFaultException aus, die mithilfe des HTTP-Statuscodes über HTTP und über SOAP als SOAP-Fehler zurückgesendet wird.
Mit der Datei „Web.config“ wird der WCF-Dienst mit 3 Endpunkten konfiguriert:
Der ~/service.svc/mex-Endpunkt, der die Dienstmetadaten für den Zugriff durch SOAP-basierte Clients verfügbar macht.
Der ~/service.svc/http-Endpunkt, der es Clients ermöglicht, über die HTTP-Bindung auf den Dienst zuzugreifen.
Der ~/service.svc/soap-Endpunkt, der es den Clients ermöglicht, über die SOAP über HTTP-Bindung auf den Dienst zuzugreifen.
Der HTTP-Endpunkt wird mit einem <webHttp>-Standardendpunkt konfiguriert, bei dem helpEnabled auf true festgelegt wurde. Als Ergebnis stellt der Dienst eine XHTML-basierte Hilfeseite unter ~/service.svc/http/help bereit, mit der HTTP-basierte Clients auf den Dienst zugreifen können.
Das Clientprojekt veranschaulicht den Zugriff auf den Dienst über einen SOAP-Proxy (generiert durch Dienstverweis hinzufügen) und den Zugriff auf den Dienst mit WebClient.
Das Beispiel besteht aus einem im Web gehosteten Dienst und einer Konsolenanwendung. Während die Konsolenanwendung ausgeführt wird, sendet der Client Anforderungen an den Dienst und schreibt die in den Antworten enthaltenen wichtigen Informationen in das Konsolenfenster.
So führen Sie das Beispiel aus
Öffnen Sie die Projektmappe für das Beispiel mit den SOAP- und HTTP-Endpunkten.
Drücken Sie STRG+UMSCHALT+B, um die Projektmappe zu erstellen.
Wenn das Fenster noch nicht geöffnet ist, drücken Sie STRG+W, S, um den Projektmappen-Explorer zu öffnen.
Klicken Sie im Fenster Projektmappen-Explorer mit der rechten Maustaste auf das Dienstprojekt, und setzen Sie den Cursor über die Option Debuggen im Kontextmenü, damit das Kontextmenü Neue Instanz starten angezeigt wird. Klicken Sie auf Neue Instanz starten. Der ASP.NET-Entwicklungsserver, der den Dienst hostet, wird gestartet.
Klicken Sie in den Fenstern des Projektmappen-Explorers mit der rechten Maustaste auf das Clientprojekt, und setzen Sie den Cursor über die Option Debuggen im Kontextmenü, damit das Kontextmenü Neue Instanz starten angezeigt wird. Klicken Sie auf Neue Instanz starten.
Im eingeblendeten Clientkonsolenfenster werden der URI des ausgeführten Diensts und der URI der HTML-Hilfeseite für den ausgeführten Dienst angezeigt. Sie können die HTML-Hilfeseite jederzeit anzeigen, indem sie den URI der Hilfeseite in einem Browser eingeben.
Während das Beispiel ausgeführt wird, schreibt der Client den Status der aktuellen Aktivität.
Drücken Sie eine beliebige Taste, um die Clientkonsolenanwendung zu beenden.
Drücken Sie UMSCHALT+F5, um das Debugging des Diensts zu beenden.
Klicken Sie im Windows-Infobereich mit der rechten Maustaste auf das Symbol des ASP.NET-Entwicklungsservers, und wählen Sie aus dem Kontextmenü die Option Beenden aus.