Cara: Mengakses layanan dengan kontrak dupleks

Artikel
03/02/2024

Satu fitur dari Windows Communication Foundation (WCF) adalah kemampuan membuat layanan yang menggunakan pola Olahpesan dupleks. Pola ini memungkinkan layanan untuk berkomunikasi dengan klien melalui panggilan balik. Topik ini menunjukkan langkah untuk membuat klien WCF pada kelas klien yang menerapkan antarmuka panggilan balik.

Pengikatan ganda memaparkan alamat IP klien ke layanan. Klien harus menggunakan keamanan untuk memastikan bahwa ia hanya terhubung kepada layanan yang tepercaya.

Untuk tutorial tentang pembuatan layanan dan klien WCF dasar, lihat Tutorial Memulai.

Untuk mengakses layanan dupleks

Buat layanan yang berisi dua antarmuka. Antarmuka pertama untuk layanan, antarmuka kedua untuk panggilan balik. Untuk informasi selengkapnya tentang pembuatan layanan dupleks, lihat Cara: Membuat Kontrak Duplex.
Jalankan layanan.
Gunakan Alat Utilitas Metadata ServiceModel (Svcutil.exe) untuk menghasilkan kontrak (antarmuka) bagi klien. Untuk informasi tentang cara melakukannya, lihat Cara: Membuat Klien.

Terapkan antarmuka panggilan balik pada kelas klien, seperti yang ditunjukkan contoh berikut.

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

Membuat instans kelas InstanceContext. Konstruktor memerlukan instans kelas klien.

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

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

Buat instans klien WCF menggunakan konstruktor yang memerlukan objek InstanceContext. Parameter kedua dari konstruktor adalah nama titik akhir yang ditemukan dalam file konfigurasi.
```
CalculatorDuplexClient wcfClient = new CalculatorDuplexClient(site, "default");
```
```
Dim wcfClient As New CalculatorDuplexClient(site, "default")
```
Panggil metode klien WCF sesuai kebutuhan.

Contoh

Contoh kode berikut menunjukkan cara membuat kelas klien yang mengakses kontrak dupleks.

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

Bagikan melalui

Cara: Mengakses layanan dengan kontrak dupleks

Untuk mengakses layanan dupleks

Contoh

Lihat juga

Sumber Daya Tambahan: