Mobile Platform as a Service：Java SDK 接入

引入 Jar 包

完成 Maven 配置後，在主控 pom.xml 檔案中引入如下依賴：

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>mpaas20201028</artifactId>
    <version>5.0.1</version>
</dependency>
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>tea-openapi</artifactId>
    <version>0.3.6</version>
</dependency>

環境變數配置

配置環境變數 MPAAS_AK_ENV 和 MPAAS_SK_ENV。

• Linux 和 macOS 系統配置方法執行以下命令：

  export MPAAS_AK_ENV=<access_key_id>
  export MPAAS_SK_ENV=<access_key_secret>

  說明

  access_key_id 替換為已準備好的 AccessKey ID，access_key_secret 替換為 AccessKey Secret。

• Windows 系統配置方法

  1. 建立環境變數，添加環境變數 MPAAS_AK_ENV 和 MPAAS_SK_ENV，並寫入已準備好的 AccessKey ID 和 AccessKey Secret。

  2. 重啟 Windows 系統。

介面說明

單資料同步介面

單資料同步介面是指將資料同步到指定的使用者或者裝置。

參數說明

業務參數資訊如下：

單條資料同步結果碼

程式碼範例

import com.alibaba.fastjson.JSON;
import com.aliyun.mpaas20201028.Client;
import com.aliyun.mpaas20201028.models.CreateOpenSingleDataRequest;
import com.aliyun.mpaas20201028.models.CreateOpenSingleDataResponse;
import com.aliyun.teaopenapi.models.Config;

public static void main(String[] args) throws Exception {
    // 阿里雲帳號AccessKey擁有所有API的存取權限，建議您使用RAM使用者進行API訪問或日常營運。
    // 強烈建議不要把AccessKey ID和AccessKey Secret儲存到工程代碼裡，否則可能導致AccessKey泄露，威脅您帳號下所有資源的安全。
    // 本樣本以將AccessKey ID和AccessKey Secret儲存在環境變數為例說明。您也可以根據業務需要，儲存到設定檔裡。
    Config config = new Config();
    // 必填，您的 AccessKey ID
    config.setAccessKeyId(System.getenv("MPAAS_AK_ENV"));
    // 必填，您的 AccessKey Secret
    config.setAccessKeySecret(System.getenv("MPAAS_SK_ENV"));
    // mPaaS 的 REGION_ID 和 Endpoint,以杭州非金為例
    config.setRegionId("cn-hangzhou");
    config.setEndpoint("mpaas.cn-hangzhou.aliyuncs.com");
    Client client = new Client(config);

    CreateOpenSingleDataRequest singleRequest = new CreateOpenSingleDataRequest();
    //*************必要屬性*************/
    
    // mPaaS 控制台擷取的 APPID
    singleRequest.setAppId("xxxxxxx");
    // mPaaS 控制台擷取的 WorkspaceId
    singleRequest.setWorkspaceId("xxxxxxxx");
    // mPaaS 控制台移動同步中配置的同步標識
    singleRequest.setBizType("TEST-SYNC");
    // 需要推送的使用者識別碼 或者裝置識別碼（UTDID）
    singleRequest.setLinkToken("testUserId");
    // 實際業務訊息體，自訂長度不超過 4096
    singleRequest.setPayload("testPayload");
    // 業務 ID，保證唯一，長度不超過 100
    singleRequest.setThirdMsgId("test_third_msg_id_" + System.currentTimeMillis());

    //************非必要屬性*************/
    
    // 推送目標裝置的作業系統 iOS 或 Android 為空白時不限制作業系統
    singleRequest.setOsType("IOS");
    // 持的最小用戶端版本號碼，如：8.6.0.0.9999 ，可為空白，為空白將不限制最小版本號碼
    singleRequest.setAppMinVersion("0.0.0.0");
    // 支援的最大用戶端版本號碼，如：9.0.0.0.9999，可為空白，為空白將不限制最大版本號碼
    singleRequest.setAppMaxVersion("100.100.100.100");
    // 有效期間開始，可為空白，為空白時不限制有效起始時間
    singleRequest.setValidTimeStart(System.currentTimeMillis());
    // 有效期間結束，可為空白，為空白時不限制有效結束時間 最長有效期間為 30 天
    singleRequest.setValidTimeEnd(System.currentTimeMillis() + (1000 * 3600));

    CreateOpenSingleDataResponse openSingleData = client.createOpenSingleData(singleRequest);
    System.out.println("response==>"+JSON.toJSONString(openSingleData));
}

