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
这将运行一组使用不同语言客户端和服务器的测试。
