mPaas-RPC 拦截器各种场景下的使用指南

一 背景

 金融级移动开发平台 mPaaS（Mobile PaaS）为 App 开发、测试、运营及运维提供云到端的一站式解决方案，能有效降低技术门槛、减少研发成本、提升开发效率，协助企业快速搭建稳定高质量的移动应用。其中移动网关服务（Mobile Gateway Service，简称 MGS）作为mPaas最重要的组件之一，连接了移动客户端与服务端，简化了移动端与服务端的数据协议和通讯协议，从而能够显著提升开发效率和网络通讯效率。在我们日常运维过程中发现，很多用户在使用客户端RPC组件的时候，有很多不同场景的诉求，比如拦截请求添加业务请求标记，免登，返回结果模拟，异常处理，限流等。本文旨在介绍通过利用RPC提供的拦截器机制，通过不同实际场景的描述，供业务参考使用。

二 RPC调用原理

 当 App 在移动网关控制台接入后台服务后，调用RPC的示例代码如下

RpcDemoClient client = MPRpc.getRpcProxy(RpcDemoClient.class);
// 设置请求
GetIdGetReq req = new GetIdGetReq();
req.id = "123";
req.age = 14;
req.isMale = true;
// 发起 rpc 请求
String response = client.getIdGet(req);

 值得好奇的是，整个调用过程中其实我们并没有去实现 RpcDemoClient 这个接口，而是通过 MPRpc.getRpcProxy 获取了一个代理，通过代理对象完成了调用。在这里其实主要使用了 Java 动态代理的技术。如下图所示，当调用RPC接口的时候，会通过动态代理的RpcInvocationHandler，回调其实现的invoke方法，最终在invoke内实现数据的序列化处理最后通过网络库发到服务端。

 public <T> T getRpcProxy(Class<T> clazz) {
        LogCatUtil.info("RpcFactory", "clazz=[" + clazz.getName() + "]");
        return Proxy.newProxyInstance(clazz.getClassLoader(), new Class[]{clazz}, new RpcInvocationHandler(this.mConfig, clazz, this.mRpcInvoker));
    }

在业务开发中，如果在某些情况下需要控制客户端的网络请求（拦截网络请求，禁止访问某些接口，或者限流），可以通过 RPC 拦截器实现。

RpcService rpcService = getMicroApplicationContext().findServiceByInterface(RpcService.class.getName());
        rpcService.addRpcInterceptor(OperationType.class, new CommonInterceptor());

三 拦截器

1. 原理

   RPC目前采用了拦截器机制实现RPC的自定义处理，如下图所示，业务可以通过设置自定义RpcIntercept实现在请求前，请求异常，请求返回三个