すべてのプロダクト
Search
ドキュメントセンター

:最新の Java SDK をインストールする

最終更新日:Jan 18, 2025

新しいバージョンの SDK のファイル名は、通常 aliyun-XXXX-sdk で始まり、その後にプロダクト名が続きます。たとえば、Alibaba Cloud BOA(BSS OpenAPI)の名前は aliyun-java-sdk-bssopenapi です。 aliyun-java-sdk-core コア パッケージには、IClientProfile、IAcsClient、例外クラスなど、すべてのプロダクト SDK で使用される特定のクラスがカプセル化されています。 クラスはプロダクトごとに異なる JAR パッケージにパッケージ化されています。

このサンプルでは、API メソッド GetOrderDetail を使用して、指定された注文の詳細をクエリします。 これを例として、Java SDK の使用方法のプロセスを説明します。 aliyun-java-sdk-core パッケージには IClientProfile クラスと IAcsClient クラスが含まれており、aliyun-java-sdk-ecs パッケージには他のクラスが含まれています。

  1. プロファイルオブジェクトを作成します。AccessKeyID、AccessKeySecret、およびデフォルトのリージョン情報を含む、IClientProfile クラスのインスタンスである profile を作成します。ap-southeast-1 は、BssOpenApi の唯一のリージョンです。

    // BssOpenApi のデフォルトのリージョン情報を設定する
    DefaultProfile.addEndpoint("ap-southeast-1","ap-southeast-1","BssOpenApi",
    "business.ap-southeast-1.aliyuncs.com"); 
    // #ak は AccessKey、aks は AccessKeySecret です
    IClientProfile profile = DefaultProfile.getProfile("ap-southeast-1", ak,  aks);
  2. クライアント オブジェクトを作成する: 以前に作成した IClientProfile プロファイルから client という名前の IAcsClient オブジェクトを作成します。後続のレスポンスは IClientProfile から取得されます。 このオブジェクトには、後で取得するレスポンス データが含まれています。

    IAcsClient client = new DefaultAcsClient(profile);
  3. リクエスト クラスを作成する: メソッドに対応するリクエスト クラスを作成し、API メソッド名の末尾に Request を追加してクラスに名前を付けます。 たとえば、指定された注文の詳細をクエリする API メソッドの名前が GetOrderDetail の場合、対応するリクエスト クラス名は GetOrderDetailRequest です。 コンストラクターを使用して、デフォルトの記述クラスを生成します。

    GetOrderDetailRequest request = new GetOrderDetailRequest();
  4. リクエスト パラメーターを指定する: セッター setXxx を使用して、必要な API パラメーターを指定します。 たとえば、GetOrderDetail API メソッドには OrderId パラメーターが必要です。 他のセッターを使用して、他のパラメーターを設定します。

    request.setRequestId("123");
  5. IAcsClient オブジェクトを使用して、リクエストに対するレスポンスを取得します。

    GetOrderDetailResponse response = client.getAcsResponse(request);

    レスポンスからレスポンス パラメーターを取得する: レスポンスでゲッター getXxx を呼び出して、レスポンス値を取得します。 これで呼び出しプロセスは終了です。