Thrift 入门介绍

目录

1.什么是 Thrift

2.跨语言特性

3.协议栈结构

4.安装

5.Thrift 开发简单示例

1.什么是 Thrift

简单来说，Thrift是Facebook公布的一款开源跨语言的RPC（Remote Procedure Call，远程过程调用）框架。

2.跨语言特性

Thrift通过一个中间语言IDL(接口定义语言)来定义RPC的数据类型和接口，这些内容写在以 .thrift 结尾的文件中，然后通过特殊的编译器来生成不同语言的代码,以满足不同需要的开发者，比如java开发者就可以生成java代码，c++开发者可以生成c++代码，生成的代码中不但包含目标语言的接口定义、方法、数据类型，还包含有RPC协议层和传输层的实现代码。

3.协议栈结构

Thrift是一种c/s的架构体系。在最上层是用户自行实现的业务逻辑代码，第二层是由thrift编译器自动生成的代码，主要用于结构化数据的解析、发送和接收。TServer主要任务是高效的接受客户端请求，并将请求转发给Processor处理。Processor负责对客户端的请求做出响应，包括RPC请求转发，调用参数解析和用户逻辑调用，返回值写回等处理。从TProtocol以下部分是thirft的传输协议和底层I/O通信。TProtocol是用于数据类型解析的，将结构化数据转化为字节流给TTransport进行传输。TTransport是与底层数据传输密切相关的传输层，负责以字节流方式接收和发送消息体，不关注是什么数据类型。底层IO负责实际的数据传输，包括socket、文件和压缩数据流等。

4.安装

brew install thrift

5.Thrift 开发简单示例

1）创建并使用 IDL 描述语言编写 thrift 文件：Hello.thrift

namespace java com.thrift.demo
service  HelloWorldService {
  string sayHello(1:string username)
}

2）终端进入 Hello.thrift 所在文件目录，执行如下命令，生成 java代码

thrift -r -gen java Hello.thrift

3）创建一个Maven管理的Java项目,pom.xml中添加相关的依赖，并将生成的 java文件复制到项目中

    <dependencies>
        <dependency>
            <groupId>org.apache.thrift</groupId>
            <artifactId>libthrift</artifactId>
            <version>0.8.0</version>
        </dependency>
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-log4j12</artifactId>
            <version>1.5.8</version>
        </dependency>
    </dependencies>

4）实现接口Iface

java代码：HelloWorldImpl.java

package com.thrift.demo;

import org.apache.thrift.TException;

public class HelloWorldImpl implements HelloWorldService.Iface {

	public HelloWorldImpl() {
	}

	@Override
	public String sayHello(String username) throws TException {
		return "Hi," + username + " welcome to thrift world";
	}

}

5）实现服务端Server

编码步骤：

• 创建TProcessor

• 创建TServerTransport

• 创建TProtocol

• 创建TServer

• 启动Server

 

java 代码：HelloServerDemo.java

package com.thrift.demo;

import org.apache.thrift.TProcessor;
import org.apache.thrift.protocol.TBinaryProtocol;
import org.apache.thrift.server.TServer;
import org.apache.thrift.server.TSimpleServer;
import org.apache.thrift.transport.TServerSocket;

public class HelloServerDemo {
	public static final int SERVER_PORT = 8090;

	public void startServer() {
		try {
			System.out.println("HelloWorld TSimpleServer start ....");

			TProcessor tprocessor = new HelloWorldService.Processor<HelloWorldService.Iface>(new HelloWorldImpl());
			// new HelloWorldService.Processor<HelloWorldService.Iface>(new HelloWorldImpl())
			// new HelloWorldService.Processor<HelloWorldService.Iface>(new HelloWorldImpl());

			// 简单的单线程服务模型，一般用于测试
			TServerSocket serverTransport = new TServerSocket(SERVER_PORT);
			TServer.Args tArgs = new TServer.Args(serverTransport);
			tArgs.processor(tprocessor);
			tArgs.protocolFactory(new TBinaryProtocol.Factory());
			// tArgs.protocolFactory(new TCompactProtocol.Factory());
			// tArgs.protocolFactory(new TJSONProtocol.Factory());
			TServer server = new TSimpleServer(tArgs);
			server.serve();

		} catch (Exception e) {
			System.out.println("Server start error!!!");
			e.printStackTrace();
		}
	}

	/**
	 * @param args
	 */
	public static void main(String[] args) {
		HelloServerDemo server = new HelloServerDemo();
		server.startServer();
	}
}

6）实现客户端Client

编码步骤：

• 创建Transport

• 创建TProtocol

• 基于TTransport和TProtocol创建 Client

• 调用Client的相应方法

 

java 代码：HelloClientDemo.java

package com.thrift.demo;

import org.apache.thrift.TException;
import org.apache.thrift.protocol.TBinaryProtocol;
import org.apache.thrift.protocol.TProtocol;
import org.apache.thrift.transport.TSocket;
import org.apache.thrift.transport.TTransport;
import org.apache.thrift.transport.TTransportException;

public class HelloClientDemo {
	public static final String SERVER_IP = "localhost";
	public static final int SERVER_PORT = 8090;
	public static final int TIMEOUT = 30000;

	/**
	 *
	 * @param userName
	 */
	public void startClient(String userName) {
		TTransport transport = null;
		try {
			transport = new TSocket(SERVER_IP, SERVER_PORT, TIMEOUT);
			// 协议要和服务端一致
			TProtocol protocol = new TBinaryProtocol(transport);
			// TProtocol protocol = new TCompactProtocol(transport);
			// TProtocol protocol = new TJSONProtocol(transport);
			HelloWorldService.Client client = new HelloWorldService.Client(protocol);
			transport.open();
			String result = client.sayHello(userName);
			System.out.println("Thrify client result =: " + result);
		} catch (TTransportException e) {
			e.printStackTrace();
		} catch (TException e) {
			e.printStackTrace();
		} finally {
			if (null != transport) {
				transport.close();
			}
		}
	}

	/**
	 * @param args
	 */
	public static void main(String[] args) {
		HelloClientDemo client = new HelloClientDemo();
		client.startClient("china");

	}

}

7）测试：先执行服务端main方法,在执行客户端main方法