前言:

因为项目需要跨语言,c++客户端,web服务端,远程调用等需求,所以用到了RPC框架Thrift,刚开始有点虚,第一次接触RPC框架,后来没想到Thrift开发方便上手快,而且性能和稳定性也不错,项目也顺利完成。所以给各位小白们,“科普”一下如何使用Thrift完成自己的远程调用。

1.什么是RPC:                     

平时开发的服务,大多都是本地调用,如果说需要依赖他人服务了,而且他人的服务在远端,那怎么调用呢?

RPC能够游刃有余的解决这样的问题。首先来研究一下什么RPC。

RPC(remote produce call),远程过程调用协议。它是一种通过网络从远程计算机程序上请求服务,而不需要了解底层网络技术的协议。

看下面这张图:

一次远程的调用经历了一下10个步骤:

1.调用客户端以本地方式调用远程服务

2.client stub将请求(方法和参数)组装成网络消息

3.client stub找得到服务器地址,将消息传送到远程主机

4.server stub得到传送过来的请求,进行解码

5.server stub 调用本地服务,处理请求

6.本地服务处理请求,并将处理结果返回给server stub

7.server stub将请求处理结果组装成网络消息

8.server stub找到客户端地址,将请求处理结果传送给客户端

9.client stub 接收到请求处理结果,进行解码

10.客户端最终接收到请求处理结果

RPC框架的目的就是将2-9步骤封装起来,对使用者透明,客户端只需要执行第一步调用接口,然后就能够得到结果。这样是不是很方便,而且省去了很多麻烦。

通过对RPC的初步了解,那接下来就开始不如Thrift的大门吧

2.What is Thrift?                                                

