Thrift 下载
去官网 https://thrift.apache.org/download 下载两个文件:
thrift-0.9.3.exe
thrift-0.9.3.tar.gz
前者用于将 .thrift 文件编译成其他语言文件(如 .cs, .cpp 等),后者是源代码,用于生成不同语言的 thrift 库文件。
下载完成后:
将 thrift-0.9.3.exe 文件重命名为 thrift.exe 并存储在 C 盘新建的文件夹Thrift 下,将 C:/Thrift 加入环境变量,重启电脑使配置生效
将 thrift-0.9.3.tar.gz 解压,进入 lib/csharp/src 文件夹,使用 Visual Studio 打开 Thrift.sln 文件,编译。完成后可在 bin/Debug 中找到 Thrift.dll 文件,就是我们每次使用 Thrift 必须加载的库文件。(提示:编译时可能会弹框提示需要 .net framework 3.5 的库,按照提示链接去官网 https://www.microsoft.com/en-us/download/details.aspx?id=22 下载安装即可)
编写 Thrift 脚本
假设服务端(Server)为客户端(Client)提供简单的数学运算功能。编写 demo.thrift 脚本如下:
namespace csharp MathClient
namespace csharp MathServer
service MathService{
i32 add (1:i32 a, 2:i32 b),
i32 sub (1:i32 a, 2:i32 b),
i32 mul (1:i32 a, 2:i32 b),
i32 div (1:i32 a, 2:i32 b),
i32 mod (1:i32 a, 2:i32 b)
}
1
2
3
4
5
6
7
8
9
10
从控制台进入 demo.thrift 的目录后,编译该文件为 C# 代码:
thrift --gen csharp demo.thrift
1
随后会生成一个 gen-csharp 的文件夹,其中包括 MathService.cs 文件,该文件需要同时导入到 Server 和 Client 的程序中,下面将详细说明。
如果是两种语言,如 Java 和 C# 通信的话,需要 –gen csharp 和 –gen java 分别编译一次,将得到的 .cs 和 .class 文件分别导入到两个项目中。
Server 程序
在 Visual Studio 中新建 C# Console Application 程序:ThriftServer。将 Thrift.dll. 导入到 Reference 中,同时将之前生成的 MathService.cs 导入项目中,并在 Program.cs 中包含:
using Thrift.Server;
using Thrift.Transport;
1
2
新建一个类 MathServer.cs (注意不是 MathService.cs),实现 MathService.Iface 接口:
public class MathServer : MathService.Iface
{
public MathServer() { }
public int add(int a, int b)
{
Console.WriteLine(“Called add({0},{1})={2}”, a, b, a + b);
return a + b;
}
public int sub(int a, int b)
{
Console.WriteLine(“Called sub({0},{1})={2}”, a, b, a - b);
return a + b;
}
public int mul(int a, int b)
{
Console.WriteLine(“Called mul({0},{1})={2}”, a, b, a * b);
return a + b;
}
public int div(int a, int b)
{
Console.WriteLine(“Called div({0},{1})={2}”, a, b, a / b);
return a / b;
}
public int mod(int a, int b)
{
Console.WriteLine(“Called mod({0},{1})={2}”, a, b, a % b);
return a % b;
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
然后修改 Program.cs 中的 Main 函数为:
static void Main(string[] args)
{
try
{
MathServer handler = new MathServer();
MathService.Processor processor = new MathService.Processor(handler);
TServerTransport serverTransport = new TServerSocket(9095);
TServer server = new TSimpleServer(processor, serverTransport);
Console.WriteLine(“Starting the server…”);
server.Serve();
}
catch (Exception x)
{
Console.WriteLine(x.StackTrace);
}
Console.WriteLine(“done.”);
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
这样 ThriftServer 项目就可以运行了。它开启 9095 端口(可以自设),然后等待 Client 与其通信。
Client 端
同样新建一个C#控制台项目:ThriftClient,并将 Thrift.dll 和 MathService.cs 导入到项目中,在Program.cs 中包含:
using Thrift.Transport;
using Thrift.Protocol;
1
2
修改 Program.cs 中的 Main 函数如下:
static void Main(string[] args)
{
TTransport transport = new TSocket(“localhost”, 9095);
transport.Open();
TProtocol protocal = new TBinaryProtocol(transport);
MathService.Client client = new MathService.Client(protocal);
Console.WriteLine(client.add(10, 20));
Console.WriteLine(client.sub(10, 20));
Console.WriteLine(client.mul(10, 20));
Console.WriteLine(client.div(10, 20));
Console.WriteLine(client.mod(10, 20));
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
运行
首先运行 MathServer,可以看到:
MathServer 界面
然后运行 MathClient,可以看到:
MathClient 界面
同时 MathServer 的控制台显示:
MathServer 界面
完!
参考
详细介绍 Apache Thrift - 可伸缩的跨语言服务开发框架(Java):http://www.ibm.com/developerworks/cn/java/j-lo-apachethrift/