cjmay/thrift

Apache Thrift 镜像文档

概述

Apache Thrift是一个轻量级、语言无关的软件栈，附带用于RPC（远程过程调用）的代码生成机制。它为数据传输、数据序列化和应用层处理提供清晰的抽象，通过简单的定义语言作为输入，生成跨编程语言的代码，以构建可互操作的RPC客户端和服务器。Thrift特别设计用于支持客户端和服务器代码的非原子版本变更。

核心功能与特性

• 语言无关性：支持多种编程语言（C++、Go、Java、PHP、Python、Ruby等）的代码生成与交互
• 代码生成机制：通过简单的定义语言生成跨语言的RPC客户端和服务器代码
• 抽象层设计：提供数据传输、序列化和应用层处理的清晰抽象
• 版本兼容性：支持客户端与服务器代码的非原子版本变更，确保系统升级时的兼容性
• 多语言库支持：针对不同编程语言提供对应的Thrift库实现

目录结构

thrift/
  compiler/          # Thrift编译器（C++实现）
  lib/               # Thrift软件库实现，按语言划分
    cpp/             # C++语言库
    go/              # Go语言库
    java/            # Java语言库
    php/             # PHP语言库
    py/              # Python语言库
    rb/              # Ruby语言库
  test/              # 跨语言的示例Thrift文件和测试代码
  tutorial/          # 基础教程，指导如何使用Thrift开发软件

使用场景

• 构建跨语言的分布式系统
• 微服务架构中的服务间通信
• 需要不同编程语言组件交互的应用开发
• 对版本兼容性有要求的RPC系统设计

安装与使用

前置要求

详细构建要求请参考官方文档：[***]

Docker镜像使用方法

基本使用（运行Thrift编译器）

bash
# 生成Python语言代码
docker run -v $(pwd):/app thrift:latest thrift --gen py /app/example.thrift

# 生成Java语言代码
docker run -v $(pwd):/app thrift:latest thrift --gen java /app/example.thrift

自定义配置构建

如需指定Boost库位置或编译选项：

bash
vironment variables

docker run -v $(pwd):/app thrift:latest sh -c "./configure --with-boost=/usr/local && make && make install"

运行测试

bash
# 运行客户端库测试
docker run thrift:latest make -k check

# 运行跨语言测试套件
docker run thrift:latest make cross

配置选项

• --with-boost=<path>: 指定Boost库路径
• CXXFLAGS/CFLAGS/CPPFLAGS: 自定义C++/C编译器选项（如-g -O2启用调试符号和优化）
• --enable-coverage: 启用gcov覆盖率测试（需添加-fprofile-arcs -ftest-coverage编译选项）

语言库安装说明

部分语言库库需通过对应语言的构建工具手动安装（如Java、Ruby、PHP），具体请参考lib/<language>/目录下的README.md文件。

许可证

本软件基于Apache License 2.0许可发布。详情请参见：[***]

资源与更多信息

• 官方网站：[***]
• 设计与实现详情：分发版中包含的Thrift白皮书或各子目录下的README.md文件

鸣谢

Thrift的设计受到Adam D'Angelo开发的轻量级RPC工具pillar以及Google的Protocol Buffers的启发。