Mobile Platform as a Service：Java SDK 接入

引入 Jar 包

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

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>aliyun-java-sdk-mpaas</artifactId>
    <version>3.0.10</version>
</dependency>
<dependency>
<groupId>com.aliyun</groupId>
  <artifactId>aliyun-java-sdk-core</artifactId>
  <optional>true</optional>
  <version>[4.3.2,5.0.0)</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.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.mpaas.model.v20201028.CreateOpenSingleDataRequest;
import com.aliyuncs.mpaas.model.v20201028.CreateOpenSingleDataResponse;
import com.aliyuncs.profile.DefaultProfile;
import org.apache.commons.lang3.builder.ToStringBuilder;
import org.apache.commons.lang3.builder.ToStringStyle;

public class MsyncPopDemo {

    public static void main(String[] args) {
        //請求資訊，除 AccessKey ID  AccessKey Secret 外固定即可
        DefaultProfile.addEndpoint("cn-hangzhou", "mpaas", "mpaas.cn-hangzhou.aliyuncs.com");

        // 阿里雲帳號AccessKey擁有所有API的存取權限，建議您使用RAM使用者進行API訪問或日常營運。
        // 強烈建議不要把AccessKey ID和AccessKey Secret儲存到工程代碼裡，否則可能導致AccessKey泄露，威脅您帳號下所有資源的安全。
        // 本樣本以將AccessKey ID和AccessKey Secret儲存在環境變數為例說明。您也可以根據業務需要，儲存到設定檔裡。
        String accessKeyId = System.getenv("MPAAS_AK_ENV");
        String accessKeySecret = System.getenv("MPAAS_SK_ENV");

        // 建立 DefaultAcsClient 執行個體並初始化
        DefaultProfile profile = DefaultProfile.getProfile(
                "cn-hangzhou", // 地區 ID
                accessKeyId,   // RAM 帳號的 AccessKey ID
                accessKeySecret);  // RAM 帳號的 AccessKey Secret
        IAcsClient client = new DefaultAcsClient(profile);

        CreateOpenSingleDataRequest singleRequest = constructSingleRequest();

        CreateOpenSingleDataResponse singleDataResponse;
        try {
            singleDataResponse = client.getAcsResponse(singleRequest);
            System.out.println("singleDataResponse:" +
                    ToStringBuilder
                            .reflectionToString(singleDataResponse, ToStringStyle.SHORT_PREFIX_STYLE));

        } catch (Throwable throwable) {
            throwable.printStackTrace();
        }
    }

    private static CreateOpenSingleDataRequest constructSingleRequest() {

        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));

        return singleRequest;

    }

全域（網）資料同步介面

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

參數說明

業務參數資訊如下：

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

程式碼範例

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.mpaas.model.v20201028.CreateOpenGlobalDataRequest;
import com.aliyuncs.mpaas.model.v20201028.CreateOpenGlobalDataResponse;
import com.aliyuncs.profile.DefaultProfile;
import org.apache.commons.lang3.builder.ToStringBuilder;
import org.apache.commons.lang3.builder.ToStringStyle;

public class MsyncPopDemo {

    public static void main(String[] args) {
        //請求資訊，除 AccessKey ID  AccessKey Secret 外固定即可
        DefaultProfile.addEndpoint("cn-hangzhou", "mpaas", "mpaas.cn-hangzhou.aliyuncs.com");

        // 阿里雲帳號AccessKey擁有所有API的存取權限，建議您使用RAM使用者進行API訪問或日常營運。
        // 強烈建議不要把AccessKey ID和AccessKey Secret儲存到工程代碼裡，否則可能導致AccessKey泄露，威脅您帳號下所有資源的安全。
        // 本樣本以將AccessKey ID和AccessKey Secret儲存在環境變數為例說明。您也可以根據業務需要，儲存到設定檔裡。
        String accessKeyId = System.getenv("MPAAS_AK_ENV");
        String accessKeySecret = System.getenv("MPAAS_SK_ENV");

        // 建立 DefaultAcsClient 執行個體並初始化
        DefaultProfile profile = DefaultProfile.getProfile(
                "cn-hangzhou", // 地區 ID
                accessKeyId,   // RAM 帳號的 AccessKey ID
                accessKeySecret);  // RAM 帳號的 AccessKey Secret
        IAcsClient client = new DefaultAcsClient(profile);

        CreateOpenGlobalDataRequest globalDataRequest = constuctGlobelRequest();

        CreateOpenGlobalDataResponse globalDataResponse;
        try {
            globalDataResponse = client.getAcsResponse(globalDataRequest);
            System.out.println("globalDataResponse:" +
                    ToStringBuilder
                            .reflectionToString(globalDataResponse, ToStringStyle.SHORT_PREFIX_STYLE));

        } catch (Throwable throwable) {
            throwable.printStackTrace();
        }
    }

    private static CreateOpenGlobalDataRequest constuctGlobelRequest() {

        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));

        return globalRequest;

    }

}