thrift

C#源码 2025-08-16

apache thrift

介绍

thrift是用于点对点RPC实现的轻巧,独立于语言的软件堆栈。 thrift为数据传输,数据序列化和应用程序级别处理提供了干净的抽象和实现。代码生成系统将简单的定义语言作为输入,并在编程语言上生成代码,该语言使用抽象的堆栈来构建可互操作的RPC客户端和服务器。

thrift使用不同编程语言编写的程序轻松共享数据并调用远程过程。在支持28种编程语言的支持下, thrift可能性支持您当前使用的语言。

thrift专门设计用于支持客户端和服务器代码之间的非原子版本更改。这使您可以升级服务器,同时仍然能够为较旧的客户端服务;或让较新的客户向旧服务器发出请求。可以在thrift失踪指南”中找到有关thrift和兼容性的出色社区提供的文章。

有关thrift的设计和实施的更多详细信息,请参见此分发中包含的thrift白皮书,或在您的特定子目录中的readme.md文件中。

地位

分支 特拉维斯 应用程序 封面扫描 codecov.io 网站
master
0.17.0

发行

thrift目前不维护特定的发布日历。

我们努力每年两次发布。下载当前版本。

执照

根据一个或多个贡献者许可协议获得许可获得Apache软件基金会(ASF)。有关版权所有权的更多信息,请参见与此工作一起分发的通知文件。 ASF根据Apache许可证2.0版(“许可证”)将此文件许可给您;除了符合许可外,您不得使用此文件。您可以在

http://www.a*p*a*che.org/licenses/license-2.0

除非适用法律要求或以书面形式同意,否则根据许可证分配的软件是按照“原样”分发的,没有任何明示或暗示的保证或条件。请参阅许可证,以获取执行许可条款和限制的特定语言。

项目层次结构

thrift /

编译器/

 Contains the thrift compiler, implemented in C++.

lib/

thrift software library implementation, subdivided by language of implementation. cpp/ go/ java/ php/ py/ rb/ ...">
 Contains the thrift software library implementation, subdivided by
language of implementation.

cpp/
go/
java/
php/
py/
rb/
...

测试/

thrift files and test code across the target programming languages.">
 Contains sample thrift files and test code across the target programming
languages.

教程/

thrift.">
 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.*a*p*ache.org

致谢

thrift的灵感来自Pillar,这是Adam D'Angelo撰写的轻巧的RPC工具,也是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所需选项-Frofile -arcs -ftest -coverage启用它们:

 ./configure  --enable-coverage

运行./configure-----查看其他配置选项

请注意,Python库将忽略-prefix选项,只需在Python的Distutils放置的任何位置安装(通常沿/usr/lib/pythonX.Y/site-packages/ )即可。如果您需要控制Python模块的安装位置,请设置PY_PREFIX变量。 (python和C ++受到尊重。)

thrift :

 make

从顶级目录中,成为超级用户并做:

 make install

卸载thrift :

 make uninstall

请注意,某些语言软件包必须使用更适合这些语言的构建工具手动安装(在撰写本文时,这适用于Java,Ruby,PHP)。

在lib //文件夹中查找readme.md文件,以获取有关每个语言库软件包安装的更多详细信息。

包装经理

Apache thrift可通过许多软件包管理器获得,这一列表正在稳步增长。可以在“库”下的Apache Thrift网站和 /或每个语言下的“库”下的Apache thrift网站上找到更详细的概述。

测试

有大量的客户库测试可以从顶级目录运行。

 make -k check

这将使所有库(根据需要)使所有库,并贯穿每个客户端库中定义的单元测试。如果单语言失败,则进行检查将继续并在最后提供概要。

要运行跨语言测试套件,请运行:

 make cross

这将运行一组使用不同语言客户端和服务器的测试。

下载源码

通过命令行克隆项目:

git clone https://github.com/apache/thrift.git