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 = -; 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。