Suplente de DataContract

El ejemplo DataContract muestra cómo se pueden personalizar procesos como la serialización, la deserialización y la exportación e importación del esquema usando una clase suplente de DataContract. Este ejemplo muestra cómo utilizar un suplente en un escenario de cliente y servidor donde los datos se serializan y transmiten entre un cliente y un servicio de Windows Communication Foundation (WCF).

Nota

El procedimiento de instalación y las instrucciones de compilación de este ejemplo se encuentran al final de este tema.

El ejemplo utiliza el siguiente contrato de servicio:

[ServiceContract(Namespace = "http://Microsoft.ServiceModel.Samples")]
[AllowNonSerializableTypes]
public interface IPersonnelDataService
{
    [OperationContract]
    void AddEmployee(Employee employee);

    [OperationContract]
    Employee GetEmployee(string name);
}

La operación AddEmployee permite a los usuarios agregar datos sobre nuevos empleados y la operación GetEmployee admite la búsqueda de empleados basada en nombre.

Estas operaciones utilizan el tipo de datos siguiente:

[DataContract(Namespace = "http://Microsoft.ServiceModel.Samples")]
class Employee
{
    [DataMember]
    public DateTime dateHired;

    [DataMember]
    public Decimal salary;

    [DataMember]
    public Person person;
}

En el tipo Employee , la clase Person (mostrada en el siguiente código de ejemplo) no puede ser serializada por DataContractSerializer porque no es una clase de contrato de datos válida.

public class Person
{
    public string firstName;

    public string lastName;

    public int age;

    public Person() { }
}

Puede aplicar el atributo DataContractAttribute a la clase Person, pero esto es no siempre posible. Por ejemplo, la clase Person se puede definir en un ensamblado independiente sobre el que no tiene ningún control.

Dada esta restricción, una manera de serializar la clase Person es sustituirla con otra clase que se marca con DataContractAttribute y copiar los datos necesarios en la nueva clase. El objetivo es hacer que la clase Person aparezca como un DataContract a DataContractSerializer. Tenga en cuenta que se trata de una manera de serializar las clases de contrato de no datos.

El ejemplo reemplaza lógicamente la clase Person con una clase diferente denominada PersonSurrogated.

[DataContract(Name="Person", Namespace = "http://Microsoft.ServiceModel.Samples")]
public class PersonSurrogated
{
    [DataMember]
    public string FirstName;

    [DataMember]
    public string LastName;

    [DataMember]
    public int Age;
}

El suplente del contrato de datos se utiliza para lograr este reemplazo. Un suplente del contrato de datos es una clase que implementa IDataContractSurrogate. En este ejemplo, la clase AllowNonSerializableTypesSurrogateimplementa este interfaz.

En la implementación de interfaces, la primera tarea es establecer una asignación de tipo de Person a PersonSurrogated. Esto se utiliza tanto a la hora de serializar como a la de exportar esquemas. Esta asignación se logra implementando el método GetDataContractType(Type).

public Type GetDataContractType(Type type)
{
    if (typeof(Person).IsAssignableFrom(type))
    {
        return typeof(PersonSurrogated);
    }
    return type;
}

El método GetObjectToSerialize(Object, Type) asigna una instancia Person a una instancia PersonSurrogated durante la serialización, como se muestra en el código muestra siguiente.

public object GetObjectToSerialize(object obj, Type targetType)
{
    if (obj is Person)
    {
        Person person = (Person)obj;
        PersonSurrogated personSurrogated = new PersonSurrogated();
        personSurrogated.FirstName = person.firstName;
        personSurrogated.LastName = person.lastName;
        personSurrogated.Age = person.age;
        return personSurrogated;
    }
    return obj;
}

El método GetDeserializedObject(Object, Type) proporciona la asignación inversa para la deserialización, como se muestra en el código muestra siguiente.

public object GetDeserializedObject(object obj,
Type targetType)
{
    if (obj is PersonSurrogated)
    {
        PersonSurrogated personSurrogated = (PersonSurrogated)obj;
        Person person = new Person();
        person.firstName = personSurrogated.FirstName;
        person.lastName = personSurrogated.LastName;
        person.age = personSurrogated.Age;
        return person;
    }
    return obj;
}

Para asignar el contrato de datos PersonSurrogated a la clase Person existente durante la importación del esquema, el ejemplo implementa el método GetReferencedTypeOnImport(String, String, Object), como se muestra en el código muestra siguiente.

public Type GetReferencedTypeOnImport(string typeName,
               string typeNamespace, object customData)
{
if (
typeNamespace.Equals("http://schemas.datacontract.org/2004/07/DCSurrogateSample")
)
    {
         if (typeName.Equals("PersonSurrogated"))
        {
             return typeof(Person);
        }
     }
     return null;
}

El siguiente código muestra completa la implementación de la interfaz IDataContractSurrogate.

public System.CodeDom.CodeTypeDeclaration ProcessImportedType(
          System.CodeDom.CodeTypeDeclaration typeDeclaration,
          System.CodeDom.CodeCompileUnit compileUnit)
{
    return typeDeclaration;
}
public object GetCustomDataToExport(Type clrType,
                               Type dataContractType)
{
    return null;
}

