Dienstproxy

Ein Dienstproxy ist der clientseitige Proxy für einen Dienst. Der Dienstproxy ermöglicht Anwendungen das Senden und Empfangen von Nachrichten über einen Kanal als Methodenaufrufe.

Dienstproxys werden bei Bedarf erstellt, geöffnet, zum Aufrufen eines Diensts verwendet und geschlossen, wenn sie nicht mehr benötigt werden. Alternativ kann eine Anwendung einen Dienstproxy wiederverwenden, um wiederholt eine Verbindung mit demselben Dienst herzustellen, ohne dass zeit- und ressourcenaufwendige Zeit- und Ressourcenaufwand für die mehrfache Initialisierung eines Dienstproxys erforderlich ist. Das folgende Diagramm veranschaulicht den Fluss der möglichen Zustände des Dienstproxys und der Funktionsaufrufe oder Ereignisse, die von einem Zustand zum anderen führen.

Diese Dienstproxyzustände werden in der WS_SERVICE_PROXY_STATE enumerationiert.

Wie das obige Diagramm und der folgende Code veranschaulichen, wird ein Dienstproxy durch einen Aufruf der WsCreateServiceProxy-Funktion erstellt. Als Parameter für diesen Aufruf stellt WWSAPI die folgenden Enumerationen bereit:

• WS_CHANNEL_TYPE
• WS_CHANNEL_BINDING

Es akzeptiert auch optionale Parameter mit den folgenden Datentypen:

• WS_PROXY_PROPERTY_ID
• WS_SECURITY_DESCRIPTION

Wenn der Dienstproxy erstellt wurde, gibt die WsCreateServiceProxy-Funktion über einen out-Parameter einen Verweis auf den Dienstproxy zurück, WS_SERVICE_PROXY.

WS_SERVICE_PROXY* serviceProxy = NULL;
hr = WsCreateServiceProxy (
    WS_TCP_CHANNEL_BINDING, 
    WS_CHANNEL_TYPE_DUPLEX_SESSION, 
    NULL, 
    NULL, 
    0, 
    NULL,
    0,
    &serviceProxy, 
    error);

Wenn der Dienstproxy erstellt wurde, kann die Anwendung den Dienstproxy für die Kommunikation mit einem Dienst öffnen, indem sie die WsOpenServiceProxy-Funktion aufruft und eine Adressstruktur mit der Netzwerkadresse des Dienstendpunkts übergibt, mit dem eine Verbindung hergestellt werden soll.

WS_ENDPOINT_ADDRESS address = {0};
address.uri.chars = "net.tcp://localhost/example";
address.uri.length = wcslen("net.tcp://localhost/example";);
hr = WsOpenServiceProxy(serviceProxy, &address, NULL, error);

Wenn der Dienstproxy geöffnet wurde, kann die Anwendung ihn für Aufrufe des Diensts verwenden.

hr = Add(
    serviceProxy, 
    1, 
    2, 
    &result, 
    NULL, 
    0, 
    NULL, 
    error);

Wenn die Anwendung den Dienstproxy nicht mehr benötigt, wird der Dienstproxy durch Aufrufen der WsCloseServiceProxy-Funktion geschlossen. Außerdem wird der zugeordnete Arbeitsspeicher durch Aufrufen von WsFreeServiceProxy freigegeben.

hr = WsCloseServiceProxy(
    serviceProxy, 
    NULL, 
    error);

hr = WsFreeServiceProxy(
    serviceProxy, 
    error);

Wiederverwendung des Dienstproxys

Alternativ kann nach dem Aufruf von WsCloseServiceProxy eine Anwendung den Dienstproxy wiederverwenden, indem sie die WsResetServiceProxy-Funktion aufruft .

hr = WsResetServiceProxy(
    serviceProxy, 
    error);

Weitere Informationen zur Verwendung von Dienstproxys in verschiedenen Kontexten finden Sie in den folgenden Themen:

• Dienstproxy und Sitzungen
• Dienstvorgang
• Clientseitige Dienstvorgänge
• HttpCalculatorClientExample

Sicherheit

Die folgenden Überlegungen zum Anwendungsentwurf sollten bei Verwendung der WWSAPI-Dienstproxy-API sorgfältig beachtet werden:

• Der Dienstproxy führt keine Validierung der Daten über die Überprüfung von Basic Profile 2.0 und XML-Serialisierung hinaus aus. Es liegt in der Verantwortung der Anwendung, die daten zu überprüfen, die in den Parametern enthalten sind, die sie im Rahmen des Aufrufs zurückerhalten.
• Das Konfigurieren der maximalen Anzahl ausstehender Aufrufe für den Dienstproxy mithilfe des WS_PROXY_PROPERTY_ID-Enumerationswerts WS_PROXY_PROPERTY_MAX_PENDING_CALLS bietet Schutz vor einem langsam ausgeführten Server. Der Standardwert ist 100. Anwendungen müssen beim Ändern der Standardwerte vorsichtig sein.
• Der Dienstproxy bietet keine Sicherheitsgarantien, die über die in der WS_SECURITY_DESCRIPTION-Struktur für die Kommunikation mit dem Server hinausgehen.
• Achten Sie darauf, wenn Sie die Standardeinstellungen für Nachrichten und Kanäle auf dem Dienstproxy ändern. Lesen Sie die Sicherheitsüberlegungen im Zusammenhang mit Nachrichten und Kanälen, bevor Sie die zugehörigen Eigenschaften ändern.
• Der Dienstproxy verschlüsselt alle Anmeldeinformationen, die im Arbeitsspeicher gespeichert sind.

Die folgenden API-Elemente beziehen sich auf Dienstproxys.