快速开始

重要：自 2020 年 6 月 28 日起，mPaaS 停止维护 10.1.32 基线。请使用 10.1.68 或 10.1.60 系列基线。可以参考 mPaaS 10.1.68 升级指南 或 mPaaS 10.1.60 升级指南 进行基线版本升级。

网关是连接客户端与服务端的桥梁，客户端通过网关来访问后台服务接口。通过使用网关，您可以实现以下目的：

  • 通过动态代理的方式，封装客户端和服务端之间的通讯。
  • 如果服务端和客户端定义了一致的接口，可由服务端自动生成代码并导出给客户端使用。
  • 对 RpcException 进行统一的异常处理，弹对话框、toast 消息框等。

移动网关支持 原生 AAR 接入、mPaaS Inside 接入 和 组件化（Portal&Bundle）接入 三种接入方式。

前置条件

添加 SDK

原生 AAR 方式

参考 AAR 组件管理，通过 组件管理（AAR） 在工程中安装 移动网关 组件。

mPaaS Inside 方式

在工程中通过 组件管理 安装 移动网关 组件。
更多信息，请参考 管理组件依赖。

组件化（Portal&Bundle）方式

在 Portal 和 Bundle 工程中通过 组件管理 安装 移动网关 组件。
更多信息，请参考 管理组件依赖。

初始化 mPaaS

如果您使用 原生 AAR 接入 或 mPaaS Inside 接入 ，您需要初始化 mPaaS。

  1. public class MyApplication extends Application {
  3.     @Override
  4.     protected void attachBaseContext(Context base) {
  5.         super.attachBaseContext(base);
  6.         // mPaaS 初始化回调设置
  7.         QuinoxlessFramework.setup(this, new IInitCallback() {
  8.             @Override
  9.             public void onPostInit() {
  10.                 // 此回调表示 mPaaS 已经初始化完成，mPaaS 相关调用可在这个回调里进行
  11.             }
  12.         });
  13.     }
  15.     @Override
  16.     public void onCreate() {
  17.         super.onCreate();
  18.         // mPaaS 初始化
  19.         QuinoxlessFramework.init();
  20.     }
  21. }

生成 RPC 代码

当 App 在移动网关控制台接入后台服务后，进入 mPaaS 控制台，从左侧导航栏选择 移动网关 > API 管理 > 生成代码，下载客户端的 RPC 代码。详细说明参见 移动网关 > 服务端管控 相关文档。

下载的 RPC 代码结构如下，包括 RPC 配置、request 模型和 response 模型。
RPC

调用 RPC

客户端发起 PRC 调用。代码示例如下：

  1. // 获取 client 实例
  2. RpcDemoClient client = MPRpc.getRpcProxy(RpcDemoClient.class);
  3. // 设置请求
  4. GetIdGetReq req = new GetIdGetReq();
  5. req.id = "123";
  6. req.age = 14;
  7. req.isMale = true;
  8. // 发起 RPC 请求
  9. try {
  10.     String response = client.getIdGet(req);
  11. } catch (RpcException e) {
  12.     // 处理 RPC 请求异常
  13.     Log.i("RpcException", "code: " + e.getCode() + " msg: " + e.getMsg());
  14. }

RPC 调用异常会统一通过 RpcException 抛出来，可根据 RpcException 的 code 结果码做相应处理，错误码详情参见 网关结果码说明。

相关链接