爷的眼睛闪亮
insideDotNet En_summerGarden

Apache Thrift软件框架用于可扩展的跨语言服务开发,简单来说就是RPC远程调用,它是一个完整的 RPC 框架体系。 
Thrift支持的数据类型 
1.基本类型 
bool:布尔值 (true or false), one byte 
byte:有符号字节 
i16:16位有符号整型 
i32:32位有符号整型 
i64:64位有符号整型 
double:64位浮点型 
string:编码或者二进制的字符串

2.容器(Containers) 
Thrift容器与流行编程语言的容器类型相对应,采用Java泛型风格。它有3种可用容器类型: 
list: 元素类型为t1的有序表,容许元素重复。 
set:元素类型为t1的无序表,不容许元素重复。 
map

namespace java mythrift
enum HotelType {
   YILONG,
   JINJIANG=2
} 
struct Hotel {
  1:  optional i32 id;
  2:  optional string hotelname;
  3:  required HotelType HotelType.YILONG;
}

namespace(可省略):命名空间,一方面他可以解决名字冲突的问题,另一方面可以指定生成文件的路径及包名。 
required、optional:规范的struct定义中的每个域均会使用required或者optional关键字进行标识。如果required标识的域没有赋值,Thrift将给予提示;如果optional标识的域没有赋值,该域将不会被序列化传输。

引入依赖的thrift文件

include "***.thrift"

typedef ***.Hotel Hotel

struct Hotels{
    1: optional Hotel hotel;
    2: optional list<string> rooms;
}

include:引入thrift文件 * * *为thrit的文件名 
typedef:定义需要的结构体

服务类型 
规则 
继承类必须实现这些方法 
参数可以是基本类型或者结构体 
返回值可以是void 
服务支持继承,一个service可使用extends关键字继承另一个service 
服务不支持重载

namespace java wu.thrift.service

include "result.thrift"

typedef result.TResult TResult

service TResultService{
    TResult getResponse(1:string code);
}

代码实例: 
两份thrift文件

namespace java wu.thrift.bean
struct TResult{
    1: optional string code;
    2: optional string describe;
}
namespace java wu.thrift.service

include "result.thrift"

typedef result.TResult TResult

service TResultService{
    TResult getResponse(1:string code);
}

我用的是maven引入的jar 
我分了两个项目,一个是服务端项目,另一个是客户端项目。

<dependency>
    <groupId>org.apache.thrift</groupId>
    <artifactId>libthrift</artifactId>
    <version>0.10.0</version>
</dependency>

服务端:

package wu.thrift.handleService;

import org.apache.thrift.TException;

import wu.thrift.bean.TResult;
import wu.thrift.service.TResultService;

public class HandleService implements TResultService.Iface{

    public TResult getResponse(String code) throws TException {
        TResult result=new TResult();
        result.setCode(code);
        result.setDescribe("成功");
        return result;
    }

}

上面的代码是写在服务端项目里的一个业务处理类,它需要实现thrift service类下的一个内部接口类Iface。

package wu.thrift.server;

import org.apache.thrift.TProcessor;
import org.apache.thrift.server.TServer;
import org.apache.thrift.server.TServer.Args;
import org.apache.thrift.server.TSimpleServer;
import org.apache.thrift.transport.TServerSocket;
import org.apache.thrift.transport.TServerTransport;

import wu.thrift.handleService.HandleService;
import wu.thrift.service.TResultService;

