WCF入门（10）

前言

又堕落了，哎。

公司是做乙方的，工资还凑合，主要是项目基本都已完成，进去就是干维护，体会不到那种从头彻尾的成就感。项目中具体用了EF+Ado.net+WCF+WPF+（VB.net啊，坑啊，完全不知道是这个东西），整个解决方案有47个项目，是一个国际化的电话保险销售系统中的一部分。感觉自己是去体验生活的。这个项目也就是自己学习WCF的原因。

工作方面，等手上的结束了再卖自己一次吧。

第十集 Message Contract in WCF (WCF 的MessageContract特性)

很简单的一集，讲的主要是WCF中的MessageContract特性，具体作用是用来控制WCF 的xml request和response的soap消息格式。可以理解为前面讲过的DataContract的升级版。如果我们想在程序上完全控制soap消息的格式，这就是一个很好的解决方案。

视频上通过修改以前的Demo来演示了一遍他的具体使用。我们也来做一遍。

首先，定义两个类EmployeeRequest 和 EmployeeInfo

    [MessageContract(IsWrapped = true, WrapperName = "EmployeeRequestObj", WrapperNamespace = "http://HelloWcf.com/2015/02/04")]
    public class EmployeeRequest
    {
        [MessageHeader(Namespace = "http://HelloWcf.com/2015/02/04")]
        public String LicenseKey { get; set; }

        [MessageBodyMember(Namespace = "http://HelloWcf.com/2015/02/04")]
        public int Id { get; set; }
    }
    [MessageContract]
    public class EmployeeInfo
    {
        public EmployeeInfo()
        {

        }
        public EmployeeInfo(Employee emp)
        {
            this.ID = emp.Id; this.Name = emp.Name;
            this.Gender = emp.Gender; this.DOB = emp.DateOfBirth;
            this.EmployeeType = emp.EmployeeType;
        }
        [MessageBodyMember]
        public int ID { get; set; }
        [MessageBodyMember]
        public String Name { get; set; }
        [MessageBodyMember]
        public bool Gender { get; set; }
        [MessageBodyMember]
        public DateTime DOB { get; set; }
        [MessageBodyMember]
        public EmployeeType EmployeeType { get; set; }
    }

 区别与以前的DataContract ，这个类是用MessageContract来修饰，里面的属性用MessageHeader 或者 MessageBodyMember ，作用很明显，分别对应soap message里面的head 和 body。

LicenseKey在实际的环境中用来标识客户端的身份，他可以以加密的方式存在，以后会讲到。放在Header中，区别于我们Request的body中具体业务逻辑相关的内容。

然后修改IEmployeeService这个 ServiceContract

    [ServiceContract]
    public interface IEmployeeService
    {
        [OperationContract]
        EmployeeInfo GetEmployee(EmployeeRequest req);

        [OperationContract]
        void SaveEmployee(EmployeeInfo emp);

    }

 注意，当我们修改了原先的两个OperationContract 方法的参数后，客户端就不晓得原先的Employee的概念，他们只知道现在的Request 和 Info。

接口改完之后自然要改写接口的实现

    public class EmployeeService : IEmployeeService
    {
        public EmployeeInfo GetEmployee(EmployeeRequest er)
        {
            Employee emp = null;
            var connStr = ConfigurationManager.ConnectionStrings["WCFEmployee"].ConnectionString;
            using(var conn = new SqlConnection(connStr)) {
                conn.Open();
                var cmd = conn.CreateCommand();
                cmd.CommandType = System.Data.CommandType.StoredProcedure;
                cmd.CommandText = "spGetEmployeeById";
                cmd.Parameters.Add(new SqlParameter("id", er.Id));
                var reader = cmd.ExecuteReader();
                if(!reader.HasRows) return null;
                emp = new Employee();
                while(reader.Read()) {
                    emp.Id = Convert.ToInt32(reader["Id"]);
                    emp.Name = reader["Name"].ToString();
                    emp.Gender = Convert.ToBoolean(reader["Gender"]);
                    emp.DateOfBirth = Convert.ToDateTime(reader["DateOfBirth"]);
                    emp.EmployeeType = (EmployeeType)Convert.ToInt16(reader["EmployeeType"]);
                }
            }
            return new EmployeeInfo(emp);
        }

        public void SaveEmployee(EmployeeInfo emp)
        {
            var connStr = ConfigurationManager.ConnectionStrings["WCFEmployee"].ConnectionString;
            using(var conn = new SqlConnection(connStr)) {
                conn.Open();
                var cmd = conn.CreateCommand();
                cmd.CommandType = System.Data.CommandType.StoredProcedure;
                cmd.CommandText = "spSaveEmployee";
                cmd.Parameters.Add(new SqlParameter("id", emp.ID));
                cmd.Parameters.Add(new SqlParameter("name", emp.Name));
                cmd.Parameters.Add(new SqlParameter("gender", emp.Gender));
                cmd.Parameters.Add(new SqlParameter("dateOfBirth", emp.DOB));
                cmd.Parameters.Add(new SqlParameter("employeeType", (short)emp.EmployeeType));
                cmd.ExecuteNonQuery();
            }
        }

    }

 全是基本的Ado.net的内容，可不看。测试项目用EntityFramework来做挺爽的。记得在VPN挂掉之前下了视频同个作者的EF教程，等学完这个再相对系统的学习一下EF。