全域（網）資料同步介面

全域（網）資料同步是指將資料同步到所有裝置。

參數說明

業務參數資訊如下：

全域（網）資料同步結果碼

程式碼範例

import com.alibaba.fastjson.JSON;
import com.aliyun.mpaas20201028.Client;
import com.aliyun.mpaas20201028.models.CreateOpenGlobalDataRequest;
import com.aliyun.mpaas20201028.models.CreateOpenGlobalDataResponse;
import com.aliyun.teaopenapi.models.Config;

public static void main(String[] args) throws Exception {
    // 阿里雲帳號AccessKey擁有所有API的存取權限，建議您使用RAM使用者進行API訪問或日常營運。
    // 強烈建議不要把AccessKey ID和AccessKey Secret儲存到工程代碼裡，否則可能導致AccessKey泄露，威脅您帳號下所有資源的安全。
    // 本樣本以將AccessKey ID和AccessKey Secret儲存在環境變數為例說明。您也可以根據業務需要，儲存到設定檔裡。
    Config config = new Config();
    // 必填，您的 AccessKey ID
    config.setAccessKeyId(System.getenv("MPAAS_AK_ENV"));
    // 必填，您的 AccessKey Secret
    config.setAccessKeySecret(System.getenv("MPAAS_SK_ENV"));
    // mPaaS 的 REGION_ID 和 Endpoint,以杭州非金為例
    config.setRegionId("cn-hangzhou");
    config.setEndpoint("mpaas.cn-hangzhou.aliyuncs.com");
    Client client = new Client(config);

    CreateOpenGlobalDataRequest globalRequest = new CreateOpenGlobalDataRequest();
    //************必要屬性*************/

    // mPaaS 控制台擷取的 APPID
    globalRequest.setAppId("BE9C457161429");
    // mPaaS 控制台擷取的 WorkspaceId
    globalRequest.setWorkspaceId("sit");
    // mPaaS 控制台移動同步中配置的同步標識
    globalRequest.setBizType("test-global");
    // 實際業務訊息體，自訂長度不超過 4096
    globalRequest.setPayload("testtestata");
    // 業務 ID，保證唯一，長度不超過 100
    globalRequest.setThirdMsgId("test_third_msg_id_" + System.currentTimeMillis());

    //************非必要屬性*************/

    // 推送目標裝置的作業系統 iOS 或 Android 為空白時不限制作業系統
    globalRequest.setOsType("IOS");
    // 持的最小用戶端版本號碼，如：8.6.0.0.9999 ，可為空白 為空白將不限制最小版本號碼
    globalRequest.setAppMinVersion("0.0.0.0");
    // 支援的最大用戶端版本號碼，如：9.0.0.0.9999，可為空白 為空白將不限制最大版本號碼

    globalRequest.setAppMaxVersion("100.100.100.100");
    // 最大 Uid
    globalRequest.setMaxUid(Long.valueOf(99));
    // 最小 Uid
    globalRequest.setMinUid(Long.valueOf(1));
    // 需要推送的灰階 Uid 00~99,字串數組
    globalRequest.setUids("01,02,99");

    globalRequest.setValidTimeStart(System.currentTimeMillis());
    globalRequest.setValidTimeEnd(System.currentTimeMillis() + (1000 * 3600));
    CreateOpenGlobalDataResponse openGlobalData = client.createOpenGlobalData(globalRequest);
    System.out.println("response==>"+JSON.toJSONString(openGlobalData));
}