Apache Thrift 简单实例

Php rpc 服务端提供计算器服务（加减乘除），Java rpc 客户端通过 thrift api 对其进行调用。改编自thrift官方教程，主要是为了看起来更加简单。

编写接口描述文件 calculator.thrift

namespace java app.rpc.learn
namespace php App.Rpc.Learn

enum Operation {
  ADD = 1,
  SUBTRACT = 2,
  MULTIPLY = 3,
  DIVIDE = 4
}

exception InvalidOperation {
  1: i32 whatOp,
  2: string why
}

service Calculator {
   double calculate(1:double num1, 2:double num2, 3:Operation op) throws (1:InvalidOperation ouch),
}

使用 thrift编译器生成 PHP服务端及Java客户端基础代码

// 服务端命令
thrift -gen php:server calculator.thrift 

// 客户端命令
thrift -gen java calculator.thrift

php 服务端实现计算器服务

whatOp = $op;
                    $io->why = "Cannot divide by 0";
                    throw $io;
                }
                $val = $num1 / $num2;
                break;
            default:
                $io = new InvalidOperation();
                $io->whatOp = $op;
                $io->why = "Invalid Operation";
                throw $io;
        }
        return $val;
    }
}

搭建并开启服务
本文使用了laravel 5.5 框架来搭建php 测试服务器，由composer管理系统依赖，为了引入 thrift 依赖，在项目根目录下执行以下命令即可：

composer require apache/thrift

编写 RpcController：

open();
        $processor->process($protocol, $protocol);
        $transport->close();
    }
}

在 routes/api.php 文件中配置路由：

Route::post('/rpc', [
    'as' => 'rpc',
    'uses' => 'RpcController@handleRequest'
]);

在项目根目录下执行以下命令启动测试服务器：

php artisan serve

编写 Java rpc 客户端
thrift 0.11.0 版本目前尚未加入maven 仓库，因此使用以下方式将无法下载到thrift 0.11.0版本的依赖包


  org.apache.thrift
  libthrift
  0.11.0

目前如果要使用0.11.0版，在编译构建thrift源代码后，lib/java/build 目录下有所有需要依赖的jar包，将其加入类路径即可。

该例子中的客户端代码非常简单：

package app;

import org.apache.thrift.protocol.TBinaryProtocol;
import org.apache.thrift.protocol.TProtocol;
import org.apache.thrift.transport.THttpClient;
import org.apache.thrift.transport.TTransport;

import app.rpc.learn.Calculator;
import app.rpc.learn.InvalidOperation;
import app.rpc.learn.Operation;

public class RpcClient {

    public static void main(String[] args) {
        TTransport transport = null;
        try {
            transport = new THttpClient("http://localhost:8000/api/rpc");
            TProtocol protocol = new TBinaryProtocol(transport, true, true);
            Calculator.Client rpcCalculator = new Calculator.Client(protocol);
            System.out.println("Start Access Calculate Service From PHP Rpc Server...");
            System.out.print("12 + 5 = ");
            System.out.println(rpcCalculator.calculate(12, 5, Operation.ADD));
            System.out.print("12 - 5 = ");
            System.out.println(rpcCalculator.calculate(12, 5, Operation.SUBTRACT));
            System.out.print("12 * 5 = ");
            System.out.println(rpcCalculator.calculate(12, 5, Operation.MULTIPLY));
            System.out.print("12 / 5 = ");
            System.out.println(rpcCalculator.calculate(12, 5, Operation.DIVIDE));
            System.out.print("1 / 0 = ");
            System.out.println(rpcCalculator.calculate(1, 0, Operation.DIVIDE));
        } catch (InvalidOperation e) {
            System.out.println("Exception: " + e.why);
        } catch (Exception e) {
            System.out.println(e.getMessage());
        } finally {
            if (transport != null) {
                transport.close();
            }
        }   
    }
}

运行结果：

Start Access Calculate Service From PHP Rpc Server...
12 + 5 = 17.0
12 - 5 = 7.0
12 * 5 = 60.0
12 / 5 = 2.4
1 / 0 = Exception: Cannot divide by 0

最后感谢伟大的markdown让写文档如此方便！

Apache Thrift 简单实例

你可能感兴趣的:(Apache Thrift 简单实例)