一步一个脚印学习WCF系列之WCF契约设计—3-复杂类型序列化之数据契约DataContractAttribute

　　阅读目录

　　一：DataContractAttribute　

　　二：DataMemberAttribute

　　三：实例

　　一：DataContractAttribute

　　　　. 在schema和CRL类型之间转换

　　　　　　在WCF当中我们推荐的一种序列化方式是使用数据契约的这种方式，使用数据契约的方式和一般的序列化的方式是种类似的方式，也是在我们需要进行序列化的数据上面加DataContract特性，在加完DataContract特性以后，.NET本身会为我们实现schema也就是XSD和CRL类型之间的转换

　　　　. 总是要提供命名空间

　　　　. 能够提供显式的Name

　　　　　　我们希望对Book这个类所表示的对象来进行序列化的话，我们可以在它上面加上DataContract特性，并且指明说在SOAP消息当中以什么名字来传递它，在这里是SOAP消息当中我们以BookInfo名称来传递它

[DataContract(Name="BookInfo",Namespace="http://schemas.menglin.net")]
public class Book
{
}

 　　二：DataMemberAttribute

　　　　如果我们使用数据契约来描述的类，只有我们显式的把这个类当中的具体的成员通过DataMember来标记了，才表明这个成员是要参与到序列化当中，如果某一个成员没有使用DataMember来标记，表明这个成员不需要参与到序列化当中

　　　　. 应用于域和属性

　　　　　　-应用于域

　　           　　我们希望_name这个数据参与到序列化当中，或者说把它添加到SOAP数据包中，我们可以用DataMember特性来标记这个私有字段，且通过Name特性来明确_name在SOAP数据包中是使用什么名称的，也就是它使用什么具体名称存放于SOAP当中

[DataMember(Name = "BookName", IsRequired = false, Order = 0)]
private string _name;

　　　　　　-应用于属性

　　　　　　　　我们希望Name这个数据参与到序列化当中，或者说把它添加到SOAP数据包中，我们可以用DataMember特性来标记这个属性，且通过Name特性来明确Name在SOAP数据包中是使用什么名称的，也就是它使用什么具体名称存放于SOAP当中

private string _name;
/// <summary>
/// 书本名称
/// </summary>
[DataMember(Name="BookName", IsRequired = false,Order = 0)]
public string Name
{
    get { return _name; }
    set { _name = value; }
}

　　　　. 可以指定排列顺序

　　　　　　我们要进行序列化的对象它在SOAP数据包中进行排序的位置，也就是它排在第几号，在这里Name在序列化的时候在SOAP数据包中排在第一位，如果我们没有指定Order的话，默认按字母排序

private string _name;
/// <summary>
/// 书本名称
/// </summary>
[DataMember(Name="BookName", IsRequired = true,Order = 0)]
public string Name
{
      get { return _name; }
      set { _name = value; }
}

 　　　　. 能够显式的指定Name和IsRequired

　　　　　　-Name

　　　　　　　　通过Name特性来明确_name在SOAP数据包中是使用什么名称的，也就是它使用什么具体名称存放于SOAP当中

　　　　　　-IsRequired

　　　　　　　　这个属性Name是不是可为空的，也就是说在序列化之前是否必须要被赋值，IsRequired=true，表示Name在序列化之前必须要被赋值

private string _name;
/// <summary>
/// 书本名称
/// </summary>
[DataMember(Name="BookName", IsRequired = true,Order = 0)]
public string Name
{
      get { return _name; }
      set { _name = value; }
}

 　　三：实例

　　　　使用数据契约进行描述时，在WCF当中我们推荐的方式是对属性进行DataMember的描述，而不是通过字段进行描述，主要体现在OO的设计风格，对于类当中的成员，我们需要屏蔽掉外部的访问，也就是对于外部的对象而言，它只能访问这个类当中的属性，而不是直接去访问这个类当中的字段

　　　　我们定义了一个Book类，并且指定了它的名称“Book_DataContract”，然后我们对这个类当中的属性进行了DataMember的描述，指明了它的名称，和在序列化之前是否要赋值的，以及在序列化的时候所排序的位置

　　　　1：Book.cs 数据契约的定义

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Runtime.Serialization;

namespace DataContract.Service
{
    [DataContract(Name = "Book_DataContract", Namespace = "http://schames.menglin.net/2012/05/08")]
    public class Book
    {
        private int _id;
        /// <summary>
        /// 书本ID
        /// </summary>
        [DataMember(Name = "ID_DataMember", IsRequired = false, Order = 0)]
        public int ID
        {
            get { return _id; }
            set { _id = value; }
        }

        private string _name;
        /// <summary>
        /// 书本名称
        /// </summary>
        [DataMember(Name = "Name_DataMember", IsRequired = false, Order = 1)]
        public string Name
        {
            get { return _name; }
            set { _name = value; }
        }
        private string _author;
        /// <summary>
        /// 作者
        /// </summary>
        [DataMember(Name = "Author_DataMember", IsRequired = false, Order = 2)]
        public string Author
        {
            get { return _author; }
            set { _author = value; }
        }
      
