Skip to content
Facebook's branch of Apache Thrift, including a new C++ server.
Branch: master
Clone or download
svcscm and facebook-github-bot Updating submodules
Reviewed By: cdelahousse

fbshipit-source-id: a727513842c0a240b377bda4e313fbedbc54c2e8
Latest commit 2e3a85e Apr 19, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
build Updating submodules Apr 19, 2019
thrift Remove getSelfCert and getPeerCert apis Apr 19, 2019
.gitignore Re-add *.pyc to .gitignore Jan 13, 2017
.travis.yml Travis split out docker ipv6 enable (#1108) Apr 12, 2019
CMakeLists.txt
CODE_OF_CONDUCT.md Adding Code of Conduct file (#331) Apr 1, 2019
CONTRIBUTING.md Update URL Oct 27, 2017
LICENSE Initial import Feb 20, 2014
README.md Clean up the Building section of README Mar 23, 2019
ThriftLibrary.cmake Indent implementations within ThriftLibrary CMake Macros Mar 13, 2019

README.md

Facebook Thrift Build Status

Thrift is a serialization and RPC framework for service communication. Thrift enables these features in all major languages, and there is strong support for C++, Python, Hack, and Java. Most services at Facebook are written using Thrift for RPC, and some storage systems use Thrift for serializing records on disk.

Facebook Thrift is not a distribution of Apache Thrift. This is an evolved internal branch of Thrift that Facebook re-released to open source community in February 2014. Facebook Thrift was originally released closely tracking Apache Thrift but is now evolving in new directions. In particular, the compiler was rewritten from scratch and the new implementation features a fully asynchronous Thrift server. Read more about these improvements in the ThriftServer documentation.

You can also learn more about this project in the original Facebook Code blog post.

Table of Contents (ToC):

About Thrift

At a high level, Thrift is three major things:

A Code Generator

Thrift has a code generator which generates data structures that can be serialized using Thrift, and client and server stubs for RPC, in different languages.

A Serialization Framework

Thrift has a set of protocols for serialization that may be used in different languages to serialize the generated structures created from the code generator.

An RPC Framework

Thrift has a framework to frame messages to send between clients and servers, and to call application-defined functions when receiving messages in different languages.

There are several key goals for these components:

  • Ease of use: Thrift takes care of the boilerplate of serialization and RPC, and enables the developer to focus on the schema of the system's serializable types and on the interfaces of system's RPC services.

  • Cross language support: Thrift enables intercommunication between different languages. For example, a Python client communicating with a C++ server.

  • Performance: Thrift structures and services enable fast serialization and deserialization, and its RPC protocol and frameworks are designed with performance as a feature.

  • Backwards compatibility: Thrift allows fields to be added to and removed from serializable types in a manner that preserves backward and forward compatibility.


Building

Dependencies

Please install the following dependencies before building Facebook Thrift:

System: Bison 3.1 or later, Boost, CMake, Flex, OpenSSLv1.0.2g, PThreads, Zlib

External: Double Conversion, GFlags, GLog, Mstch

Facebook: Fizz, Folly, Wangle, Zstd

Build

git clone https://github.com/facebook/fbthrift
cd build
cmake .. # Add -DOPENSSL_ROOT_DIR for macOS. Usually in /usr/local/ssl
make # or cmake --build .

This will create:

  • thrift/bin/thrift1: The Thrift compiler binary to generate client and server code.
  • thrift/lib/libthriftcpp2.so: Runtime library for clients and servers.

Thrift Files

When using thrift and the CMake build system, include: ThriftLibrary.cmake in your project. This includes the following macro to help building Thrift files:

thrift_library(
  #file_name
  #services
  #language
  #options
  #file_path
  #output_path
)

This generates a library called file_name-<language>. That is, for Test.thrift compiled as cpp2, it will generate the library Test-cpp2. This should be added as a dependency to any source or header file that contains an include to generated code.


C++ Static Reflection

Information regarding C++ Static Reflection support can be found under the static reflection library directory, in the corresponding README file.


You can’t perform that action at this time.