public object GetCustomDataToExport(
System.Reflection.MemberInfo memberInfo, Type dataContractType)
{
    return null;
}
public void GetKnownCustomDataTypes(
        KnownTypeCollection customDataTypes)
{
    // It does not matter what we do here.
    throw new NotImplementedException();
}

En este ejemplo, el suplente está habilitado en ServiceModel por un atributo llamado AllowNonSerializableTypesAttribute. Los programadores necesitarían aplicar este atributo en su contrato de servicios como se muestra en el contrato de servicios anterior IPersonnelDataService. Este atributo implementa IContractBehavior y establece el suplente en operaciones en suApplyClientBehavior y métodos ApplyDispatchBehavior.

El atributo no es necesario en este caso - se utiliza como demostración en este ejemplo. Los usuarios pueden habilitar alternativamente un suplente agregando manualmente un IContractBehaviorsimilar, IEndpointBehavior o IOperationBehavior utilizando código o utilizando la configuración.

La implementación IContractBehavior busca operaciones que utilizan DataContract comprobando si tienen DataContractSerializerOperationBehavior registrado. Si lo tienen, establece la propiedad DataContractSurrogate en ese comportamiento. En el siguiente código de muestra se explica cómo se hace. Establecer el suplente en este comportamiento de la operación lo habilita para la serialización y deserialización.

public void ApplyClientBehavior(ContractDescription description, ServiceEndpoint endpoint, System.ServiceModel.Dispatcher.ClientRuntime proxy)
{
    foreach (OperationDescription opDesc in description.Operations)
    {
        ApplyDataContractSurrogate(opDesc);
    }
}

public void ApplyDispatchBehavior(ContractDescription description, ServiceEndpoint endpoint, System.ServiceModel.Dispatcher.DispatchRuntime dispatch)
{
    foreach (OperationDescription opDesc in description.Operations)
    {
        ApplyDataContractSurrogate(opDesc);
    }
}

private static void ApplyDataContractSurrogate(OperationDescription description)
{
    DataContractSerializerOperationBehavior dcsOperationBehavior = description.Behaviors.Find<DataContractSerializerOperationBehavior>();
    if (dcsOperationBehavior != null)
    {
        if (dcsOperationBehavior.DataContractSurrogate == null)
            dcsOperationBehavior.DataContractSurrogate = new AllowNonSerializableTypesSurrogate();
    }
}

Se necesitan dar pasos adicionales para conectar el suplente para su uso durante la generación de metadatos. Un mecanismo para ello es proporcionar un IWsdlExportExtension que es lo que este ejemplo muestra. Otra manera es modificar directamente WsdlExporter.

El atributo AllowNonSerializableTypesAttribute implementa IWsdlExportExtension y IContractBehavior. La extensión puede ser IContractBehavior o IEndpointBehavior en este caso. Su implementación de método IWsdlExportExtension.ExportContract habilita el suplente agregándolo a XsdDataContractExporter usado durante la generación del esquema para DataContract. El siguiente fragmento de código muestra cómo hacerlo:

public void ExportContract(WsdlExporter exporter, WsdlContractConversionContext context)
{
    if (exporter == null)
        throw new ArgumentNullException("exporter");

    object dataContractExporter;
    XsdDataContractExporter xsdDCExporter;
    if (!exporter.State.TryGetValue(typeof(XsdDataContractExporter), out dataContractExporter))
    {
        xsdDCExporter = new XsdDataContractExporter(exporter.GeneratedXmlSchemas);
        exporter.State.Add(typeof(XsdDataContractExporter), xsdDCExporter);
    }
    else
    {
        xsdDCExporter = (XsdDataContractExporter)dataContractExporter;
    }
    if (xsdDCExporter.Options == null)
        xsdDCExporter.Options = new ExportOptions();

    if (xsdDCExporter.Options.DataContractSurrogate == null)
        xsdDCExporter.Options.DataContractSurrogate = new AllowNonSerializableTypesSurrogate();
}

Al ejecutar el ejemplo, el cliente llama AddEmployee seguido por una llamada a GetEmployee para comprobar si la primera llamada tuvo éxito. El resultado de la solicitud de operación de GetEmployee se muestra en la ventana de la consola del cliente. La operación GetEmployee debe encontrar al empleado e imprimir "encontrado".

Nota

Este ejemplo muestra cómo conectar un suplente para serializar, deserializar y generar metadatos. No muestra cómo conectar un suplente para la generación de código a partir de metadatos. Para ver un ejemplo de cómo se puede usar un suplente para conectarse a la generación de código del cliente, vea el ejemplo Publicación de WSDL personalizada.

Configurar, compilar y ejecutar el ejemplo

1. Asegúrese de que ha realizado el procedimiento de instalación única para los ejemplos de Windows Communication Foundation.

2. Para compilar la edición de C# de la solución, siga las instrucciones que se indican en Compilación de los ejemplos de Windows Communication Foundation.

3. Para ejecutar el ejemplo en una configuración de una sola máquina o de varias máquinas, siga las instrucciones que se indican en Ejecución de los ejemplos de Windows Communication Foundation.