Criterios de búsqueda personalizados

Este ejemplo muestra cómo crear una concordancia de ámbito personalizada usando la lógica y cómo implementar un servicio de detección personalizado. Los clientes utilizan la funcionalidad de concordancia de ámbito personalizada para refinar y seguir usando la funcionalidad de búsqueda proporcionada por la detección WCF. El escenario que abarca este ejemplo es el siguiente:

1. Un cliente busca un servicio de calculadora.

2. Para refinar su búsqueda, el cliente debe utilizar una regla de concordancia de ámbito personalizada.

3. Según esta regla, un servicio responde al cliente si su extremo coincide con cualquiera de los ámbitos especificados por el cliente.

Demostraciones

• Crear un servicio de descarga personalizado.

• Implementar una coincidencia del ámbito personalizada por algoritmo.

Análisis

El cliente busca los criterios de concordancia de tipos "O". Un servicio responde si los ámbitos de sus extremos coinciden con alguno de los ámbitos que proporciona el cliente. En este caso, el cliente busca un servicio de calculadora que tenga cualquiera de los ámbitos de la siguiente lista:

1. net.tcp://Microsoft.Samples.Discovery/RedmondLocation

2. net.tcp://Microsoft.Samples.Discovery/SeattleLocation

3. net.tcp://Microsoft.Samples.Discovery/PortlandLocation

Para lograr esto, el cliente dirige los servicios para utilizar una regla de concordancia de ámbito personalizada pasando una coincidencia de ámbito personalizada a través de URI. Para facilitar la coincidencia de ámbito personalizada, el servicio debe utilizar un servicio de descarga personalizado que entiende la regla de coincidencia de ámbito personalizada e implemente la lógica de coincidencia asociada.

En el proyecto de cliente, abra el archivo Program.cs. Observe que el campo ScopeMatchBy del objeto FindCriteria está establecido en un URI concreto. Este identificador se envía al servicio. Si el servicio no entiende esta regla, omite la solicitud de la búsqueda del cliente.

Abra el proyecto de servicio. Se utilizan tres archivos para implementar el Servicio de descarga personalizado:

1. AsyncResult.cs: es la implementación del AsyncResult requerido por los métodos de detección.

2. CustomDiscoveryService.cs: este archivo implementa el servicio de descarga personalizado. La implementación extiende la clase DiscoveryService e invalida los métodos necesarios. Observe la implementación del método OnBeginFind. El método comprueba si el cliente especificó la coincidencia de ámbito personalizada por regla. Se trata del mismo URI personalizado que el cliente especificó previamente. Si se especifica la regla personalizada, se sigue la ruta de acceso del código que implementa la lógica de coincidencia "OR".

   Esta lógica personalizada pasa por todos los ámbitos de cada uno de los extremos que el servicio tiene. Si alguno de los ámbitos del extremo coincide con alguno de los ámbitos proporcionados por el cliente, el servicio de descarga agrega ese extremo a la respuesta que se devuelve al cliente.

3. CustomDiscoveryExtension.cs: el último paso para implementar el servicio de descarga es conectar esta implementación del servicio de detección personalizado al host de servicio. La clase de aplicación auxiliar que se utiliza aquí es la clase CustomDiscoveryExtension. Esta clase extiende la clase DiscoveryServiceExtension. El usuario debe invalidar el método GetDiscoveryService. En este caso, el método devuelve una instancia del servicio de descarga personalizado que se creó antes. PublishedEndpoints es un ReadOnlyCollection que contiene todos los extremos de la aplicación que se agregan a ServiceHost. El servicio de detección personalizado lo utiliza para rellenar su lista interna. El usuario puede agregar también otros metadatos de extremo.

Por último, abra Program.cs. Observe que tanto ServiceDiscoveryBehavior como CustomDiscoveryExtension se agregan al host. Una vez hecho esto, si el host tiene un extremo sobre el que recibir los mensajes de detección, la aplicación puede utilizar el servicio de detección personalizado.

Observe que el cliente puede encontrar el servicio sin conocer su dirección.

Para configurar, compilar y ejecutar el ejemplo

1. Abra la solución que contiene el proyecto.

2. Compile el proyecto.

3. Ejecute la aplicación de servicio.

4. Ejecute la aplicación cliente.

Nota:

Puede que los ejemplos ya estén instalados en su equipo. Compruebe el siguiente directorio (valor predeterminado) antes de continuar. <InstallDrive>:\WF_WCF_Samples Si no existe este directorio, vaya a la página de ejemplos de Windows Communication Foundation (WCF) y Windows Workflow Foundation (WF) Samples para .NET Framework 4 para descargar todos los ejemplos de WF y Windows Communication Foundation (WCF). Este ejemplo se encuentra en el siguiente directorio. <InstallDrive>:\WF_WCF_Samples\WCF\Basic\Discovery\CustomFindCriteria