最近做的一个项目,后端服务是c++写的,因所有参与这个项目的同事除了me之外,他们都不会c/c++语言。没有办法,我就承担了这个有意思的任务。下面通过实战例子,来剖析thrift的应用。
目录:
1.thrift是干什么用的?
2.thrift语法?
3.实战例子
3.1 环境
3.2 安装
3.3 实战例子
4.小结
1.Thrift是干什么用的?
Thrift是一个软件框架,用来进行可扩展且跨语言的服务的开发。它结合了功能强大的软件堆栈和代码生成引擎,以构建在 C++, Java, Python, PHP, Ruby, Erlang, Perl, Haskell, C#, Cocoa, JavaScript, Node.js, Smalltalk, and OCaml 这些编程语言间无缝结合的、高效的服务。Thrift最初由facebook开发,07年四月开放源码,08年5月进入apache孵化器。Thrift允许你定义一个简单的定义文件中的数据类型和服务接口,以作为输入文件,编译器生成代码用来方便地生成RPC客户端和服务器通信的无缝跨编程语言。
2.Thrift语法
请参考网上其他文章。网上很多,不在赘述。重点了解:基本类型、容器、结构体、枚举、服务即可。
2.1基本类型:
bool: 布尔值 (true or false), one byte
byte: 有符号字节
i16: 16位有符号整型
i32: 32位有符号整型
i64: 64位有符号整型
double: 64位浮点型
string: Encoding agnostic text or binary string
Note that: Thrift不支持无符号整型,因为Thrift目标语言没有无符号整型,无法转换
2.2容器:
Thrift容器与流行编程语言的容器类型相对应,采用Java泛型风格。它有3种可用容器类型:
list<t1>: 元素类型为t1的有序表,容许元素重复。
set<t1>:元素类型为t1的无序表,不容许元素重复。
map<t1,t2>: 键类型为t1,值类型为t2的kv对,键不容许重复。
容器中元素类型可以是除了service外的任何合法Thrift类型(包括结构体和异常)。
2.3 枚举和结构体
枚举,和我们平常理解的枚举一样。
这里只强调结构体就是类似于c/c++中的结构体(几乎一模一样)。类似于java中的实体bean。例子如下:
枚举:
enum TweetType {
TWEET, // (1)
RETWEET = 2, // (2)
DM = 0xa, // (3)
REPLY
}
结构体:
struct TxtClass{
1: string text,
2: string classId,
3: double score,
}
2.4 服务
在流行的序列化/反序列化框架(如protocal buffer)中,Thrift是少有的提供多语言间RPC服务的框架。这是Thrift的一大特色。Thrift编译器会根据选择的目标语言为server产生服务接口代码,为client产生stubs。
这里就是thrift自动会生成的方法,我们的服务端也需要器生成的方法中进行编码。例子如下:
service Twitter {
// A method definition looks like C code. It has a return type, arguments,
// and optionally a list of exceptions that it may throw. Note that argument
// lists and exception list are specified using the exact same syntax as
// field lists in structs.
void ping(), // (1)
bool postTweet(1:Tweet tweet); // (2)
TweetSearchResult searchTweets(1:string query); // (3)
// The 'oneway' modifier indicates that the client only makes a request and
// does not wait for any response at all. Oneway methods MUST be void.
oneway void zip() // (4)
}
<!--[if !supportLists]-->1. 3.<!--[endif]-->实战例子
3.1 环境
centOS6.4 64位操作系统
3.2 安装
首先,从官网http://thrift.apache.org/上下载thrift-0.8.0版本,你可以下载最新的版本。
其次,从网上下载ant 和ivy。放在/usr目录下。
Ant下载路径:http://ant.apache.org/
Ivy下载路径:http://ant.apache.org/ivy/
一切准备就绪,即可安装:
3.2.1安装ant和ivy(root用户)
第一步:安装 切复制ivy-2.2.0.jar到/usr/local/apache-ant-1.8.2/lib/目录中
# tar xzvf apache-ant-1.8.2-bin.tar.gz -C /usr/local
# tar xzvf apache-ivy-2.2.0-bin-with-deps.tar.gz -C /usr/local
# cp /usr/local/apache-ivy-2.2.0/ivy-2.2.0.jar /usr/local/apache-ant-1.8.2/lib/
第二步:编辑vim /etc/ profile ,添加如下两行
export ANT_HOME=/usr/local/apache-ant-1.8.2
PATH=$ANT_HOME/bin:$PATH
第三步:解压thrift压缩文件。我用的是thrift-0.8.0.tar.gz
tar zxvf thrift-0.8.0.tar.gz
进入到thrift-0.8.0目录
第四步:包的检查、安装(如果缺少包,请安装缺少的包)
./configure --prefix=/usr/local/ --with-boost=/usr/local --without-php
make
make install
第五步:
在终端输入:thrift –version 查看是否安装成功。
3.3 实战例子
特别注意:如下例子:演示的是thrift-0.7.0版本(因我服务器上安装的此版本)
1.定义thrift文件:user.thrift
struct User{
1: string uid,
2: string uname,
3: bool usex,
4: i16 uage,
}
service UserService{
void add(1: User u),
User get(1: string uid),
}
2.通过thrift的shell工具命令生成c++,java代码框架
thrift -r --gen cpp user.thrift
thrift -r --gen java user.thrift
通过执行以上命令:会生成子目录gen-cpp,gen-java。
cp gen-cpp/UserService_server.skeleton.cpp UserServer.cpp
// This autogenerated skeleton file illustrates how to build a server.
// You should copy it to another filename to avoid overwriting it.
#include <string>
#include <iostream>
#include "UserService.h"
#include <config.h>
#include <protocol/TCompactProtocol.h>
#include <server/TSimpleServer.h>
#include <transport/TServerSocket.h>
#include <transport/TBufferTransports.h>
#include <concurrency/ThreadManager.h>
#include <concurrency/PosixThreadFactory.h>
#include <server/TThreadPoolServer.h>
#include <server/TThreadedServer.h>
using namespace ::apache::thrift;
using namespace ::apache::thrift::protocol;
using namespace ::apache::thrift::transport;
using namespace ::apache::thrift::server;
using namespace ::apache::thrift::concurrency;
using boost::shared_ptr;
using namespace std;
class UserServiceHandler : virtual public UserServiceIf {
public:
UserServiceHandler() {
// Your initialization goes here
}
void add(const User& u) {
// Your implementation goes here
cout << "调用add方法" << endl;
}
void get(User& _return, const std::string& uid) {
// Your implementation goes here
_return.uid = "001";
_return.uname = "dengqs";
_return.usex = 1;
_return.uage = 3;
cout << "uid = " << _return.uid << endl;
cout << "调用get方法" << endl;
}
};
int main(int argc, char **argv) {
int port = 9090;
shared_ptr<UserServiceHandler> handler(new UserServiceHandler());
shared_ptr<TProcessor> processor(new UserServiceProcessor(handler));
shared_ptr<TProtocolFactory> protocolFactory(new TCompactProtocolFactory());
shared_ptr<TTransportFactory> transportFactory(new TBufferedTransportFactory());
shared_ptr<TServerTransport> serverTransport(new TServerSocket(9090));
shared_ptr<ThreadManager> threadManager = ThreadManager::newSimpleThreadManager(10);
shared_ptr<PosixThreadFactory> threadFactory = shared_ptr<PosixThreadFactory>(new PosixThreadFactory());
threadManager->threadFactory(threadFactory);
threadManager->start();
printf("start user server...\n");
TThreadPoolServer server(processor, serverTransport, transportFactory, protocolFactory, threadManager);
server.serve();
return 0;
}
注意:我这里使用的是TCompactProtocol,则需要#include <config.h> ,还有就是Blocking的多线程服务器。
BOOST_DIR = /usr/include/boost/
THRIFT_DIR = /usr/local/include/thrift
LIB_DIR = /usr/local/lib
GEN_SRC = ./gen-cpp/user_types.cpp ./gen-cpp/user_constants.cpp ./gen-cpp/UserService.cpp
default: server
server: UserServer.cpp
g++ -g -o UserServer -I${THRIFT_DIR} -I${BOOST_DIR} -I./gen-cpp -L${LIB_DIR} -lthrift UserServer.cpp ${GEN_SRC}
注意:在当前目录下,执行:make命令。看是否有可执行文件UserServer生成。如果有,则编译成功。
nohup ./UserServer >log 2>&1 &
import org.apache.thrift.TException;
import org.apache.thrift.protocol.TCompactProtocol;
import org.apache.thrift.protocol.TProtocol;
import org.apache.thrift.transport.TSocket;
import org.apache.thrift.transport.TTransport;
import org.apache.thrift.transport.TTransportException;
import com.intyt.thrift.client.User;
import com.intyt.thrift.client.UserService;
public class Demo {
public void start(){
try {
String ip = "10.x.x.x"; //服务端的ip
int port = 9090;//端口
TTransport socket = new TSocket(ip,port);
TProtocol protocol = new TCompactProtocol(socket);
UserService.Client client = new UserService.Client(protocol);
socket.open();
User u = new User();
u.uid="003";
u.uname="dengqs_test";
u.usex=true;
u.uage=3;
client.add(u);
System.out.println(client.get(u.uid));
socket.close();
}catch (TTransportException e) {
e.printStackTrace();
} catch (TException e) {
e.printStackTrace();
}
}
public static void main(String[] args) {
Demo demo = new Demo();
demo.start();
}
}
相关推荐
一个简单的demo,关于使用thrift进行跨语言服务间的通信
Apache Thrift Java实战源码,包含了客户端和服务端源码,客户端和服务端是分开的,如果需要放到一个工程,直接把Client.java文件复制到服务端运行即可。
php代码的客户端访问java代码的服务端. 都是工程性文件,所有文件和jar包在里面。 直接可以运行!
本例改编自Apache Thrift教程: http://mikecvet.wordpress.com/2010/05/13/apache-thrift-tutorial-the-sequel/ http://chanian.com/2010/05/13/thrift-tutorial-a-php-client/ 原教程使用的是c++ server和...
Thrift Java 服务器 客户端通信,网上看到的,觉得不错就分享出来供大家一起共同分享学习。
RPC-Thrift框架实现客户端服务端通讯,VS2015-2019通用。支持一个服务端对应多个客户端通信。测试通过
Thrift RPC客户端的服务化框架代码,
一个java和python的thrift例子,其中java作为服务端,python作为客户端
编译后的thrift客户端,已经经过公司师父同意分享。 1. cp /Users/dxm/Desktop/thrift /usr/local/bin/ 2. echo $PATH 3. thrift 4. chmod +x /usr/local/bin/thrift 5. thrift 6. thrift -version
Nifty是facebook公司开源的,基于netty的thrift服务端和客户端实现。 然后使用此包就可以快速发布出基于netty的高效的服务端和客户端代码。 示例: public void startServer() { // Create the handler ...
压缩包分为三个部分,java工程(java的服务方,和java客户端) php工程,php的客户端 linux环境的服务方部署包以及脚本 其中myserver.tar.gz压缩包是linux环境的部署包, 在linux环境先解压, tar -zxvf myserver.tar.gz ...
thrift是一个软件框架,用来进行可扩展且跨语言的服务的开发。它结合了功能强大的软件堆栈和代码生成引擎,以构建在 C++, Java, Python, PHP, Ruby, Erlang, Perl, Haskell, C#, Cocoa, JavaScript, Node.js, ...
本文生动简洁介绍了如何通过python搭建一个服务端和客户端的简单测试程序。 一、简介 thrift是一个软件框架,用来进行可扩展且跨语言的服务的开发。它结合了功能强大的软件堆栈和代码生成引擎,以构建在 C++, Java,...
php 使用thrift客户端访问服务器测试 下载后 放到站点根目录,设置 thrift_test.php里的 $socket = new TSocket('10.200.28.43', 10001); 修改为默认服务器和端口 后 直接访问 http://localhost/thrift_test.php
使用thrift、websocket在javascript和c++之间建立rpc调用机制。 如果要使用js+html来写界面,cpp来写底层业务逻辑,这就非常有用了。 当然,如果底层不用cpp来写,也可以参考本代码的js对thrift的rpc包装。
1、编译后的thrift C++和.net库文件; 2、C++库只上传了多线程相关的静态库; 3、因thrift用了openssl,实际开发中可能需要加入openssl的库才能编译和运行; 4、thrift使用了boost,C++开发需要包含boost相关库和...
详细介绍了Apache Thrift在Ubuntu以及Windows下基于C++和Java语言的安装和运行。附有小例子,亲自测试通过。所述方法网上应该有教程,但大多零散不统一或者不完整,因此本人整理了一份,特来分享。
Thrift下java服务器与客户端开发指南[归纳].pdf
cassandra c++ driver 非thrift版本 支持cql 3 Supported operating systems Mac OS X 10.9 Windows 7 RHEL 5.10 Ubuntu 14.04 Build dependencies Libraries libuv 0.10 OpenSSL Tools CMake GCC 4.1.2+, Clang 3.4...