快速开始

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

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

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

前置条件

• 若采用原生 AAR 方式接入，需先完成 将 mPaaS 添加到您的项目中 的前提条件和后续相关步骤。
• 若采用 mPaaS Inside 方式接入，需先完成 mPaaS Inside 接入流程。
• 若采用组件化方式接入，需先完成 组件化接入流程。

添加 SDK

原生 AAR 方式

参考 AAR 组件管理，通过 组件管理（AAR） 在工程中安装 H5 容器 组件。

mPaaS Inside 方式

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

组件化（Portal&Bundle）方式

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

初始化 mPaaS

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

public class MyApplication extends Application {
    @Override
    protected void attachBaseContext(Context base) {
        super.attachBaseContext(base);
        // mPaaS 初始化回调设置
        QuinoxlessFramework.setup(this, new IInitCallback() {
            @Override
            public void onPostInit() {
                // 此回调表示 mPaaS 已经初始化完成，mPaaS 相关调用可在这个回调里进行
            }
        });
    }
    @Override
    public void onCreate() {
        super.onCreate();
        // mPaaS 初始化
        QuinoxlessFramework.init();
    }
}

生成 RPC 代码

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

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

调用 RPC

// 获取 client 实例
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);

相关链接

• 代码示例
• 网关结果码说明
• 密钥生成方法