Thrift 是一个轻量级、独立于语言的软件堆栈,用于点对点 RPC 实现。 Thrift 为数据传输、数据序列化和应用程序级处理提供了干净的抽象和实现。代码生成系统以简单的定义语言作为输入,生成跨编程语言的代码,使用抽象堆栈来构建可互操作的 RPC 客户端和服务器。
Thrift使得用不同编程语言编写的程序可以轻松地共享数据和调用远程过程。 Thrift 支持 28 种编程语言,因此很可能支持您当前使用的语言。
Thrift 专门设计用于支持跨客户端和服务器代码的非原子版本更改。这允许您升级服务器,同时仍然能够为旧客户端提供服务;或者让较新的客户端向较旧的服务器发出请求。社区提供的关于 API 版本控制时的 thrift 和兼容性的优秀文章可以在 Thrift Missing Guide 中找到。
有关 Thrift 设计和实现的更多详细信息,请参阅此发行版中包含的 Thrift 白皮书,或您感兴趣的特定子目录中的 README.md 文件。
分支 | 特拉维斯 | 应用程序 | 覆盖扫描 | Codecov.io | 网站 |
---|---|---|---|---|---|
master | |||||
0.17.0 |
Thrift 目前不维护具体的发布日历。
我们力争每年发布两次。下载当前版本。
根据一项或多项贡献者许可协议获得 Apache Software Foundation (ASF) 的许可。有关版权所有权的其他信息,请参阅随本作品分发的通知文件。 ASF 根据 Apache 许可证 2.0 版(“许可证”)向您授予此文件的许可;除非遵守许可证,否则您不得使用此文件。您可以在以下位置获取许可证副本:
http://www.apache.org/licenses/LICENSE-2.0
除非适用法律要求或书面同意,否则根据许可证分发的软件均按“原样”分发,不带任何明示或暗示的保证或条件。请参阅许可证,了解许可证下管理权限和限制的特定语言。
节约/
编译器/
Contains the Thrift compiler, implemented in C++.
库/
Contains the Thrift software library implementation, subdivided by
language of implementation.
cpp/
go/
java/
php/
py/
rb/
...
测试/
Contains sample Thrift files and test code across the target programming
languages.
教程/
Contains a basic tutorial that will teach you how to develop software
using Thrift.
要以与 Travis CI 构建项目相同的方式构建项目,您应该使用 docker。我们有全面的 docker 构建说明。
请参阅 http://thrift.apache.org/docs/install 以获取构建要求列表(可能已过时)。或者,请参阅 docker 构建环境以获取先决条件列表。
有关 Thrift 的更多信息可以在 Thrift 网页上获取:
http://thrift.apache.org
Thrift 的灵感来自于 Adam D'Angelo 编写的轻量级 RPC 工具 Pillar,以及 Google 的协议缓冲区。
如果您是第一次从源存储库构建,则需要生成配置脚本。 (如果您下载了 tarball,则无需执行此操作。)从顶级目录中,执行以下操作:
./bootstrap.sh
生成配置脚本后,就可以配置 thrift 了。从顶层目录中,执行以下操作:
./configure
您可能需要明确指定 boost 文件的位置。如果您在/usr/local
中安装了 boost,则可以按如下方式运行配置:
./configure --with-boost=/usr/local
请注意,默认情况下,thrift C++ 库通常是使用包含的调试符号构建的。如果您想自定义这些选项,您应该在配置中使用 CXXFLAGS 选项,如下所示:
./configure CXXFLAGS='-g -O2'
./configure CFLAGS='-g -O2'
./configure CPPFLAGS='-DDEBUG_MY_FEATURE'
要启用 gcov 所需的选项 -fprofile-arcs -ftest-coverage 启用它们:
./configure --enable-coverage
运行 ./configure --help 查看其他配置选项
请注意,Python 库将忽略 --prefix 选项,并仅安装在 Python 的 distutils 放置的位置(通常沿着/usr/lib/pythonX.Y/site-packages/
的行)。如果需要控制 Python 模块的安装位置,请设置 PY_PREFIX 变量。 (DESTDIR 受到 Python 和 C++ 的尊重。)
勤俭节约:
make
从顶层目录,成为超级用户并执行以下操作:
make install
卸载节俭:
make uninstall
请注意,某些语言包必须使用更适合这些语言的构建工具手动安装(在撰写本文时,这适用于 Java、Ruby、PHP)。
在 lib// 文件夹中查找 README.md 文件,了解有关每个语言库包安装的更多详细信息。
Apache Thrift 可通过许多包管理器获得,并且这个列表正在稳步增长。更详细的概述可以在 Apache Thrift 网站的“库”下和/或 /lib 下每种语言的相应自述文件中找到
有大量的客户端库测试都可以从顶级目录运行。
make -k check
这将创建所有库(根据需要),并运行每个客户端库中定义的单元测试。如果单一语言失败,make 检查将继续并在最后提供概要。
要运行跨语言测试套件,请运行:
make cross
这将运行一组使用不同语言客户端和服务器的测试。