RPC框架之Thrift—实现Go和Java远程过程调用

简介: RPC框架之Thrift—实现Go和Java远程过程调用
+关注继续查看

1 概览

+-------------------------------------------+
| Server                                    |
| (single-threaded, event-driven etc)       |
+-------------------------------------------+
| Processor                                 |
| (compiler generated)                      |
+-------------------------------------------+
| Protocol                                  |
| (JSON, compact etc)                       |
+-------------------------------------------+
| Transport                                 |
| (raw TCP, HTTP etc)                       |
+-------------------------------------------+
复制代码

我们把他换成自己容易理解的方式:

image


2 分层解析

2.1 Transport(传输层)

传输层为网络的读写提供了一个简单的抽象。这使得Thrift能够将底层传输与系统的其他部分解耦(例如,序列化/反序列化)。

接口支持的方法:

  • open
  • close
  • read
  • write
  • flush

可传输的底层协议:

  • 文件传输(I/O)
  • HTTP

2.2 Protocol(协议层)

协议层抽象定义了一种机制来将内存中的数据结构映射到连线格式。换句话说,协议指定数据类型如何使用底层的Transport对自己进行编码/解码。因此,协议实现控制编码方案并负责(反)序列化。这种意义上的协议的一些例子包括JSON、XML、纯文本、压缩二进制文件等。

接口支持的方法:

写(编码)方法:

  • writeMessageBegin(name, type, seq)
  • writeMessageEnd()
  • writeStructBegin(name)
  • writeStructEnd()
  • writeFieldBegin(name, type, id)
  • writeFieldEnd()
  • writeFieldStop()
  • writeMapBegin(ktype, vtype, size)
  • writeMapEnd()
  • writeListBegin(etype, size)
  • writeListEnd()
  • writeSetBegin(etype, size)
  • writeSetEnd()
  • writeBool(bool)
  • writeByte(byte)
  • writeI16(i16)
  • writeI32(i32)
  • writeI64(i64)
  • writeDouble(double)
  • writeString(string)

读(解码)方法:

  • name, type, seq = readMessageBegin()
    readMessageEnd()
  • name = readStructBegin()
    readStructEnd()
  • name, type, id = readFieldBegin()
    readFieldEnd()
  • k, v, size = readMapBegin()
    readMapEnd()
  • etype, size = readListBegin()
    readListEnd()
  • etype, size = readSetBegin()
    readSetEnd()
  • bool = readBool()
  • byte = readByte()
  • i16 = readI16()
  • i32 = readI32()
  • i64 = readI64()
  • double = readDouble()
  • string = readString()

支持的编码协议:

  • 二进制
  • compact
  • json

2.3 Processor(处理器层)

处理器封装了从输入流读取数据和向输出流写入数据的能力。输入和输出流由Protocol对象表示。

接口方法样例:

interface TProcessor {
    bool process(TProtocol in, TProtocol out) throws TException
}
复制代码

2.4 Server(应用服务层)

一个服务器集合了上面描述的所有不同的特性:

  • 创建一个运输
  • 为传输创建输入/输出协议
  • 创建基于输入/输出协议的处理器
  • 等待传入的连接,并将它们交给处理器

3 thrift安装

下载页:thrift.apache.org/download

下载Windows版本:

image


下载后可以直接使用,或者放在固定文件设置环境变量

image


4 Go使用thrift

4.1 项目结构和依赖安装

image


依赖安装:

go get -u github.com/apache/thrift
复制代码

4.2 编写thrift文件并编译

namespace go hello
struct HelloReq {
    1: string msg;
}
struct HelloResp {
    1: string msg;
}
service HelloService {
    //返回值类型 方法名(参数序号:参数类型 参数名);
    HelloResp Hello(1: HelloReq req);
}
复制代码

编译:

thrift -r --gen go hello.thrift
复制代码

4.3 服务端代码

