Programación a nivel de canal de cliente

En este tema se describe cómo escribir una aplicación de cliente de Windows Communication Foundation (WCF) sin utilizar la clase System.ServiceModel.ClientBase y su modelo de objetos asociado.

Envío de mensajes

Para estar listo para enviar mensajes y recibir y procesar las respuestas, se han de realizar los pasos siguientes:

1. Crear un enlace.

2. Crear un generador de canales.

3. Crear un canal.

4. Enviar una solicitud y leer la respuesta.

5. Cerrar todos los objetos de canal.

Creación de un enlace

Similar al caso de recepción (vea Programación de servicios a nivel de canal), enviar mensajes se inicia creando un enlace. Este ejemplo crea un nuevo System.ServiceModel.Channels.CustomBinding y agrega un System.ServiceModel.Channels.HttpTransportBindingElement a su colección Elements.

Creación de un ChannelFactory

En lugar de crear un System.ServiceModel.Channels.IChannelListener, en esta ocasión creamos un System.ServiceModel.ChannelFactory llamando a System.ServiceModel.ChannelFactory.CreateFactory en el enlace donde está el parámetro de tipo System.ServiceModel.Channels.IRequestChannel. Aunque el lado que espera mensajes entrantes usa los agentes de escuchas de canales, el lado que inicia la comunicación para crear un canal emplea los generadores de canales. Al igual que los agentes de escuchas de canales, los generadores de canales se han de abrir primero antes de que puedan utilizarse.

Creación de un canal

A continuación llamamos a System.ServiceModel.ChannelFactory.CreateChannel para crear un IRequestChannel. Esta llamada toma la dirección del extremo con el que deseamos comunicarnos utilizando el nuevo canal que se crea. Una vez que tenemos un canal, llamamos a Open para dejarlo listo para la comunicación. Dependiendo de la naturaleza del transporte, esta llamada a Open puede iniciar una conexión con el extremo de destino o puede que no haga nada en absoluto en la red.

Envío de una solicitud y lectura de la respuesta

Una vez que tenemos un canal abierto, podemos crear un mensaje y utilizar el método Request del canal para enviar la solicitud y esperar a que la respuesta regrese. Cuando este método devuelve, tenemos un mensaje de respuesta que podemos leer para averiguar cuál fue la respuesta del extremo.

Cerrar objetos

Para evitar la pérdida de recursos, cerramos los objetos utilizados en las comunicaciones cuando ya no se necesiten.

El siguiente ejemplo de código muestra un cliente básico que utiliza el generador de canales para enviar un mensaje y leer la respuesta.

using System;
using System.ServiceModel;
using System.ServiceModel.Channels;
using System.ServiceModel.Configuration;
namespace ProgrammingChannels
{
class Client
{

    static void RunClient()
    {
        //Step1: Create a binding with just HTTP.
        BindingElement[] bindingElements = new BindingElement[2];
        bindingElements[0] = new TextMessageEncodingBindingElement();
        bindingElements[1] = new HttpTransportBindingElement();
        CustomBinding binding = new CustomBinding(bindingElements);

        //Step2: Use the binding to build the channel factory.
        IChannelFactory<IRequestChannel> factory =
        binding.BuildChannelFactory<IRequestChannel>(
                         new BindingParameterCollection());
        //Open the channel factory.
        factory.Open();

        //Step3: Use the channel factory to create a channel.
        IRequestChannel channel = factory.CreateChannel(
           new EndpointAddress("https://localhost:8080/channelapp"));
        channel.Open();

        //Step4: Create a message.
        Message requestmessage = Message.CreateMessage(
            binding.MessageVersion,
            "https://contoso.com/someaction",
             "This is the body data");
        //Send message.
        Message replymessage = channel.Request(requestmessage);
        Console.WriteLine("Reply message received");
        Console.WriteLine("Reply action: {0}",
                              replymessage.Headers.Action);
        string data = replymessage.GetBody<string>();
        Console.WriteLine("Reply content: {0}", data);

        //Step5: Do not forget to close the message.
        replymessage.Close();
        //Do not forget to close the channel.
        channel.Close();
        //Do not forget to close the factory.
        factory.Close();

    }
    public static void Main()
    {
        Console.WriteLine("Press [ENTER] when service is ready");
        Console.ReadLine();
        RunClient();
        Console.WriteLine("Press [ENTER] to exit");
        Console.ReadLine();
    }
}
}