public class ThriftServer {
    public static void main(String[] args) {
        try {
            TServerTransport serverTransport = new TServerSocket(9090);
            //定义一个TProcess处理类,创建TProcess对象
            TProcessor processor = new TResultService.Processor<HandleService>(new HandleService());
            //定义一个TServer传输对象,用于tcp的socket通信
            TServer server = new TSimpleServer(new Args(serverTransport).processor(processor));
            System.out.println("Starting the simple server...");
            //启动服务
            server.serve();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

上面的代码是写在服务端项目里的一个服务启动类,里面的一些类的作用可以参考下面server实现描述。

客户端:

package wu.thrift.client;

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;

import wu.thrift.bean.TResult;
import wu.thrift.service.TResultService;

public class ThriftClient {
    public static void main(String[] args) {
        try { 
               // 创建一个传输层对象(TTransport),设置调用的服务地址为本地,端口为 9090,TSocket传输方式
               TTransport transport = new TSocket("localhost", 9090);
               //打开socket,建立与服务器直接的socket连接 
               transport.open(); 
               // 创建通信协议对象(TProtocol),设置传输协议为 TBinaryProtocol 
               TProtocol protocol = new TBinaryProtocol(transport); 
               //创建一个Thrift客户端对象
               TResultService.Client client = new TResultService.Client(protocol); 
               // 调用服务的 getResponse 方法
               TResult result=client.getResponse("001"); 
               System.out.println(result.toString());
               transport.close(); 
           } catch (TTransportException e) { 
               e.printStackTrace(); 
           } catch (TException e) { 
               e.printStackTrace(); 
           } 
    }
}

上面的代码是写在客户端项目里的一个服务启动类,里面的一些类的作用同样可以参考下面客户端编写实现描述。

其实,我为了清晰我选择了分为两个项目(服务端和客户端),其实应该可以分成三个项目,一个服务端项目,一个客户端项目,另外一个thrift实体类项目,然后前面两个项目分别依赖于实体类项目。

客户端编写 
传输方式: 
1. TSocket:阻塞型 socket,用于客户端,采用系统函数 read 和 write 进行读写数据。 
2. TServerSocket:非阻塞型 socket,用于服务器端,accecpt 到的 socket 类型都是 TSocket(即阻塞型 socket)。 
3. TBufferedTransport 和 TFramedTransport 都是有缓存的,均继承TBufferBase,调用下一层 TTransport 类进行读写操作吗,结构极为相似。其中 TFramedTransport 以帧为传输单位,帧结构为:4个字节(int32_t)+传输字节串,头4个字节是存储后面字节串的长度,该字节串才是正确需要传输的数据,因此 TFramedTransport 每传一帧要比 TBufferedTransport 和 TSocket 多传4个字节。 
4. TMemoryBuffer 继承 TBufferBase,用于程序内部通信用,不涉及任何网络I/O,可用于三种模式: 
(1)OBSERVE模式,不可写数据到缓存; 
(2)TAKE_OWNERSHIP模式,需负责释放缓存; 
(3)COPY模式,拷贝外面的内存块到TMemoryBuffer。 
5. TFileTransport 直接继承 TTransport,用于写数据到文件。对事件的形式写数据,主线程负责将事件入列,写线程将事件入列,并将事件里的数据写入磁盘。这里面用到了两个队列,类型为 TFileTransportBuffer,一个用于主线程写事件,另一个用于写线程读事件,这就避免了线程竞争。在读完队列事件后,就会进行队列交换,由于由两个指针指向这两个队列,交换只要交换指针即可。它还支持以 chunk(块)的形式写数据到文件。 
6. TFDTransport 是非常简单地写数据到文件和从文件读数据,它的 write 和 read 函数都是直接调用系统函数 write 和 read 进行写和读文件。 
7. TSimpleFileTransport 直接继承 TFDTransport,没有添加任何成员函数和成员变量,不同的是构造函数的参数和在 TSimpleFileTransport 构造函数里对父类进行了初始化(打开指定文件并将fd传给父类和设置父类的close_policy为CLOSE_ON_DESTROY)。 
8. TZlibTransport 跟 TBufferedTransport 和 TFramedTransport一样,调用下一层 TTransport 类进行读写操作。它采用提供的 zlib 压缩和解压缩库函数来进行压解缩,写时先压缩再调用底层 TTransport 类发送数据,读时先调用 TTransport 类接收数据再进行解压,最后供上层处理。 
9. TSSLSocket 继承 TSocket,阻塞型 socket,用于客户端。采用 openssl 的接口进行读写数据。checkHandshake()函数调用 SSL_set_fd 将 fd 和 ssl 绑定在一起,之后就可以通过 ssl 的 SSL_read和SSL_write 接口进行读写网络数据。 
10. TSSLServerSocket 继承 TServerSocket,非阻塞型 socket, 用于服务器端。accecpt 到的 socket 类型都是 TSSLSocket 类型。 
11. THttpClient 和 THttpServer 是基于 Http1.1 协议的继承 Transport 类型,均继承 THttpTransport,其中 THttpClient 用于客户端,THttpServer 用于服务器端。两者都调用下一层 TTransport 类进行读写操作,均用到TMemoryBuffer 作为读写缓存,只有调用 flush() 函数才会将真正调用网络 I/O 接口发送数据。

传输协议: 
Thrift 传输协议上总体可划分为文本 (text) 和二进制 (binary) 传输协议两大类,一般在生产环境中使用二进制类型的传输协议为多数。 
TBinaryProtocol:是Thrift的默认协议,使用二进制编码格式进行数据传输,基本上直接发送原始数据 
TCompactProtocol:压缩的、密集的数据传输协议,基于Variable-length quantity的zigzag 编码格式 
TJSONProtocol:以JSON (JavaScript Object Notation)数据编码协议进行数据传输 
TDebugProtocol:常常用以编码人员测试,以文本的形式展现方便阅读

服务端编写: 
包含三个主要的组件:protocol,transport 和 server。 
其中,protocol 定义了消息是怎样序列化的;transport 定义了消息是怎样在客户端和服务器端之间通信的;server 用于从 transport 接收序列化的消息,根据 protocol 反序列化之,调用用户定义的消息处理器,并序列化消息处理器的响应,然后再将它们写回 transport。

server 实现: 
TSimpleServer 
TNonblockingServer 
THsHaServer 
TThreadedSelectorServer 
TThreadPoolServer 
对于这几个的区别从名字也可以看的出来几个的区别 
这边不多加赘述,可以参考下面这篇文章 
https://github.com/m1ch1/mapkeeper/wiki/Thrift-Java-Servers-Compared

一般来说,TThreadedSelectorServer 对大多数案例来说都是个安全之选。如果你的系统资源允许运行大量并发线程的话,建议你使用 TThreadPoolServer。

posted on 2018-05-16 11:38  爷的眼睛闪亮  阅读(1476)  评论(0编辑  收藏  举报