type HelloServiceImpl struct {
}
func (e *HelloServiceImpl) Hello(ctx context.Context, req *hello.HelloReq) (*hello.HelloResp, error) {
   fmt.Printf("message from client: %v\n", req.GetMsg())
   res := &hello.HelloResp{
      Msg: "Hi Client ~",
   }
   return res, nil
}
func main() {
    transport, err := thrift.NewTServerSocket(":9898")
    if err != nil {
        panic(err)
    }
    handler := &HelloServiceImpl{}
    processor := hello.NewHelloServiceProcessor(handler)
    //也可以选择Framed传输协议,但是必须确保服务端和客户端的传输协议一致
    transportFactory := thrift.NewTBufferedTransportFactory(1024)
    //应对Java客户端
    //factory := thrift.NewTFramedTransportFactory(thrift.NewTTransportFactory())
    //可以选择任意一种编码协议,但是必须确保服务端和客户端的编码协议一致
    protocolFactory := thrift.NewTBinaryProtocolFactoryConf(&thrift.TConfiguration{}) //布尔参数strictRead, strictWrite,读和写时是否加入版本校验。
    server := thrift.NewTSimpleServer4(
        processor,
        transport,
        transportFactory,
        //factory,
        protocolFactory,
    )
    if err := server.Serve(); err != nil {
        panic(err)
    }
}
复制代码

4.4 客户端代码

func main() {
    transportFactory := thrift.NewTBufferedTransportFactory(1024)
    //可以选择任意一种通信协议,但是必须确保服务端和客户端的通信协议一致
    protocolFactory := thrift.NewTBinaryProtocolFactoryConf(&thrift.TConfiguration{}) //布尔参数strictRead, strictWrite,读和写时是否加入版本校验。
    //Java服务端
    //factory := thrift.NewTCompactProtocolFactoryConf(&thrift.TConfiguration{})
    transport:= thrift.NewTSocketConf("127.0.0.1:9898",&thrift.TConfiguration{})
    useTransport, err := transportFactory.GetTransport(transport)
    client := hello.NewHelloServiceClientFactory(useTransport, protocolFactory)
    if err := transport.Open(); err != nil {
        fmt.Fprintln(os.Stderr, "Error opening socket to 127.0.0.1:9898", " ", err)
        os.Exit(1)
    }
    defer transport.Close()
    req := &hello.HelloReq{Msg: "Hello Server ~"}
    res, err := client.Hello(context.Background(), req)
    if err != nil {
        log.Println("Echo failed:", err)
        return
    }
    log.Println("response:", res.Msg)
}
复制代码

4.5 验证

image


5 Java使用thrift

5.1 项目结构和依赖

image


依赖:

<dependency>
    <groupId>org.apache.thrift</groupId>
    <artifactId>libthrift</artifactId>
    <version>0.15.0</version>
</dependency>
复制代码

5.2 编写thrift文件并编译

namespace java hello
struct HelloReq {
    1: string msg;
}
struct HelloResp {
    1: string msg;
}
service HelloService {
    HelloResp Hello(1: HelloReq req);
}
复制代码

编译:

thrift -r --gen java hello.thrift
复制代码

注意:编译完成之后需要将生成的.java文件放到项目结构中的对应位置。

5.3 服务端代码

public class ThriftServer {
    public static void main(String[] args) throws TTransportException {
        //设置服务器端口  TNonblockingServerSocket-非堵塞服务模型
        TNonblockingServerSocket serverSocket = new TNonblockingServerSocket(8899);
        //参数设置
        THsHaServer.Args arg = new THsHaServer.Args(serverSocket).minWorkerThreads(2).maxWorkerThreads(4);
        //处理器
        //PersonService.Processor<PersonServiceImpl> processor = new PersonService.Processor<>(new PersonServiceImpl());
        HelloService.Processor<HelloServiceImpl> processor = new HelloService.Processor<>(new HelloServiceImpl());
        arg.protocolFactory(new TCompactProtocol.Factory());
        arg.transportFactory(new TFramedTransport.Factory());
        arg.processorFactory(new TProcessorFactory(processor));
        TServer server = new THsHaServer(arg);
        System.out.println("Thrift 服务端启动成功");
        server.serve();
    }
}
//Handler
class HelloServiceImpl implements HelloService.Iface {
    @Override
    public HelloResp Hello(HelloReq req) throws TException {
        System.out.println(req.msg);
        return new HelloResp("Hello Client ~");
    }
}
复制代码

