全部产品

快速开始

更新时间:2020-09-01 10:25:27

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

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

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

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

前置条件

添加 SDK

原生 AAR 方式

参考 AAR 组件管理,通过 组件管理(AAR) 在工程中安装 H5 容器 组件。

mPaaS Inside 方式

在工程中通过 组件管理 安装 H5 容器 组件。
更多信息,请参考 管理组件依赖

组件化(Portal&Bundle)方式

在 Portal 和 Bundle 工程中通过 组件管理 安装 H5 容器 组件。
更多信息,请参考 管理组件依赖

初始化 mPaaS

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

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

生成 RPC 代码

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

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

调用 RPC

  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. String response = client.getIdGet(req);

相关链接