thrift/thrift-build

Apache Thrift 镜像文档

镜像概述

Apache Thrift是一个轻量级、语言无关的软件栈，包含相关的RPC代码生成机制。该镜像提供Thrift的完整构建环境，支持数据传输、数据序列化及应用层处理的抽象，通过简单的定义语言生成跨编程语言的代码，构建可互操作的RPC客户端和服务器。Thrift特别设计用于支持客户端和服务器代码的非原子版本变更。

核心功能与特性

• 跨语言支持：支持C++、Go、Java、PHP、Python、Ruby等多种编程语言
• 代码生成机制：通过简单的定义语言输入，自动生成跨语言RPC代码
• 分层抽象：提供数据传输、数据序列化和应用层处理的清晰抽象
• 版本兼容性：支持客户端与服务器代码的非原子版本变更
• 完整工具链：包含编译器、语言库、测试用例和教程

目录结构

thrift/
  compiler/          # Thrift编译器，C++实现
  lib/               # Thrift软件库实现，按语言划分
    cpp/             # C++语言库
    go/              # Go语言库
    java/            # Java语言库
    php/             # PHP语言库
    py/              # Python语言库
    rb/              # Ruby语言库
  test/              # 跨语言测试文件和代码
  tutorial/          # Thrift开发教程

使用场景

• 构建跨语言的分布式系统
• 开发需要版本兼容的客户端-服务器架构
• 实现不同编程语言间的高效RPC通信
• 构建需要统一数据序列化格式的应用

构建与配置说明

前置要求

详见官方安装文档：[***]

构建步骤

1. 生成配置脚本（源码仓库首次构建时需要，tar包无需此步骤）：

   bash
   ./bootstrap.sh
   

2. 配置构建选项：

   bash
   ./configure
   

3. 指定Boost库路径（如Boost安装在/usr/local）：

   bash
   ./configure --with-boost=/usr/local
   

4. 自定义编译选项：

   bash
   # 设置C++编译选项
   ./configure CXXFLAGS='-g -O2'
   # 设置C编译选项
   ./configure CFLAGS='-g -O2'
   # 定义宏
   ./configure CPPFLAGS='-DDEBUG_MY_FEATURE'
   

5. 启用代码覆盖率：

   bash
   ./configure --enable-coverage
   

6. 查看所有配置选项：

   bash
   ./configure --help
   

7. 编译：

   bash
   make
   

8. 安装（需管理员权限）：

   bash
   make install
   

注意：部分语言包（如Java、Ruby、PHP）需通过对应语言的构建工具手动安装，详见lib/<language>/目录下的README.md。

测试方法

客户端库测试

运行所有客户端库测试：

bash
make -k check

该命令会构建所有必要库并执行各客户端库中的单元测试，单个语言测试失败时会继续执行并在结束时提供摘要。

跨语言测试套件

运行跨语言测试（不同语言的客户端和服务器交互测试）：

bash
make cross

资源与许可

许可协议

Apache License 2.0，详见：[***]

官方资源

• Thrift官网：[***]
• 设计文档：发行版中包含的Thrift白皮书
• 语言特定文档：各lib/<language>/目录下的README.md

鸣谢

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