5.4 客户端代码

public class ThriftClient {
    public static void main(String[] args) throws TException {
        TTransport transport = new TFramedTransport(new TSocket("localhost", 8899), 600);
        TProtocol protocol = new TCompactProtocol(transport);
        HelloService.Client client = new HelloService.Client(protocol);
        transport.open();
        String msg = client.Hello(new HelloReq("Hi Server ~")).msg;
        System.out.println(msg);
        transport.close();
    }
}
复制代码

6 使用thrift进行Java和Go的远程通信

  • 原则:客户端与服务端的协议一致即可

例如Java做客户端:

public class ThriftClientGo {
    public static void main(String[] args) throws TTransportException {
        TTransport transport = new TFramedTransport(new TSocket("127.0.0.1", 9898), 8000);
        TBinaryProtocol binaryProtocol = new TBinaryProtocol(transport);
        HelloService.Client client = new HelloService.Client(binaryProtocol);
        try {
            transport.open();
            String msg = client.Hello(new HelloReq("Hi Server~")).msg;
            System.out.println(msg);
        }catch (Exception ex){
            throw new RuntimeException(ex.getMessage(),ex);
        }finally {
            transport.close();
        }
    }
}
复制代码

参考文章:

thrift.apache.org/docs/concep…

thrift.apache.org/docs/concep…

blog.csdn.net/pengpengzho…



相关文章
|
12天前
|
存储 JSON Go
Go 命令行框架: 构建强大的命令行工具
Go 命令行框架: 构建强大的命令行工具
|
2月前
|
缓存 前端开发 中间件
Go 框架 Gin 怎么实现允许前端跨域请求?
Go 框架 Gin 怎么实现允许前端跨域请求?
11 0
|
2月前
|
JSON 中间件 Go
Go语言学习 - RPC篇:gin框架的基础能力剖析
gin是非常流行的一款HTTP框架。相较于原生的HTTP server,gin有很多改进点,主要在于3点: 1. 上手简单,开发思路与原生HTTP基本一致 2. 引入多个工具库,提高了开发效率 3. 生态丰富,有许多开源的组件 围绕着gin框架,我们将展开今天的话题。
74 2
Go语言学习 - RPC篇:gin框架的基础能力剖析
|
2月前
|
缓存 中间件 Go
Go 语言有哪些流行的框架和库
Go 语言有哪些流行的框架和库
40 0
|
2月前
|
JSON 中间件 Go
Go Gin 框架系列 - 入门篇
本文将会对 Go Gin 框架进行简单介绍,括它的一些优势和特点,然后通过一个入门示例,演示了如何安装和使用 Gin 启动一个 WEB 服务器并注册路由。
41 1
Go Gin 框架系列 - 入门篇
|
3月前
|
JSON 编解码 中间件
Go 框架三件套详解(Web/RPC/ORM)
Go 框架三件套详解(Web/RPC/ORM)
197 0
|
4月前
|
开发框架 前端开发 Linux
Go语言实战框架,GoFly全栈开发社区的Go快速开发框架简介与阿里服务器部署说明
GoFly中后台框架永久开源可商用。api文档管理并一键生成api接口代码,一键生成 CRUD前后端代码, GoFly快速开发框架是一款基于Go语言的 Gin和 Vue3的Arco Design的快速后台开发框架,基于JWT接口验证和Auth验证的权限管理系统,附件管理系统,天生支持saas架构。可打包部署在阿里云Linux系统上。
300 1
|
6月前
|
JSON 中间件 Go
给Go的Gin web框架增加 WebSocket 功能,让WebSocket 更好用
给Go的Gin web框架增加 WebSocket 功能,让WebSocket 更好用
|
6月前
|
SQL 关系型数据库 MySQL
Go 语言流行 ORM 框架 GORM 使用介绍
Go 语言流行 ORM 框架 GORM 使用介绍
256 0
|
6月前
|
Kubernetes Unix Shell
Go 语言现代命令行框架 Cobra 详解
Go 语言现代命令行框架 Cobra 详解
446 0
相关产品
云迁移中心
推荐文章
更多