Thrift写RPC接口

Thrift总结(二)创建RPC服务

　前面介绍了thrift 基础的东西，怎么写thrift 语法规范编写脚本，如何生成相关的语言的接口。不清楚的可以看这个《Thrift总结(一)介绍》。做好之前的准备工作以后，下面就开始如何用Thrift写RPC接口。

　　如何用Thrift写RPC接口

　　1. 打开之前下载的thrift 源码，thrift-0.10.0\lib\csharp\src ，编译生成Thrift.dll 文件。

　　

　　2. 新建一个空白解决方案命名为HelloThrift。在解决方案根目录下创建一个lib文件夹，将刚刚生成的Thrift.dll文件放入lib文件夹中。在解决方案分中建立两个控制台程序和一个类库，控制台程序分别命名为HelloThrift.Client 和 HelloThrift.Server，类库命名为Thrift.Interface。Client、Server和Interface分别引用lib文件夹中的Thrift.dll文件，将准备工作中生成的HelloService文件导入到Interface类库中。Client和Server分别引用Interface。具体结果如下图所示

　　

　　3. 创建完相关的项目和引用之后，在服务端HelloThrift.Server 创建一个类命名为MyHelloService,实现HelloService.Iface接口，代码如下：

　　清单1.MyHelloService

using System;
using HelloThrift.Interface;

namespace HelloThrift.Server
{

    public class MyHelloService : HelloService.Iface
    {
        /// <summary>
        /// 只有一个参数返回值为字符串类型的方法
        /// </summary>
        /// <param name="para">string类型参数</param>
        /// <returns>返回值为string类型</returns>
        public string HelloString(string para)
        {
            System.Threading.Thread.Sleep(1 * 1000);

            Console.WriteLine("客户端调用了HelloString方法");

            return para;
        }

        /// <summary>
        /// 只有一个参数，返回值为int类型的方法
        /// </summary>
        /// <param name="para"></param>
        /// <returns>返回值为int类型</returns>
        public int HelloInt(int para)
        {
            System.Threading.Thread.Sleep(1 * 1000);

            Console.WriteLine("客户端调用了HelloInt方法");

            return para;
        }

        /// <summary>
        /// 只有一个bool类型参数，返回值为bool类型的方法
        /// </summary>
        /// <param name="para"></param>
        /// <returns>返回值为bool类型</returns>
        public bool HelloBoolean(bool para)
        {
            System.Threading.Thread.Sleep(1 * 1000);

            Console.WriteLine("客户端调用了HelloBoolean方法");

            return para;
        }

        /// <summary>
        /// 返回执行为空的方法
        /// </summary>
        public void HelloVoid()
        {
            System.Threading.Thread.Sleep(1 * 1000);

            Console.WriteLine("客户端调用了HelloVoid方法");

            Console.WriteLine("HelloWorld");
        }

        /// <summary>
        /// 无参数，返回值为null的方法
        /// </summary>
        /// <returns>返回值为null</returns>
        public string HelloNull()
        {
            System.Threading.Thread.Sleep(1 * 1000);

            Console.WriteLine("客户端调用了HelloNull方法");

            return null;

        }

    }
}

　　4. 创建服务器端HelloThrift.Server 宿主的实现代码，在Program.cs 中添加如下代码，这样一个thrift 服务器就创建好了。

　　清单2.HelloThrift.Server

using System;
using Thrift;
using Thrift.Protocol;
using Thrift.Server;
using Thrift.Transport;
using HelloThrift.Interface;

namespace HelloThrift.Server
{
    class Program
    {
        static void Main(string[] args)
        {
            try
            {
                //设置服务端口为8080
                TServerSocket serverTransport = new TServerSocket(9081);

                //设置传输协议工厂
                TBinaryProtocol.Factory factory = new TBinaryProtocol.Factory();

                //关联处理器与服务的实现
                TProcessor processor = new HelloService.Processor(new MyHelloService());

                //创建服务端对象
                TServer server = new TThreadPoolServer(processor, serverTransport, new TTransportFactory(), factory);

                Console.WriteLine("服务端正在监听9081端口");

                server.Serve();
            }
            catch (TTransportException ex)//捕获异常信息
            {
                //打印异常信息
                Console.WriteLine(ex.Message);

            }

        }
    }
}

　　5. 创建完服务端之后，下面开始生成一个客户端实现代码，在HelloThrift.Client  的 Program.cs 中添加如下代码：

　　清单3.HelloThrift.Client

using System;
using HelloThrift.Interface;
using Thrift.Protocol;
using Thrift.Transport;

namespace HelloThrift.Client
{
    class Program
    {
        static void Main(string[] args)
        {
            try
            {

                //设置服务端端口号和地址
                TTransport transport = new TSocket("localhost", 9081);
                transport.Open();

                //设置传输协议为二进制传输协议
                TProtocol protocol = new TBinaryProtocol(transport);

                //创建客户端对象
                HelloService.Client client = new HelloService.Client(protocol);

                //调用服务端的方法
                Console.WriteLine(client.HelloString("HelloThrift"));

                Console.ReadKey();

            }
            catch (TTransportException e)
            {
                Console.WriteLine(e.Message);
            }
        }
    }
}

　　上面的代码调用了服务端的HelloString方法，服务端也会返回传入的传输值，客户端将服务端返回的数据打印出来。好了完成了代码以后，将先启动Server，在启动Client。客户端调用结果 和 服务端请求显示。

　　

　　说明

　　1. 关于使用Thrift 构建我们自己的rpc 的方法，这里基本讲完了。其他的方法本文就不再演示了，调用起来都是一样。

　　2. 后续会简单讨论一下Thrift 框架的通信原理。

　　3. 源代码下载，HelloThrift.rar