新しいバージョンの 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 パッケージには他のクラスが含まれています。
プロファイルオブジェクトを作成します。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);クライアント オブジェクトを作成する: 以前に作成した IClientProfile プロファイルから client という名前の IAcsClient オブジェクトを作成します。後続のレスポンスは IClientProfile から取得されます。 このオブジェクトには、後で取得するレスポンス データが含まれています。
IAcsClient client = new DefaultAcsClient(profile);リクエスト クラスを作成する: メソッドに対応するリクエスト クラスを作成し、API メソッド名の末尾に Request を追加してクラスに名前を付けます。 たとえば、指定された注文の詳細をクエリする API メソッドの名前が GetOrderDetail の場合、対応するリクエスト クラス名は GetOrderDetailRequest です。 コンストラクターを使用して、デフォルトの記述クラスを生成します。
GetOrderDetailRequest request = new GetOrderDetailRequest();リクエスト パラメーターを指定する: セッター setXxx を使用して、必要な API パラメーターを指定します。 たとえば、GetOrderDetail API メソッドには OrderId パラメーターが必要です。 他のセッターを使用して、他のパラメーターを設定します。
request.setRequestId("123");IAcsClient オブジェクトを使用して、リクエストに対するレスポンスを取得します。
GetOrderDetailResponse response = client.getAcsResponse(request);レスポンスからレスポンス パラメーターを取得する: レスポンスでゲッター getXxx を呼び出して、レスポンス値を取得します。 これで呼び出しプロセスは終了です。