Thrift是Facebook公司开发的一款开源的RPC框架,对于一般的RPC框架来说,通过IDL语言定义接口(Interface description language),Thrift也采用了这样的做法,并通过一个编译器生成不同语言的代码(目前支持C++,Java, Python, PHP, Ruby, Erlang, Perl, Haskell, C#, Cocoa, Smalltalk和OCaml),并由生成的代码负责RPC协议层和传输层的实现。

Thrift协议栈:

第一部分(Your Code):

简单总结:开发者的业务逻辑代码

第二部分(ServiceClient)

Thrift自动生成的代码,包含Processor、Tserver、ServiceClient

TServer负责接收Client的请求,并将请求转发到Processor进行处理。TServer主要任务就是高效的接受Client的请求,特别是在高并发请求的情况下快速完成请求。

Processor(或者TProcessor)负责对Client的请求做出相应,包括RPC请求转发,调用参数解析和用户逻辑调用,返回值写回等处理步骤。Processor是服务器端从Thrift框架转入用户逻辑的关键流程。Processor同时也负责向Message结构中写入数据或者读出数据。

ServiceClient就是客户端,包含可以调用的请求方法和发送客户端请求

第三部分:

TProtocol主要负责结构化数据组装成Message,或者从Message结构中读出结构化数据。TProtocol将一个有类型的数据转化为字节流以交给TTransport进行传输,或者从TTransport中读取一定长度的字节数据转化为特定类型的数据。如int32会被TBinaryProtocol Encode为一个四字节的字节数据,或者TBinaryProtocol从TTransport中取出四个字节的数据Decode为int32。

第四部门:

TTransport负责以字节流方式发送和接收Message,是底层IO模块在Thrift框架中的实现,每一个底层IO模块都会有一个对应TTransport来负责Thrift的字节流(Byte Stream)数据在该IO模块上的传输。例如TSocket对应Socket传输,TFileTransport对应文件传输。

第五部分:

底层IO模块,负责实际的数据传输,包括Socket,文件,或者压缩数据流等。

通过这个协议栈,可以得出结论,使用Thrift只需要做三件事:

1.通过IDL定义数据结构和服务

2.利用代码生成工具生成代码

3.编写你的业务逻辑

接下来我们就按照这个三步走开发一个简单的HelloWorld级别的客户端与服务端

3.How to use Thrift?                                                

首先要做的就是下载并配置Thrift,附上链接:http://thrift.apache.org/download

现在版本都是0.10.0,

下载好之后将名字改成“thrift.exe”,

我的电脑操作系统是Windows,属于在Windows情况下配置。

将thrift.exe放在Thrift文件夹下:

配置环境变量:

配置完成之后,打开dos窗口,输入”thrifx -version”:

接下来执行三步走策略:

第一步:通过IDL定义数据结构和服务

从最简单的HelloWorld开始,编写HelloWorld.thrift,内容如下:

  1. namespace java service.server
  2. service HelloWorld{
  3. string sendString(:string para)
  4. }

随便放在一个文件夹下,我这里放在E:\software\Thrift,

第二步:利用代码生成工具生成代码

进入HelloWorld.thrift所在目录,执行

执行完成,你会发现没有任何提示,记得有位大神说过,没有任何提示就是好事。

这时候发现在当前目录下多了一个gen-java的目录,里面有Thrift生成的HelloWorld.java

OK,前两步已经完成,还是很简单的吧。

第三步:编写你的业务逻辑

创建一个Gradle管理的Java项目,bulid.gradle中添加相关的依赖,将gen-java中的HelloWorld.java拷贝到IDE的java项目中(注意包名,地址对应)。

(喜欢用Maven的朋友可以用Maven构建)

  1. dependencies {
  2. compile "org.apache.thrift:libthrift:0.9.2"
  3. compile "org.slf4j:slf4j-log4j12:1.7.5"
  4. }

创建HelloWorldServiceImpl实现HelloWorld.Iface接口,这个就是主要的业务逻辑。

  1. package service.impl;
  2.  
  3. import org.apache.thrift.TException;
  4. import service.server.HelloWorld;
  5.  
  6. /**
  7. * 服务端实现
  8. *
  9. * @author tang
  10. */
  11. public class HelloWorldServiceImpl implements HelloWorld.Iface {
  12.  
  13. @Override
  14. public String sendString(String para) throws TException {
  15. System.out.println("接收到服务端传来的参数: " + para);
  16. String result = "服务端成功收到消息";
  17. return result;
  18. }
  19.  
  20. }

接着,创建服务端实现代码,命名为HelloWorldServiceServer,把HelloWoeldServiceImpl作为一个具体的处理器传递给Thrift服务器:

  1. package service.server;
  2.  
  3. import org.apache.thrift.TProcessor;
  4. import org.apache.thrift.protocol.TBinaryProtocol;
  5. import org.apache.thrift.server.TServer;
  6. import org.apache.thrift.server.TSimpleServer;
  7. import org.apache.thrift.transport.TServerSocket;
  8. import org.apache.thrift.transport.TTransportException;
  9. /**
  10. * 服务端
  11. *
  12. * @author tang
  13. */
  14. import service.impl.HelloWorldServiceImpl;
  15.  
  16. public class HelloWorldServiceServer {
  17.  
  18. public static void main(String[] args) throws TTransportException {
  19. System.out.println("服务端开启");
  20.  
  21. // 关联处理器
  22. TProcessor tProcessor = new HelloWorld.Processor<HelloWorld.Iface>(new HelloWorldServiceImpl());
  23.  
  24. // 设置服务端口为 8080
  25. TServerSocket serverSocket = new TServerSocket(8080);
  26.  
  27. // 简单的单线程服务模型
  28. TServer.Args tArgs = new TServer.Args(serverSocket);
  29. tArgs.processor(tProcessor);
  30. // 设置协议工厂为 TBinaryProtocol.Factory
  31. tArgs.protocolFactory(new TBinaryProtocol.Factory());
  32. TServer server = new TSimpleServer(tArgs);
  33. // 启动服务
  34. server.serve();
  35. }
  36.  
  37. }

最后,再写一个客户端HelloWorldClient.java:

  1. package client;
  2.  
  3. import org.apache.thrift.protocol.TBinaryProtocol;
  4. import org.apache.thrift.protocol.TProtocol;
  5. import org.apache.thrift.transport.TSocket;
  6. import org.apache.thrift.transport.TTransport;
  7. import service.server.HelloWorld;
  8.  
  9. /**
  10. * 客户端
  11. *
  12. * @author tang
  13. */
  14. public class HelloWorldClient {
  15.  
  16. public static void main(String[] args) {
  17. System.out.println("客户端启动....");
  18. TTransport transport = null;
  19. try {
  20. // 设置调用的服务地址为本地,端口为8080,超时设置为30秒
  21. transport = new TSocket("localhost", 8080, 30000);
  22. // 协议要和服务端一致
  23. TProtocol protocol = new TBinaryProtocol(transport);
  24. HelloWorld.Client client = new HelloWorld.Client(protocol);
  25. transport.open();
  26. // 调用接口方法
  27. String result = client.sendString("Hello World!");
  28. System.out.println(result);
  29. } catch (Exception e) {
  30. e.printStackTrace();
  31. } finally {
  32. if (null != transport) {
  33. transport.close();
  34. }
  35. }
  36. }
  37.  
  38. }

这个是project结构图:

这里有一些Thrift自带的警告,不用去管他(有点违背Effective java中的原则)。。。。。

最后的最后:测试

启动服务端,然后再启动客户端,这是服务端会收到来自客户端的消息:“HelloWorld”

客户端收到服务端的反馈:

好了,到这里,Thrift的第一个实例就结束了,总的来说Thrift还是很好用的,有些的不好的地方欢迎批评斧正!

参考文章:

http://www.blogjava.net/ldwblog/archive/2014/12/03/421011.html

Thrift教程初级篇——thrift安装环境变量配置第一个实例的更多相关文章

  1. NSIS安装制作基础教程[初级篇], 献给对NSIS有兴趣的初学者

    NSIS安装制作基础教程[初级篇], 献给对NSIS有兴趣的初学者 作者: raindy 来源:http://bbs.hanzify.org/index.php?showtopic=30029 时间: ...

  2. .NET C#教程初级篇 1-1 基本数据类型及其存储方式

    .NET C# 教程初级篇 1-1 基本数据类型及其存储方式 全文目录 (博客园).NET Core Guide (Github).NET Core Guide 本节内容是对于C#基础类型的存储方式以 ...

  3. Maven安装环境变量配置教程(带图)

    Maven安装配置环境变量教程 什么是maven:Maven是一个软件项目管理和综合工具.基于项目对象模型(POM)的概念,Maven可以从一个中心资料片管理项目构建,报告和文件. (简单来说就是,安 ...

  4. Maven的安装环境变量配置

    针对新手刚接触maven,并且不知道如何去搭建和使用maven,那么我来写一篇浅显易懂的初级篇教程吧. 不同的是,别人会先将概念再安装,我来帮大家先搭建好以后再去看概念,不然概念会变的很模糊. 安装 ...

  5. jdk安装环境变量配置

    v\:* {behavior:url(#default#VML);} o\:* {behavior:url(#default#VML);} w\:* {behavior:url(#default#VM ...

  6. Maven教程初级篇02:pom.xml配置初步

    1. 创建项目并更改项目基本配置信息 在命令行下运行如下命令创建一个项目: 1 mvn archetype:create -DgroupId=net.jianxi.tutorials     2    ...

  7. .net妹纸转Java---java环境的搭建,myeclipse10.0 的安装环境变量配置和破解

    啦啦啦 ,因为公司项目需要,从我大火炉--大武汉被拖到了更大的火炉--大广西  其实一开始 我的内心是拒绝的. 但是我在大武汉呆了近2年木有出过远门,对, 生活除了眼前的苟且,还有远方的苟且.怀揣这样 ...

  8. CentOS 6.5移除openJDK及JDK安装环境变量配置及JDK版本切换

    一.查找已经安装的open JDK [root@localhost ~]# rpm -qa|grep jdk java--openjdk-.el6_3.x86_64 java--openjdk-1.7 ...

  9. win7下jdk安装环境变量配置

    新本本,新系统,还是得把武器给装配好. 以下图文记录win7系统下的jdk的安装和配置. 1.下载jdk 地址:http://java.sun.com/javase/downloads/index.j ...

随机推荐

  1. CSS常见英语单词属性一览

    这些是css中常会用到的一些英文单词,大家可以多看看,多使用就会容易记得了. color : #999999; /*文字颜色*/ font-family : 宋体,sans-serif; /*文字字体 ...

  2. Linux学习总结(十一)—— Linux常用命令:版本信息查看(RedHat、CentOS、Debian、Ubuntu、Fedora、Oracle)

    这篇文章收集了CentOS.Oracle.RedHat等系统查看发行版本.内核版本.位数的方法,欢迎补充. 系统 发行版本 -- 内核版本.位数 RedHat cat /etc/issue cat / ...

  3. [undefined,1] 和 [,1]的区别在哪里--认识js中的稀疏数组

    事情是这样的 今天我想写一个能快速生成一个自然数数组的函数,就是[0,1,2,3]这样的,然后我写了下面的代码: new Array(10).map((item, index) => { ret ...

  4. Fedora25 将eclipse的快捷方式添加到Applications中

    [root@localhost Downloads]# vi /usr/share/applications/eclipse.desktop 然后在里面添加如下内容: [Desktop Entry]N ...

  5. OpenCV中phase函数计算方向场

    一.函数原型 ​该函数参数angleInDegrees默认为false,即弧度,当置为true时,则输出为角度. phase函数根据函数来计算角度,计算精度大约为0.3弧度,当x,y相等时,angle ...

  6. 聚币网API[Python2版]

    聚币 现货 API [Python2版] 一.utils.py,基础类,包括HTTP 请求.签名等 # -*- coding: utf-8 -*- import hashlib import hmac ...

  7. 一个还算简单的微信消息SDK(基于.Net Standard 2.0)

    虽然微信公众号出现了好久,不过在SDK这件事情上感觉并没有多少人把它当成一个有技术含量的事情来做,很多SDK做的事情就是一个代码的堆叠,当然也可能写的好的并没有开源出来.所以在某个翻遍Github而无 ...

  8. python之VSCode安装

    [之前发布到本人的51cto博客,现转过来] 1.安装python3.5(3.6版本亲测无法实现命令补全功能) 2.安装VSCode(我的版本:VSCode-win32-1.7.2) 3.安装Pyth ...

  9. mac系统webstorm快捷键

    WebStorm 是jetbrains公司旗下一款JavaScript 开发工具.被广大中国JS开发者誉为"Web前端开发神器"."最强大的HTML5编辑器". ...

  10. CSS中的路径裁剪样式clip-path

    前面的话 CSS借鉴了SVG裁剪的概念,设置了clip-path样式,本文将详细介绍路径裁剪clip-path 概述 clip-path属性可以防止部分元素通过定义的剪切区域来显示,仅通过显示的特殊区 ...