WCF初探-19：WCF消息协定

WCF消息协定概述

在生成 WCF应用程序时，开发人员通常会密切关注数据结构和序列化问题，而不必关心携带数据的消息结构。对于这些应用程序，为参数或返回值创建数据协定的过程很简单。但是，有时完全控制 SOAP 消息的结构与控制其内容一样重要。当必须提供互操作性或需要在消息或消息部分级别特别控制安全问题时，更是如此。在这些情况下，您可以创建消息协定，使您可以指定所需的精确的 SOAP 消息的结构。
一般来说，定义消息的架构时使用数据协定就足够了。但是，有时必须精确控制如何到通过网络传输的 SOAP 消息的结构。对于这种情况，最常见的方案是插入自定义 SOAP 标头。另一种常见方案是定义消息头和正文的安全属性，也就是说，确定是否对这些元素进行数字签名和加密。消息样式的操作可提供这种控制。

创建消息协定

消息样式的操作最多具有一个参数和一个返回值，其中参数和返回值的类型都是消息类型；也就是说，这两种类型可直接序列化为指定的 SOAP 消息结构。这可以是用 MessageContractAttribute 标记的任何类型或 Message 类型。
若要为某一类型定义消息协定（即定义该类型和 SOAP 信封之间的映射），请对该类型应用 MessageContractAttribute。然后对该类型中要成为 SOAP 标头的成员应用 MessageHeaderAttribute，并对要成为消息的 SOAP 正文部分的成员应用 MessageBodyMemberAttribute。
可以对所有字段、属性和事件应用 MessageHeaderAttribute 和 MessageBodyMemberAttribute，而不管这些字段、属性和事件是公用的、私有的、受保护的还是内部的。

WCF消息协定示例

解决方法结构如下：

工程结构说明：

Service:类库程序，WCF服务端程序。在服务协定接口IuserInfo.cs中定义了消息协定User类型的类，其中属性OprationType和OperationTime定义为消息标头，其他属性定义为消息正文。定义操作协定GetInfo(),返回消息协定User。IUserInfo.cs代码如下：

using System;
using System.ServiceModel;
using System.Collections.Generic;
using System.Runtime.Serialization;

namespace Service
{
    [ServiceContract]
    public interface IUserInfo
    {
        [OperationContract]
        User GetInfo();
    }

    [MessageContract]
    public class User
    {
        [MessageHeader]
        public string OprationType { get; set; }
        [MessageHeader]
        public DateTime OperationTime { get; set; }

        [MessageBodyMember]
        public int ID { get; set; }
        [MessageBodyMember]
        public string Name { get; set; }
        [MessageBodyMember]
        public int Age { get; set; }
        [MessageBodyMember]
        public string Nationality { get; set; }
    }
}

　　UserInfo.cs代码如下：

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

namespace Service
{
    public class UserInfo:IUserInfo
    {
        public User GetInfo()
        {
            User user = new User();
            user.OprationType = "GET";
            user.OperationTime = System.DateTime.Now;
            user.Name = "JACK";
            user.Age = 20;
            user.ID = 1;
            user.Nationality = "CHINA";

            return user;
        }
    }
}

　　2. Host:控制台应用程序，服务承载程序。添加对程序集Service的引用，完成以下代码，寄宿服务。Program.cs代码如下：

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

namespace Host
{
    class Program
    {
        static void Main(string[] args)
        {
            using (ServiceHost host = new ServiceHost(typeof(UserInfo)))
            {
                host.Opened += delegate { Console.WriteLine("服务已经启动，按任意键终止！"); };
                host.Open();
                Console.Read();
            }
        }
    }
}

View Code