Instrukcje: uzyskiwanie dostępu do usług za pomocą kontraktu dwustronnego

Artykuł
03/05/2024

Jedną z funkcji programu Windows Communication Foundation (WCF) jest możliwość utworzenia usługi korzystającej ze wzorca obsługi komunikatów dwukierunkowych. Ten wzorzec umożliwia usłudze komunikowanie się z klientem za pośrednictwem wywołania zwrotnego. W tym temacie przedstawiono kroki tworzenia klienta WCF w klasie klienta, która implementuje interfejs wywołania zwrotnego.

Podwójne powiązanie uwidacznia adres IP klienta usługi. Klient powinien używać zabezpieczeń, aby upewnić się, że łączy się tylko z zaufanymi usługami.

Aby zapoznać się z samouczkiem dotyczącym tworzenia podstawowej usługi I klienta WCF, zobacz Wprowadzenie Samouczek.

Aby uzyskać dostęp do usługi dwukierunkowej

Utwórz usługę zawierającą dwa interfejsy. Pierwszy interfejs jest przeznaczony dla usługi, drugi jest dla wywołania zwrotnego. Aby uzyskać więcej informacji na temat tworzenia usługi dwukierunkowej, zobacz How to: Create a Duplex Contract (Instrukcje: tworzenie kontraktu dwustronnego).
Uruchom usługę.
Użyj narzędzia ServiceModel Metadata Tool (Svcutil.exe), aby wygenerować kontrakty (interfejsy) dla klienta. Aby uzyskać informacje o tym, jak to zrobić, zobacz Instrukcje: tworzenie klienta.

Zaimplementuj interfejs wywołania zwrotnego w klasie klienta, jak pokazano w poniższym przykładzie.

public class CallbackHandler : ICalculatorDuplexCallback
{
    public void Result(double result)
    {
        Console.WriteLine("Result ({0})", result);
    }
    public void Equation(string equation)
    {
        Console.WriteLine("Equation({0})", equation);
    }
}

Public Class CallbackHandler
Implements ICalculatorDuplexCallback
   Public Sub Result (ByVal result As Double)
      Console.WriteLine("Result ({0})", result)
   End Sub
    Public Sub Equation(ByVal equation As String)
        Console.WriteLine("Equation({0})", equation)
    End Sub
End Class

Utworzenie wystąpienia InstanceContext klasy. Konstruktor wymaga wystąpienia klasy klienta.

InstanceContext site = new InstanceContext(new CallbackHandler());

Dim site As InstanceContext = New InstanceContext(new CallbackHandler())

Utwórz wystąpienie klienta programu WCF przy użyciu konstruktora, który wymaga InstanceContext obiektu. Drugi parametr konstruktora to nazwa punktu końcowego znalezionego w pliku konfiguracji.
```
CalculatorDuplexClient wcfClient = new CalculatorDuplexClient(site, "default");
```
```
Dim wcfClient As New CalculatorDuplexClient(site, "default")
```
Wywołaj metody klienta WCF zgodnie z potrzebami.

Przykład

W poniższym przykładzie kodu pokazano, jak utworzyć klasę klienta, która uzyskuje dostęp do kontraktu dwustronnego.

using System;
using System.ServiceModel;
using System.ServiceModel.Channels;

// Define class that implements the callback interface of duplex
// contract.
public class CallbackHandler : ICalculatorDuplexCallback
{
  public void Result(double result)
  {
    Console.WriteLine("Result({0})", result);
  }
  public void Equation(string equation)
  {
    Console.WriteLine("Equation({0})", equation);
  }
}

public class Client
{
  public static void Main()
  {
    // Picks up configuration from the config file.

    CalculatorDuplexClient wcfClient
      = new CalculatorDuplexClient(new InstanceContext(new CallbackHandler()));
    try
    {
      // Call the AddTo service operation.
      double value = 100.00D;
      wcfClient.AddTo(value);

      // Call the SubtractFrom service operation.
      value = 50.00D;
      wcfClient.SubtractFrom(value);

      // Call the MultiplyBy service operation.
      value = 17.65D;
      wcfClient.MultiplyBy(value);

      // Call the DivideBy service operation.
      value = 2.00D;
      wcfClient.DivideBy(value);

      // Complete equation.
      wcfClient.Clear();

      // Wait for callback messages to complete before
      // closing.
      System.Threading.Thread.Sleep(5000);

      // Close the WCF client.
      wcfClient.Close();
      Console.WriteLine("Done!");
    }
    catch (TimeoutException timeProblem)
    {
      Console.WriteLine("The service operation timed out. " + timeProblem.Message);
      wcfClient.Abort();
      Console.Read();
    }
    catch (CommunicationException commProblem)
    {
      Console.WriteLine("There was a communication problem. " + commProblem.Message);
      wcfClient.Abort();
      Console.Read();
    }
  }
}

Imports System.ServiceModel

Namespace Microsoft.ServiceModel.Samples

    ' The service contract is defined in generatedClient.vb, generated from the service by the svcutil tool.

    ' Define class which implements callback interface of duplex contract
    Public Class CallbackHandler
        Implements ICalculatorDuplexCallback

        Public Sub Result(ByVal result As Double) Implements ICalculatorDuplexCallback.Result
            Console.WriteLine("Result({0})", result)
        End Sub

        Public Sub Equation(ByVal eqn As String) Implements ICalculatorDuplexCallback.Equation
            Console.WriteLine("Equation({0})", eqn)
        End Sub
    End Class

    Class Client
        Public Shared Sub Main()

            ' Construct InstanceContext to handle messages on callback interface
            Dim instanceContext As New InstanceContext(New CallbackHandler())

            ' Create a client
            Dim wcfClient As New CalculatorDuplexClient(instanceContext)
            Console.WriteLine("Press <ENTER> to terminate client once the output is displayed.")
            Console.WriteLine()

            Try
                ' Call the AddTo service operation.
                Dim value As Double = 100
                wcfClient.AddTo(value)

                ' Call the SubtractFrom service operation.
                value = 50
                wcfClient.SubtractFrom(value)

                ' Call the MultiplyBy service operation.
                value = 17.65
                wcfClient.MultiplyBy(value)

                ' Call the DivideBy service operation.
                value = 2
                wcfClient.DivideBy(value)

                ' Complete equation
                wcfClient.Clear()

                Console.ReadLine()

                'Closing the client gracefully closes the connection and cleans up resources
                wcfClient.Close()

            Catch timeout As TimeoutException
                Console.WriteLine(timeout.Message)
                wcfClient.Abort()
            Catch commException As CommunicationException
                Console.WriteLine(commException.Message)
                wcfClient.Abort()
            End Try
        End Sub

    End Class

End Namespace

Udostępnij za pośrednictwem

Instrukcje: uzyskiwanie dostępu do usług za pomocą kontraktu dwustronnego

Aby uzyskać dostęp do usługi dwukierunkowej

Przykład

Zobacz też

Dodatkowe zasoby