Interceptador de mensajes personalizados
Este ejemplo muestra el uso del modelo de extensibilidad del canal. En concreto, muestra cómo implementar un elemento de enlace personalizado que crea generadores de canales y agentes de escucha de canales para interceptar todos los mensajes entrantes y salientes en un punto concreto en la pila de tiempo de ejecución. El ejemplo también incluye un cliente y un servidor que muestran el uso de estos generadores personalizados.
En este ejemplo, el cliente y el servicio son programas de consola (.exe). El cliente y el servicio hacen uso de una biblioteca común (.dll) que contiene el elemento de enlace personalizado y sus objetos en tiempo de ejecución asociados.
Nota
El procedimiento de instalación y las instrucciones de compilación de este ejemplo se encuentran al final de este tema.
El ejemplo describe el procedimiento recomendado para crear un canal superpuesto personalizado en Windows Communication Foundation (WCF), utilizando el marco del canal y los siguientes procedimientos recomendados de WCF. Los pasos para crear un canal superpuesto personalizado son los siguientes:
Decida cuál de las formas del canal admitirá el generador de canales y el agente de escucha del canal.
Cree un generador de canales y un agente de escucha del canal que admita las formas del canal.
Agregue un elemento de enlace que añada el canal superpuesto personalizado a una pila de canales. Para obtener más información, consulte Adding a Binding Element.
Agregue una sección de extensión de elemento de enlace para exponer el nuevo elemento de enlace al sistema de configuración.
Formas del canal
El primer paso para escribir un canal superpuesto personalizado es decidir qué formas son necesarias para el canal. Para nuestro inspector de mensajes, admitimos cualquier forma que admita el nivel debajo de nosotros (por ejemplo, si la capa debajo de nosotros puede generar IOutputChannel y IDuplexSessionChannel, también exponemos IOutputChannel y IDuplexSessionChannel).
Generador de canales y de agentes de escucha
El paso siguiente para escribir un canal superpuesto personalizado es crear una implementación de IChannelFactory para los canales de cliente y de IChannelListener para los canales de servicio.
Estas clases escogen un generador y un agente de escucha internos y delegan todas las llamadas excepto OnCreateChannel y OnAcceptChannel al generador y agente de escucha internos.
class InterceptingChannelFactory<TChannel> : ChannelFactoryBase<TChannel>
{ ... }
class InterceptingChannelListener<TChannel> : ListenerFactoryBase<TChannel>
{ ... }
Adición de un elemento de enlace
El ejemplo define un elemento de enlace personalizado: InterceptingBindingElement. InterceptingBindingElement toma un ChannelMessageInterceptor como una entrada y utiliza este ChannelMessageInterceptor para manipular los mensajes que lo atraviesan. Ésta es la única clase que debe ser pública. El generador, agente de escucha y canales pueden ser implementaciones internas de las interfaces en tiempo de ejecución públicas.
public class InterceptingBindingElement : BindingElement
Agregación de la compatibilidad de configuración
Para integrar con la configuración de enlace, la biblioteca define un controlador de la sección de configuración como una sección de extensión de elemento de enlace. Los archivos de configuración del servidor y el cliente deben registrar la extensión del elemento de enlace con el sistema de configuración. Los implementadores que desean exponer su elemento de enlace al sistema de configuración pueden derivar de esta clase.
public abstract class InterceptingElement : BindingElementExtensionElement { ... }
Adición de directivas
Para integrar con nuestro sistema de directivas, InterceptingBindingElement implementa IPolicyExportExtension para señalar que deberíamos participar en la generación de directivas. Para permitir importar la directiva en un cliente generado, el usuario puede registrar una clase derivada de InterceptingBindingElementImporter e invalidar CreateMessageInterceptor() para generar su clase ChannelMessageInterceptor habilitada por la directiva.
Ejemplo: inspector de mensajes que pueden eliminarse
En este ejemplo se incluye una implementación de ejemplo de ChannelMessageInspector que elimina mensajes.
class DroppingServerElement : InterceptingElement
{
protected override ChannelMessageInterceptor CreateMessageInterceptor()
{
return new DroppingServerInterceptor();
}
}
Puede tener acceso a ella desde la configuración de la manera siguiente:
<configuration>
...
<system.serviceModel>
...
<extensions>
<bindingElementExtensions>
<add name="droppingInterceptor"
type=
"Microsoft.ServiceModel.Samples.DroppingServerElement, library"/>
</bindingElementExtensions>
</extensions>
</system.serviceModel>
</configuration>
El cliente y servidor usan esta sección de configuración que se acaba de crear para insertar los generadores personalizados en el nivel más bajo de sus pilas de canales en el tiempo de ejecución (por encima del nivel de transporte).
<customBinding>
<binding name="sampleBinding">
<droppingInterceptor/>
<httpTransport/>
</binding>
</customBinding>
El cliente utiliza la biblioteca MessageInterceptor para agregar un encabezado personalizado a mensajes con número par. Por otra parte, el servicio utiliza la biblioteca MessageInterceptor para eliminar cualquier mensaje que no tenga este encabezado especial.
Debería ver el siguiente resultado del cliente después de ejecutar primero el servicio y después el cliente.
Reporting the next 10 wind speed
100 kph
Server dropped a message.
90 kph
80 kph
Server dropped a message.
70 kph
60 kph
Server dropped a message.
50 kph
40 kph
Server dropped a message.
30 kph
20 kph
Server dropped a message.
10 kph
Press ENTER to shut down client
El cliente informa sobre 10 velocidades de viento diferentes para el servicio, pero sólo marca la mitad con el encabezado especial.
En el servicio, debería ver el resultado siguiente:
Press ENTER to exit.
Dangerous wind detected! Reported speed (90) is greater than 64 kph.
Dangerous wind detected! Reported speed (70) is greater than 64 kph.
5 wind speed reports have been received.
Para configurar, generar y ejecutar el ejemplo
Asegúrese de que ha realizado el Procedimiento de instalación único para ejemplos de Windows Communication Foundation.
Para generar la solución, siga las instrucciones de Generación de ejemplos de Windows Communication Foundation.
Para ejecutar el ejemplo en una configuración de equipos única o cruzada, siga las instrucciones de Ejecución de ejemplos de Windows Communication Foundation.
Ejecute primero Service.exe, a continuación, ejecute Client.exe e inspeccione ambas ventanas de la consola para ver el resultado.
.gif "Footer image")
Copyright © 2007 Microsoft Corporation. Reservados todos los derechos.