服务端OK了，启动Host运行一下。（记得要以管理员方式运行host）

客户端更新一下服务引用，修改一下以前的两个click事件的代码

    protected void btnGet_Click(object sender, EventArgs e)
    {
        IEmployeeService client = new EmployeeServiceClient();
        try {
            var emp = client.GetEmployee(new EmployeeRequest() { LicenseKey = "ABCDEFGHI1234567", Id = Convert.ToInt32(tbId.Text) });
            if(emp == null) { tbName.Text = ""; tbDateOfBirth.Text = ""; rbGenderList.SelectedIndex = -1; throw new Exception("没有找到员工"); }
            lbRstMsg.Text = "查找成功";
            tbName.Text = emp.Name; tbDateOfBirth.Text = emp.DOB.ToShortDateString(); rbGenderList.SelectedValue = emp.Gender.ToString();
        } catch(Exception ex) {
            lbRstMsg.Text = ex.Message;
        } finally {
        }
    }
    protected void btnSave_Click(object sender, EventArgs e)
    {
        IEmployeeService client = new EmployeeServiceClient();
        try {

            var emp = new EmployeeInfo()
            {
                ID = Convert.ToInt32(tbId.Text), Name = Convert.ToString(tbName.Text),
                Gender = Convert.ToBoolean(rbGenderList.SelectedValue), DOB = Convert.ToDateTime(tbDateOfBirth.Text)
            };
            client.SaveEmployee(emp);
            lbRstMsg.Text = "保存成功";
        } catch(Exception ex) {
            lbRstMsg.Text = ex.Message;
        }
    }

 话说这个WebForm的Demo，写起来也挺开心的。

这里有个要注意的地方是第三行，实例化client的时候要定义个IEmployeeService 接口类型，不能直接用var来，如果用var就是后面的EmployeeServiceClient类型，他的参数不是ServiceContract中定义的EmployeeRequest，至于为什么，我也不晓得，以后应该会知道的吧。

最后保存，编译，测试一下。

一切如愿，再来看看上集中讲的Log。

首先是Request：

<MessageLogTraceRecord>
<HttpRequest xmlns="http://schemas.microsoft.com/2004/06/ServiceModel/Management/MessageTrace">
<Method>POST</Method>
<QueryString></QueryString>
<WebHeaders>
<VsDebuggerCausalityData>uIDPo34fm0IuoetItvuIdT55jAEAAAAAXsy48FQlpECWY/zesZsAtJ94pCeN9F5IvPTu2MbWQ3AACQAA</VsDebuggerCausalityData>
<SOAPAction>"http://tempuri.org/IEmployeeService/GetEmployee"</SOAPAction>
<Connection>Keep-Alive</Connection>
<Content-Length>291</Content-Length>
<Content-Type>text/xml; charset=utf-8</Content-Type>
<Accept-Encoding>gzip, deflate</Accept-Encoding>
<Expect>100-continue</Expect>
<Host>localhost:8080</Host>
</WebHeaders>
</HttpRequest>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<h:LicenseKey xmlns:h="http://HelloWcf.com/2015/02/04">ABCDEFGHI1234567</h:LicenseKey>
<To s:mustUnderstand="1" xmlns="http://schemas.microsoft.com/ws/2005/05/addressing/none">http://localhost:8080/EmployeeService</To>
<Action s:mustUnderstand="1" xmlns="http://schemas.microsoft.com/ws/2005/05/addressing/none">http://tempuri.org/IEmployeeService/GetEmployee</Action>
</s:Header>
<s:Body>
<EmployeeRequestObj xmlns="http://HelloWcf.com/2015/02/04">
<Id>1</Id>
</EmployeeRequestObj>
</s:Body>
</s:Envelope>
</MessageLogTraceRecord>

Header中有LicenseKey，body中有Id。

再看Response：

<MessageLogTraceRecord>
<Addressing xmlns="http://schemas.microsoft.com/2004/06/ServiceModel/Management/MessageTrace">
<Action>http://tempuri.org/IEmployeeService/GetEmployeeResponse</Action>
</Addressing>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
<s:Header>
<ActivityId CorrelationId="7451a535-182c-4b89-8e42-8e312b48d8e0" xmlns="http://schemas.microsoft.com/2004/09/ServiceModel/Diagnostics">f50e4154-a211-4ed1-b959-9965f22a70d3</ActivityId>
</s:Header>
<s:Body>
<EmployeeInfo xmlns="http://tempuri.org/">
<DOB>1990-01-02T00:00:00</DOB>
<EmployeeType>FullTimeEmployee</EmployeeType>
<Gender>true</Gender>
<ID>1</ID>
<Name>员工1</Name>
</EmployeeInfo>
</s:Body>
</s:Envelope>
</MessageLogTraceRecord>

属性都是我们在EmployeeInfo中定义的，WrapperName，Namespace等也都ok。

综上所述，有了MessageContract这个特性，我们对soap信息可以想怎么干就怎么干。

ThankYou。