Mac上brew&thrift安装 以及在thrift架构下,自己新作了maven的小例 Demo

时间:2021-11-06 16:34:08

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,注意,有时候过程可能稍慢,请耐心等候,其以上过程可能需要输入你的本机账号密码,直接输入然后按回车键即可,

第一次我还不确定是否真的安装成功,就有操作一次结果提醒我已经安装过,再次安装会覆盖以前的,所以大家不用担心再次输入操作,如图:

 
Mac上brew&thrift安装 以及在thrift架构下,自己新作了maven的小例 Demo
 
问题: 后来我发现 安装完之后 输入brew help 总是报错 显示 brew :command not found;
网上一查 忘了添加路径了,参考:解决mac安装homebrew后报错-bash: brew: command not found
 
/usr/local/bin不在PATH中
找到解决方式。其实解决这个问题真的很简单。如下:
sudo vim .bash_profile
添加:
PATH=“.;$PATH:/usr/local/bin”
保存,source .bash_profile使配置修改生效。
重新启动终端  再次使用brew 命令就ok了。
brew安装再次输入命令

使用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

 
Mac上brew&thrift安装 以及在thrift架构下,自己新作了maven的小例 Demo
输入brew命令

3,thrift

当然通过以上就知道如何安装thrift了,只需要在终端输入brew命令行sudo brew install thrift,过程如图:

 
Mac上brew&thrift安装 以及在thrift架构下,自己新作了maven的小例 Demo
图1,过程

注意过程很慢,可从图最下3.9%,最后安装成功可从下图比较:

 
Mac上brew&thrift安装 以及在thrift架构下,自己新作了maven的小例 Demo
图2 ,结果

一直到出现你的本机名的时候才算成功

不过我在安装输入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

参考:Thrift入门初探--thrift安装及java入门实例

参考: Mac上brew&thrift安装