Uso de extremos estándar
El ejemplo StandardEndpoints muestra cómo utilizar los puntos de conexión estándar en archivos de configuración de servicio. Un punto de conexión estándar permite al usuario simplificar las definiciones de punto de conexión utilizando una sola propiedad para describir una dirección, enlace y combinación de contratos con propiedades adicionales asocias. En este ejemplo se muestra cómo definir e implementar un punto de conexión estándar personalizado y cómo definir propiedades concretas en él.
Detalles del ejemplo
Los puntos de conexión de servicio se pueden especificar proporcionando tres parámetros: dirección, enlace y contrato. Otros parámetros que se pueden proporcionar son la configuración de comportamiento, los encabezados, el URI de escucha, etc. En algunos casos, con una dirección o con todas, los enlaces y contratos tienen valores que no pueden cambiar. Por esta razón, es posible utilizar puntos de conexión estándar. Algunos ejemplos de tales puntos de conexión incluyen los de intercambio de metadatos y los de detección. Los extremos estándar también mejoran la capacidad de uso al permitir la configuración de los extremos de servicio sin tener que proporcionar información de naturaleza fija o crear sus propios extremos estándar, por ejemplo proporcionando un conjunto razonable de valores predeterminados y, por tanto, reduciendo el nivel de detalle de los archivos de configuración.
Este ejemplo está compuesto de dos proyectos: el servicio que define dos extremos estándar y el cliente que comunica con el servicio. La manera en que los puntos de conexión estándar se definen para el servicio en el archivo de configuración se muestra en el siguiente ejemplo.
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<system.serviceModel>
<extensions>
<endpointExtensions>
<add name="customEndpoint" type="Microsoft.Samples.StandardEndpoints.CustomEndpointCollectionElement, service" />
</endpointExtensions>
</extensions>
<services>
<service name="Microsoft.Samples.StandardEndpoints.CalculatorService">
<endpoint address="http://localhost:8000/Samples/Service.svc/customEndpoint" contract="Microsoft.Samples.StandardEndpoints.ICalculator" kind="customEndpoint" />
<endpoint kind="mexEndpoint" />
</service>
</services>
<behaviors>
<serviceBehaviors>
<behavior>
<serviceMetadata httpGetEnabled="True"/>
</behavior>
</serviceBehaviors>
</behaviors>
<standardEndpoints>
<customEndpoint>
<standardEndpoint property="True" />
</customEndpoint>
</standardEndpoints>
</system.serviceModel>
</configuration>
El primer punto de conexión definido para el servicio es de tipo customEndpoint, cuya definición se puede ver en la sección <standardEndpoints>, en la que la propiedad property recibe el valor true. Este es el caso de un extremo personalizado con una nueva propiedad. El segundo punto de conexión corresponde a un punto de conexión de metadatos en el que los valores de la dirección, el enlace y el contrato son fijos.
Para definir el elemento de punto de conexión estándar, se debe crear una clase que se derive de StandardEndpointElement. En el caso de este ejemplo, la clase CustomEndpointElement se ha definido como se muestra en el siguiente ejemplo.
public class CustomEndpointElement : StandardEndpointElement
{
public bool Property
{
get { return (bool)base["property"]; }
set { base["property"] = value; }
}
protected override ConfigurationPropertyCollection Properties
{
get
{
ConfigurationPropertyCollection properties = base.Properties;
properties.Add(new ConfigurationProperty("property", typeof(bool), false, ConfigurationPropertyOptions.None));
return properties;
}
}
protected override Type EndpointType
{
get { return typeof(CustomEndpoint); }
}
protected override ServiceEndpoint CreateServiceEndpoint(ContractDescription contract)
{
return new CustomEndpoint();
}
protected override void OnApplyConfiguration(ServiceEndpoint endpoint, ServiceEndpointElement serviceEndpointElement)
{
CustomEndpoint customEndpoint = (CustomEndpoint)endpoint;
customEndpoint.Property = this.Property;
}
protected override void OnApplyConfiguration(ServiceEndpoint endpoint, ChannelEndpointElement channelEndpointElement)
{
CustomEndpoint customEndpoint = (CustomEndpoint)endpoint;
customEndpoint.Property = this.Property;
}
protected override void OnInitializeAndValidate(ServiceEndpointElement serviceEndpointElement)
{
}
protected override void OnInitializeAndValidate(ChannelEndpointElement channelEndpointElement)
{
}
}
En la función CreateServiceEndpoint, se crea un objeto CustomEndpoint. Su definición se muestra en el siguiente ejemplo:
public class CustomEndpoint : ServiceEndpoint
{
public CustomEndpoint()
: this(string.Empty)
{
}
public CustomEndpoint(string address)
: this(address, ContractDescription.GetContract(typeof(ICalculator)))
{
}
public CustomEndpoint(string address, ContractDescription contract)
: base(contract)
{
this.Binding = new BasicHttpBinding();
this.IsSystemEndpoint = false;
}
public bool Property
{
get;
set;
}
}
Para realizar la comunicación entre el servicio y el cliente, se crea una referencia del servicio en el cliente para el servicio. Cuando el ejemplo se compila y ejecuta, el servicio se ejecuta y el cliente se comunica con él. Observe que la referencia del servicio debería actualizarse cada vez que hay algún cambio en el servicio.
Para utilizar este ejemplo
En Visual Studio, abra el archivo StandardEndpoints.sln.
Habilite varios proyectos para iniciarse.
En el Explorador de soluciones, haga clic con el botón derecho en la solución Extremos estándar y seleccione Propiedades.
En Propiedades comunes, seleccione Proyecto de inicio y haga clic en Proyectos de inicio múltiples.
Mueva el proyecto Servicio al principio de la lista, con Acción establecida en Iniciar.
Mueva el proyecto Cliente después del proyecto Servicio, también con Acción establecida en Iniciar.
De esta forma se especifica que el proyecto Cliente se ejecute después del proyecto Servicio.
Presione F5 para ejecutar la solución.
Nota
Si estos pasos no funcionan, asegúrese de que el entorno se ha configurado correctamente. Para ello, siga estos pasos:
- Asegúrese de que ha realizado el procedimiento de instalación única para los ejemplos de Windows Communication Foundation.
- Para compilar la solución, siga las instrucciones que se indican en Compilación de los ejemplos de Windows Communication Foundation.
- Para ejecutar el ejemplo en una configuración con un solo equipo o con varios, siga las instrucciones que se indican en Ejecución de los ejemplos de Windows Communication Foundation.