1.缘由
前几天偶尔在网上看到thrift的信息,其内容和作用极大的引起了我的兴趣,因为我也是做iOS开发的,通过在网上的查询发现信息虽然很多实用的很少,容易误导他人,经过自己的成功实践,做了笔录,为了方便朋友了解和阅读,就也啰里啰嗦的整理一下繁琐的东西,希望对我的朋友和他人能有所帮助。
2.brew
我是在Mac上通过终端先安装brew,再在终端输入brew命令行来安装thrift的,当然还有其他的方式,大家可以去网上了解一下,而我用brew是对其偏爱,是因为brew作为Mac OSX上的软件包管理工具,能在Mac中方便的安装软件或者卸载软件, 只需要一个命令, 而不用麻烦的终端命令,非常方便,另外brew 又叫Homebrew。具体安装步骤非常简单如下:
1,打开终端,输入ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"。当然也可以直接复制这个命令行粘贴到终端,按回车键
2,然后一会会跳出这个语句:Press RETURN to continue or any other key to abort,其意思就是按回车键继续,或者其他键跳出,当然我们按回车键,然后就开始安装了。
3,注意,有时候过程可能稍慢,请耐心等候,其以上过程可能需要输入你的本机账号密码,直接输入然后按回车键即可,
第一次我还不确定是否真的安装成功,就有操作一次结果提醒我已经安装过,再次安装会覆盖以前的,所以大家不用担心再次输入操作,如图:
使用brew安装软件,通过在终端一行命令即可(brew的命令都是在终端输入的),如:sudo brew install git,就会安装git,我们也可以sudo brew update更新brew,常用命令列示如下:
1,sudo brew uninstall wget 卸载软件wget
2, sudo brew search /wge*/ 查询软件wget
3, sudo brew list 列出已安装的软件
4, sudo brew home 用浏览器打开brew的官方网站
5, sudo brew info 显示软件信息
6, sudo brew deps 显示包依赖
比如:输入3,和4
3,thrift
当然通过以上就知道如何安装thrift了,只需要在终端输入brew命令行sudo brew install thrift,过程如图:
注意过程很慢,可从图最下3.9%,最后安装成功可从下图比较:
一直到出现你的本机名的时候才算成功
不过我在安装输入sudo brew install thrift 的时候提示:Running Homebrew as root is extremely dangerous and no longer supported
参考:mac下面通过brew安装东西的时候报Error: Running Homebrew as root is extremely dangerous and no longer supported的解决
其实就是把 sudo 去掉, 直接输入 brew install thrift
安装成功大家就可以使用thrift了,如果不了解thrift的朋友可以在网上查查,这里也做一些了解:
thrift最初由Facebook研发,主要用于各个服务之间的RPC通信,支持跨语言,常用的语言ActionScript3,glibc,cocoa(开发ios用的),C++,C#,delphi,erlang,go,haskell,html,java,javame(山寨机开发),jquery,node.js,Ocaml,perl,php,python,ruby,smalltalk,xsd,简单的说,就是可以让人快速的写Socket Server(服务器)和Client(客户端)。其实不用thrift开发socket也不难,那么为什么要用thrift开发呢?主要有两个原因,一个是因为thrift本身帮你封装了很多基本的东西,你不需要自己去写socket里面的bind,accept之类的,以及他们的逻辑。可以很快速的开发基于进程的,线程的,SSL的socket。第二个理由是标准化,跨语言和跨平台,windows不算在其中。主要是在各种Posix兼容的操作系统中都可以不需要改造基本直接可用,支持的语言种类也很多,基本你会写的,他都支持。你不会写的,他也支持。类似的项目还有ICE和Avro,但是感觉都没有thrift做的易用性好。而且这是facebook开源的诸多项目中,为数不多的能正常编译的软件,
使用thrift需要先定义接口文件,在thrift里简称叫IDL,全称叫Interface Description Language,接口描述语言。接口描述语言里面需要定义接口中所使用的数据类型,方法等等
数据类型包括:
基本类型:
bool: 布尔类型(true或者false)
byte: 有符号8位整型
i16: 有符号16位整型
i32: 有符号32位整型
i64: 有符号64位整型
double: 64位浮点数
string: UTF8编码的字符串
特殊类型:
binary: 未编码的二进制字节流
struct:结构体类型
container:
list:列表,可以理解为数组,其中的元素可以是任意类型的。
exceptions:
用来抛出你自己定义的异常情况
service:
这个是最重要的定义,有些地方说是虚函数,但是理解成你程序中所使用的方法更容易明白一些。他需要你定义返回类型,这有点类似于C或者java的函数定义。但你要明白,这个返回是给socket的。如果你定义错了,将不仅仅是你得不到返回值这么简单的事情。而是程序会报错
现在,再按照上面的步骤进行下去,就可以正确安装thrift了.
进入thrift大门的第一个java小实例
1,创建一个服务Hello,创建文件Hello.thrift,代码如下:
namespace java service.demo service Hello{ string helloString(1:string para) }
这里定义了一个名为helloString的方法,入参和返回值都是一个string类型的参数.
2,终端进入Hello.thrift所在目录,执行命令:
thrift -r -gen java Hello.thrift
发现在当前目录下多了一个gen-java的目录,里面的有一个Hello.java的文件.这个java文件包含Hello服务的接口定义Hello.Iface,以及服务调用的底层通信细节,包括客户端的调用逻辑Hello.Client以及服务端的处理逻辑Hello.Processor,
3,创建一个Maven管理的Java项目,pom.xml中添加相关的依赖,并将Hello.java文件复制到项目中:
<dependency> <groupId>org.apache.thrift</groupId> <artifactId>libthrift</artifactId> <version>0.10.0</version> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> <version>1.7.5</version> </dependency>
此处需要注意,如果你的pom.xml中原来就有的话,难么,你需要先新建标签dependencies;
比如我的:
<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>thrift_test</groupId> <artifactId>thrift_test</artifactId> <version>1.0-SNAPSHOT</version> <dependencies> <dependency> <groupId>org.apache.thrift</groupId> <artifactId>libthrift</artifactId> <version>0.10.0</version> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> <version>1.7.5</version> </dependency> </dependencies> </project>
注意到了吗,新建了<dependencies>标签;
4,创建HelloServiceImpl实现Hello.Iface接口:
package service.demo; import org.apache.thrift.TException; /** * @author yogo.wang * @date 2017/02/21-下午2:13. */ public class HelloServiceImpl implements Hello.Iface { public String helloString(String para) throws TException { return "result:"+para; } }
5,创建服务端实现代码HelloServiceServer,把HelloServiceImpl作为一个具体的处理器传递给Thrift服务器:
package service.demo; import org.apache.thrift.TProcessor; import org.apache.thrift.protocol.TBinaryProtocol; import org.apache.thrift.server.TServer; import org.apache.thrift.server.TSimpleServer; import org.apache.thrift.transport.TServerSocket; import org.apache.thrift.transport.TTransportException; /** * @author yogo.wang * @date 2017/02/21-下午2:15. */ public class HelloServiceServer { /** * 启动thrift服务器 * @param args */ public static void main(String[] args) { try { System.out.println("服务端开启...."); TProcessor tprocessor = new Hello.Processor<Hello.Iface>(new HelloServiceImpl()); // 简单的单线程服务模型 TServerSocket serverTransport = new TServerSocket(9898); TServer.Args tArgs = new TServer.Args(serverTransport); tArgs.processor(tprocessor); tArgs.protocolFactory(new TBinaryProtocol.Factory()); TServer server = new TSimpleServer(tArgs); server.serve(); }catch (TTransportException e) { e.printStackTrace(); } } }
6,创建客户端实现代码HelloServiceClient,调用Hello.client访问服务端的逻辑实现:
package service.demo; import org.apache.thrift.TException; import org.apache.thrift.protocol.TBinaryProtocol; import org.apache.thrift.protocol.TProtocol; import org.apache.thrift.transport.TSocket; import org.apache.thrift.transport.TTransport; import org.apache.thrift.transport.TTransportException; /** * @author yogo.wang * @date 2017/02/21-下午2:35. */ public class HelloServiceClient { public static void main(String[] args) { System.out.println("客户端启动...."); TTransport transport = null; try { transport = new TSocket("localhost", 9898, 30000); // 协议要和服务端一致 TProtocol protocol = new TBinaryProtocol(transport); Hello.Client client = new Hello.Client(protocol); transport.open(); String result = client.helloString("哈哈"); System.out.println(result); } catch (TTransportException e) { e.printStackTrace(); } catch (TException e) { e.printStackTrace(); } finally { if (null != transport) { transport.close(); } } } }
全部工作完成后,下面来测试一下,先执行服务端main方法,在执行客户端main方法,会在客户端控制台打印出:result:哈哈.
这里注意几点:
(1)先执行服务端的main方法,然后执行客户端的main方法;
(2)当把Hello.java文件放到项目中的时候,我的总是报错,说thrift生成的Hello.java文件 中的override 不能重写,我直接把关键字override注销了;错误消失;
在terminal 中执行 mvn clean; 成功
执行mvn clean install 成功
执行 mvn clean install -Dmaven.test.skip=true 成功;
例子下载地址:thrift 架构的Java的小例子 demo