WCF笔记(4)消息协定

一、消息协定和数据协定的定义方式相同,为类添加消息协定特性(MessageContract)，这样我们就可以定义一个消息协定类了

二、示例代码

 /// <summary>
    /// 数据协定类(艺术品信息)
    /// </summary>
    [DataContract]
    public class ArtInfo
    {
        /// <summary>
        /// 艺术品名称
        /// </summary>
        [DataMember]
        public string ArtName { get; set; }

        /// <summary>
        /// 创作时间
        /// </summary>
        [DataMember]
        public DateTime CreateTime { get; set; }
    }

    /// <summary>
    /// 消息协定类(艺术家)
    /// </summary>
    [MessageContract]
    public class Artist
    {
        /// <summary>
        /// 姓名
        /// </summary>
        [MessageHeader]
        public string Name { get; set; }

        /// <summary>
        /// 年龄
        /// </summary>
        [MessageBodyMember]
        public int Age { get; set; }

        /// <summary>
        /// 作品信息
        /// </summary>
        [MessageBodyMember]
        public ArtInfo ArtInfo { get; set; }
    }    

服务端

  class Program
    {
        //设置服务并启动
        static void Main()
        {
            //服务基地址
            var baseUri = new Uri("http://localhost:3000/Service");
            //声明服务器主机
            using (var host = new ServiceHost(typeof(MyService), baseUri))
            {
                //添加绑定和终结点
                var binding = new WSHttpBinding();
                host.AddServiceEndpoint(typeof(IService), binding, "test");
                //添加服务描述
                host.Description.Behaviors.Add(new ServiceMetadataBehavior { HttpGetEnabled = true });
                //启动服务
                try
                {
                    host.Open();
                    Console.WriteLine("服务已启动");
                }
                catch (Exception ex)
                {
                    Console.WriteLine(ex.Message);
                }
                Console.ReadKey();
                //关闭服务
                host.Close();
            }
        }
    }

    /// <summary>
    /// 定义服务协定
    /// </summary>
    [ServiceContract]
    public interface IService
    {
        [OperationContract]
        void SetArtistInfo(Artist artist);
    }

    /// <summary>
    /// 实现服务协定
    /// </summary>
    public class MyService : IService
    {      
        public void SetArtistInfo(Artist artist)
        {
            Console.WriteLine("作家信息");
            Console.WriteLine("姓名:{0}", artist.Name);
            Console.WriteLine("年龄:{0}", artist.Age);
            Console.WriteLine("--------作品信息------");
            ArtInfo artInfo = artist.ArtInfo;
            Console.WriteLine("作品名称:{0}", artInfo.ArtName);
            Console.WriteLine("创作时间:{0}", artInfo.CreateTime.ToString
                                        ("yyyy年MM月dd日hh时mm分ss秒"));                 
        }
    }
    

服务启动后我们在客户端添加服务引用，添加服务引用后我们可以看到我们在服务端定义的方法发生了变化

客户端

using System;

namespace Client
{
    class Program
    {
        static void Main()
        {
            var sc = new WS.ServiceClient();           
            var artInfo = new WS.ArtInfo
            {
                ArtName = "武直十",
                CreateTime = DateTime.Now
            };
            
             /*调用服务端方法设置艺术家信息(注意这里的"SetArtistInfo"方法)
            已经和我们在服务端定义的方法不一样了:Client.WS.ServiceClient.SetArtistInfo(string, int, Client.WS.ArtInfo)
            原来服务端: void SetArtistInfo(Artist artist);方法
            这说明定义为"消息协定的类"在当做传入参数的时候,它内部定义为消息体和消息头的成员都被拆开了
            消息体和消息头的区别:定义为"消息头的成员"在拆分的时候会被拆分成该方法的第一个参数
            如我们定义的:[MessageHeader] public string Name { get; set; },
            最后在客户端我们看到public void SetArtistInfo(string Name, int Age, Client.WS.ArtInfo ArtInfo)
            */
            sc.SetArtistInfo("老鬼", 55, artInfo);
           Console.ReadKey();
        }
    }
}

需要特别注意的:

a、消息协定作为传入参数，则只能有一个参数，以下定义是错误的：

void Reconcile(BankingTransaction bt1, BankingTransaction bt2);

b、除非你返回值为void，如不是，那你必须返回一个消息协定，bool UpLoadFile(TransferFileMessage tMsg)我们这个定义明显不符合要求。