【MSH】如何开发第一个最简单的WCF模块服务（附实例源码）

　　还不知道什么MSH的朋友请看开篇文章：【MSH】一个轻量级但很实用的WCF模块服务框架+WCF模块服务托管程序MSH[开篇]

　　 Module Service Hosting（MSH），是一个WCF服务模块托管程序，它提供了常用功能来管理自定义的模块服务，有了它，你可以快速开发和部署自己的WCF服务，使各个应用程序之间的沟通更方便。

　　在开篇文章里不少朋友说看不懂或不知道用它来干什么的，其实它就是一个搭好了的轻量型框架，方便大家快速有效的开发WCF服务、部署WCF服务、使客户端和服务器端安全、灵活交互等等。或许是目前使用WCF的人还很少吧，还在使用Web Service。好了，进入正题：

下载MSH1.0 （for .net 3.5）

下载最简单的MshDemo （for vs2010 & .net 3.5）

请先看实例的项目结构：

1. MSH 目录下存放MSH主程序，改名为My.MSH.exe，配置相应也改为My.MSH.exe.config；

2. MyModule 项目是WCF模块，引用MSH目录下的程序集 KudySharp.dll，在项目属性选择输出到 MSH\Modules 目录下。

2. MSH.Client 项目是客户端winform测试项目，引用MyModule项目和MSH目录下的程序集 KudySharp.dll。

下面开始讲如何完成下面的项目：

提示：本人vs2010，而且使用.net3.5

一、新建解决方案 MshDemo

二、新建类库项目 MyModule ，选中项目右键打开项目属性，把默认命名空间改为 My.Msh，引用MSH目录下的程序集 KudySharp.dll ，最后在项目属性选择输出到 MSH\Modules 目录下。

　　1.定义通道上下文 MyChannelContext

    /// <summary>
    /// 定义通道上下文，必须是继承 ChannelContextBase<TContext>
    /// </summary>
    [Serializable] // 类和属性都必须是可序列化的
    public class MyChannelContext : ChannelContextBase<MyChannelContext>
    {
        /// <summary>
        /// 自定义属性
        /// </summary>
        public string AppName
        {
            get;
            set;
        }

    }

　　2.定义WCF服务接口 IMyService

    /// <summary>
    /// 服务接口
    /// </summary>
    [ServiceContract]
    public interface IMyService
    {
        [OperationContract]
        DateTime GetTime();

        [OperationContract]
        string GetString(string str);
    }

　　3.实现WCF服务接口 MyService

    /// <summary>
    /// 服务实现
    /// </summary>
    public class MyService : IMyService
    {
        public DateTime GetTime()
        {
            return DateTime.Now;
        }

        public string GetString(string input)
        {
            var context = MyChannelContext.Current;

            string ret = "input:" + input;

            ret += "\r\nAppName:" + context.AppName;

            ret += "\r\nAppName2:" + context["AppName2"];

            // 返回信息给客户端，当然也可以是你自己定义的其它属性
            context.ReturnMessage = "OK";

            return ret;
        }
    }

　　4.最后定义模块服务类 TestModule

    /// <summary>
    /// 自己定义模块，必须是继承 ModuleBase<TContext, TContract, TService>
    /// </summary>
    public sealed class TestModule : ModuleBase<MyChannelContext/*使用的通道上下文*/, IMyService/*WCF接口约束*/, MyService/*WCF接口实现*/>
    {
        // 此例子使用了框架里默认的模块主机，所以不需要重写令牌

        /// <summary>
        /// 模块服务名称
        /// </summary>
        public override string ServiceName
        {
            get
            {
                return "MyService";
            }
        }

        /// <summary>
        /// 模块服务描述
        /// </summary>
        public override string ServiceDescription
        {
            get
            {
                return "this is my first module service";
            }
        }
    }

到这里，模块项目开发完了，点击生成后，可以在 MSH\Modules 目录下看到 MyModule.dll。

二、下面接着写客户端测试程序，新建 MSH.Client 项目，引用 MyModule 项目和 MSH 目录下的程序集 KudySharp.dll。

下面是调用上面WCF接口的测试代码：

        private void btnGetTime_Click(object sender, EventArgs e)
        {
            try
            {
                DateTime result = ModuleClient.CreateChannel<TestModule, IMyService, DateTime>(server, port, proxy =>
                {
                    return proxy.GetTime();
                });

                MessageBox.Show("Time:" + result.ToString());
            }
            catch (Exception ex)
            {
                MessageBox.Show(ex.Message);
            }
        }

        private void btnGetString_Click(object sender, EventArgs e)
        {
            try
            {
                string result = ModuleClient.CreateChannel<TestModule, IMyService, string>(server, port, proxy =>
                {
                    // 通道上下文必须是在这个action里面设置属性，外面无效
                    var context = MyChannelContext.Current;
                    context.AppName = "MSH client";
                    context["AppName2"] = "MSH client2";

                    return proxy.GetString("i am kudy");
                });

                MessageBox.Show(result + "\r\n\r\nReturnMessage:" + MyChannelContext.Current.ReturnMessage);
            }
            catch (Exception ex)
            {
                MessageBox.Show(ex.Message);
            }
        }

最后，运行MSH.Client项目，显示了如下界面: