Mobile Platform as a Service:Java SDK とサービスの統合

このトピックでは、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 システムを再起動します。

API の説明

単一データ同期インターフェイス

単一データ同期インターフェイスは、指定されたユーザーまたはデバイスにデータを同期するために使用されます。

パラメーター

ビジネス パラメーターは次のとおりです。

結果コード

サンプル コード

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

        // Alibaba Cloud アカウント AccessKey には、すべての API へのアクセス権があります。API アクセスまたは日常の運用と保守には、RAM ユーザーを使用することをお勧めします。
        // 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 コンソールから取得した App ID
        singleRequest.setAppId("xxxxxxx");
        // mPaaS コンソールから取得した WorkspaceId
        singleRequest.setWorkspaceId("xxxxxxxx");
        // mPaaS コンソールでモバイル同期中に構成された同期識別子
        singleRequest.setBizType("TEST-SYNC");
        // プッシュされるユーザー ID またはデバイス ID（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;

    }

グローバル データ同期インターフェイス

グローバル データ同期インターフェイスは、すべてのデバイスにデータを同期するために使用されます。

パラメーター

ビジネス パラメーターは次のとおりです。

結果コード

サンプル コード

public static void main(String[] args) {

        // 要求情報。AccessKey ID と AccessKey Secret 以外は固定です。
        DefaultProfile.addEndpoint("cn-hongkong", "mpaas", "mpaas.cn-hongkong.aliyuncs.com");
        // DefaultAcsClient インスタンスを作成し、初期化します。
        DefaultProfile profile = DefaultProfile.getProfile(
            "cn-hongkong", // リージョン ID
            "xxxxxx", // RAM アカウントの AccessKey ID
            "xxxxxx"); // 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 (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            e.printStackTrace();
        } catch (com.aliyuncs.exceptions.ClientException e) {
            e.printStackTrace();
        } catch (Throwable throwable) {
            throwable.printStackTrace();
        }
    }

 private static CreateOpenGlobalDataRequest constuctGlobelRequest() {

        CreateOpenGlobalDataRequest globalRequest
            = new CreateOpenGlobalDataRequest();

        // *************必須プロパティ*************/
        // mPaaS コンソールから取得した App ID
        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;

    }