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…



相关文章
|
15天前
|
JSON Java Apache
非常实用的Http应用框架,杜绝Java Http 接口对接繁琐编程
UniHttp 是一个声明式的 HTTP 接口对接框架,帮助开发者快速对接第三方 HTTP 接口。通过 @HttpApi 注解定义接口,使用 @GetHttpInterface 和 @PostHttpInterface 等注解配置请求方法和参数。支持自定义代理逻辑、全局请求参数、错误处理和连接池配置,提高代码的内聚性和可读性。
|
24天前
|
人工智能 前端开发 Java
基于开源框架Spring AI Alibaba快速构建Java应用
本文旨在帮助开发者快速掌握并应用 Spring AI Alibaba,提升基于 Java 的大模型应用开发效率和安全性。
基于开源框架Spring AI Alibaba快速构建Java应用
|
24天前
|
消息中间件 Java 数据库连接
Java 反射最全详解 ,框架设计必掌握!
本文详细解析Java反射机制,包括反射的概念、用途、实现原理及应用场景。关注【mikechen的互联网架构】,10年+BAT架构经验倾囊相授。
Java 反射最全详解 ,框架设计必掌握!
|
1月前
|
前端开发 Java 数据库连接
Spring 框架:Java 开发者的春天
Spring 框架是一个功能强大的开源框架,主要用于简化 Java 企业级应用的开发,由被称为“Spring 之父”的 Rod Johnson 于 2002 年提出并创立,并由Pivotal团队维护。
50 1
Spring 框架:Java 开发者的春天
|
25天前
|
自然语言处理 负载均衡 API
gRPC 一种现代、开源、高性能的远程过程调用 (RPC) 可以在任何地方运行的框架
gRPC 是一种现代开源高性能远程过程调用(RPC)框架,支持多种编程语言,可在任何环境中运行。它通过高效的连接方式,支持负载平衡、跟踪、健康检查和身份验证,适用于微服务架构、移动设备和浏览器客户端连接后端服务等场景。gRPC 使用 Protocol Buffers 作为接口定义语言,支持四种服务方法:一元 RPC、服务器流式处理、客户端流式处理和双向流式处理。
|
30天前
|
SQL Java 关系型数据库
java连接mysql查询数据(基础版,无框架)
【10月更文挑战第12天】该示例展示了如何使用Java通过JDBC连接MySQL数据库并查询数据。首先在项目中引入`mysql-connector-java`依赖,然后通过`JdbcUtil`类中的`main`方法实现数据库连接、执行SQL查询及结果处理,最后关闭相关资源。
|
26天前
|
缓存 Java 数据库连接
Hibernate:Java持久层框架的高效应用
通过上述步骤,可以在Java项目中高效应用Hibernate框架,实现对关系数据库的透明持久化管理。Hibernate提供的强大功能和灵活配置,使得开发者能够专注于业务逻辑的实现,而不必过多关注底层数据库操作。
13 1
|
1月前
|
Java 数据库连接 开发者
Spring 框架:Java 开发者的春天
【10月更文挑战第27天】Spring 框架由 Rod Johnson 在 2002 年创建,旨在解决 Java 企业级开发中的复杂性问题。它通过控制反转(IOC)和面向切面的编程(AOP)等核心机制,提供了轻量级的容器和丰富的功能,支持 Web 开发、数据访问等领域,显著提高了开发效率和应用的可维护性。Spring 拥有强大的社区支持和丰富的生态系统,是 Java 开发不可或缺的工具。
|
1月前
|
安全 Java 程序员
深入Java集合框架:解密List的Fail-Fast与Fail-Safe机制
本文介绍了 Java 中 List 的遍历和删除操作,重点讨论了快速失败(fail-fast)和安全失败(fail-safe)机制。通过普通 for 循环、迭代器和 foreach 循环的对比,详细解释了各种方法的优缺点及适用场景,特别是在多线程环境下的表现。最后推荐了适合高并发场景的 fail-safe 容器,如 CopyOnWriteArrayList 和 ConcurrentHashMap。
58 5
|
19天前
|
存储 Java 开发者
Java中的集合框架深入解析
【10月更文挑战第32天】本文旨在为读者揭开Java集合框架的神秘面纱,通过深入浅出的方式介绍其内部结构与运作机制。我们将从集合框架的设计哲学出发,探讨其如何影响我们的编程实践,并配以代码示例,展示如何在真实场景中应用这些知识。无论你是Java新手还是资深开发者,这篇文章都将为你提供新的视角和实用技巧。
18 0
下一篇
无影云桌面