        private string _publisher;
        /// <summary>
        /// 出版商
        /// </summary>
        [DataMember(Name = "Publisher_DataMember", IsRequired = false, Order = 3)]
        public string Publisher
        {
            get { return _publisher; }
            set { _publisher = value; }
        }

        private string _unit;
        /// <summary>
        /// 单位
        /// </summary>
        [DataMember(Name = "Unit_DataMember", IsRequired = false, Order = 4)]
        public string Unit
        {
            get { return _unit; }
            set { _unit = value; }
        }

        private string _price;
        /// <summary>
        /// 价格
        /// </summary>
        [DataMember(Name = "Price_DataMember", IsRequired = false, Order = 5)]
        public string Price
        {
            get { return _price; }
            set { _price = value; }
        }

        private string _addtime;
        /// <summary>
        /// 入库时间
        /// </summary>
        [DataMember(Name = "AddtTime_DataMember", IsRequired = false, Order = 6)]
        public string AddtTime
        {
            get { return _addtime; }
            set { _addtime = value; }
        }
    }
}

　　　　2：IBookService.cs 服务契约的定义

　　　　　　IBookService使用了Book，IBookService.cs是我们在Host或者在Server这一端为客户端所提供的服务，在这个服务里面我们主要为客户端提供了一个叫作“GetMyBook()”，一个叫作“SaveMyBook()”这么两个方法，这两个方法使用了Book对象，对于这个类而言的话，我们使用了IBookService这个接口来进行描述，同样我们指定了服务契约的名称和这个服务契约里面具体操作的名称

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.ServiceModel;

using DataContract.Model;

namespace DataContract.Service
{
    [ServiceContract(Name = "Book_ServiceContract", Namespace = "http://schames.menglin.net/2012/05/08")]
    public interface IBookService
    {
        [OperationContract(Name = "GetBook", Action = "http://schames.menglin.net/2012/05/08")]
        Book GetMyBook();

        [OperationContract(Name = "SaveBook", Action = "http://schames.menglin.net/2012/05/09")]
        void SaveMyBook(Book book);
    }

    public class BookService : IBookService
    {
        private Book _book;
        public Book GetMyBook()
        {
            return _book;
        }

        public void SaveMyBook(Book book)
        {
            _book = book;
        }
    }
}

　　　　3：Program.cs 服务宿主

　　　　　　在Host这一端就是把BookService这个服务加载到Host当中

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.ServiceModel;

using DataContract.Service;

namespace Host
{
    class Program
    {
        static void Main(string[] args)
        {
            using (ServiceHost host = new ServiceHost(typeof(BookService)))
            {
                host.Open();
                Console.ReadLine();
            }
        }
    }
}

 　　　　4：App.config 服务的配置

　　　　　　IMetadataExchange这个接口的作用是用于对外提供服务的元数据，所谓元数据，大家可以理解为”描述数据的数据“，什么叫作“描述数据的数据”，比如：我们现在希望Host对外提供BookService这个服务，这个服务里面包含了若干个方法，以及这些方法有一些参数，这些方法的名称，这些参数的名称，以及Book里面具体的属性都是什么，以及它具体的类型，以及它排序的方式，我们把这些数据称为元数据，我们添加IMetadataExchange这个接口就是为了对外暴露元数据，我们为什么要对外暴露元数据呢？主要原因在于对于客户端而言它为了能够访问服务器端的服务的话，它必须要获得这些元数据，也就是它必须要获得服务器这一端服务的名称，方法的名称，以及具体数据的定义，这些定义如何来获得呢？就是通过IMetadataExchange这种方式来获得这些数据，因此在这里我们需要对外暴露出IMetadata这种交换的信息，使得客户端和服务器端之间能够互通

<endpoint address="mex"
          binding="mexHttpBinding"
          contract="IMetadataExchange"  />

 

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <system.serviceModel>
        <behaviors>
            <serviceBehaviors>
                <behavior name="serviceBehavior">
                    <serviceMetadata httpGetEnabled="true" />
                </behavior>
            </serviceBehaviors>
        </behaviors>
        <services>
            <service name="DataContract.Service.BookService" behaviorConfiguration="serviceBehavior">
                <endpoint address="BookService"
                          binding="netTcpBinding"
                          contract="DataContract.Service.IBookService" />
                <endpoint address="mex"
                          binding="mexHttpBinding"
                          contract="IMetadataExchange"  />
                <host>
                    <baseAddresses>
                        <add baseAddress="http://localhost:8000"/>
                        <add baseAddress="net.tcp://localhost:9000"/>
                    </baseAddresses>
                </host>
            </service>
        </services>
    </system.serviceModel>
</configuration>

　　5：Form1.cs 客户端

　　　　在这个实例中提供了一个Winform，在这个Winform里面有两个Button，一个叫做“得到书”，一个叫做“保存书”

　　 

　　启动Host

　　

　　打开服务