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)                       |
+-------------------------------------------+
复制代码

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

网络异常,图片无法展示
|


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版本:

网络异常,图片无法展示
|


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

网络异常,图片无法展示
|


4 Go使用thrift

4.1 项目结构和依赖安装

网络异常,图片无法展示
|


依赖安装:

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 验证

网络异常,图片无法展示
|


5 Java使用thrift

5.1 项目结构和依赖

网络异常,图片无法展示
|


依赖:

<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…



相关文章
|
1月前
|
存储 安全 Java
Java 程序员极速上手 go
Java 程序员极速上手 go
30 0
|
1月前
|
Java 程序员 Linux
IT圈的“鄙视链”大揭秘:从Java到Go,编程语言之战!
IT圈的“鄙视链”大揭秘:从Java到Go,编程语言之战!
|
2月前
|
中间件 Go 数据库
Go开发者必读:Gin框架的实战技巧与最佳实践
在当今快速发展的互联网时代,Web开发的需求日益增长。Go语言以其简洁、高效、并发性强的特点,成为了开发者们的首选。而在Go语言的众多Web框架中,Gin无疑是其中的佼佼者。本文将深入探讨Gin框架的特性、优势以及如何利用Gin构建高性能的Web应用。
|
6天前
|
前端开发 Java Go
开发语言详解(python、java、Go(Golong)。。。。)
开发语言详解(python、java、Go(Golong)。。。。)
|
22天前
|
JSON 缓存 物联网
推荐一款go语言的开源物联网框架-opengw
推荐一款go语言的开源物联网框架-opengw
33 4
|
1月前
|
开发框架 JSON Go
Go语言Web开发基础与框架探索
【2月更文挑战第21天】本文将带领读者深入了解Go语言在Web开发领域的基础知识和常用框架。通过介绍Go语言的Web开发特点、核心库的使用,以及流行框架如Gin、Echo等的基本用法和优势,帮助读者快速上手Go语言Web开发,提升开发效率。
|
1月前
|
关系型数据库 MySQL 数据库连接
实战演练:使用Go语言和ORM框架与数据库进行交互
【2月更文挑战第13天】本文将通过一个实战演练,展示如何使用Go语言和ORM(对象关系映射)框架与数据库进行交互。我们将选择一个流行的ORM框架,如GORM,来完成这个任务。通过实际编码,我们将演示如何连接数据库、执行CRUD操作、处理错误和异常,并展示ORM框架如何简化数据库操作过程。
|
1月前
|
SQL 关系型数据库 MySQL
Go语言中的ORM框架介绍
【2月更文挑战第13天】本文将介绍ORM(对象关系映射)框架在Go语言中的应用。ORM框架能够简化数据库操作,将数据库表映射为Go结构体,并提供了一系列方法来执行CRUD(创建、读取、更新、删除)操作。我们将探讨几个流行的Go语言ORM框架,包括GORM、SQLBoiler和Squirrel,并比较它们的特性和用法。
|
2月前
|
XML JSON Java
RPC框架之Thrift—实现Go和Java远程过程调用
RPC框架之Thrift—实现Go和Java远程过程调用
46 1
|
3月前
|
关系型数据库 MySQL Go
go语言使用Gin框架链接数据库
go语言使用Gin框架链接数据库
41 0