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

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

 

输入brew命令

3，thrift

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

 

图1，过程

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

 

图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安装