使用Java客户端

该章节内容仅适用于6.4.1及后续版本

这是我们为Java开发者提供的HTTP API客户端开发工具包（AWS HTTP SDK for Java API工具包），可以简化对HTTP API的使用，也无需考虑URL签名过程。

环境准备

该客户端使用JDK自带的http协议类库，并依赖以下资源文件：

• aws-api-client.jar
• 用于json序列化的fastJSON类库

aws-api-client.jar

在AWS CC的文档 > Web API页面，下方链接提供类库和源码下载。

用于json序列化的fastJSON类库

fastJSON类库用于处理json到Java对象的转换处理。建议使用AWS PaaS平台默认提供的相关资源：

* webserver/webapps/portal/WEB-INF/lib/fastjson-1.2.51.jar

获得API自动生成的JAVA客户端示例代码

每个HTTP API都提供了Java客户端示例代码，步骤如下：

1. 登录您的AWS PaaS实例控制台
2. 访问“连接服务”页面
3. 切换“文档”页面
4. 点击“Web API”选择某类API
5. 在打开窗口方法列表，点击JAVA链接

OpenApiClient构造函数

//返回JSON结果
OpenApiClient client = new OpenApiClient(apiServer, accessKey, secret,OpenApiClient.FORMAT_JSON);

//返回XML结果
OpenApiClient client = new OpenApiClient(apiServer, accessKey, secret,OpenApiClient.FORMAT_XML);

//返回对象结果（不同API封装的结果对象不同，见示例代码）
OpenApiClient client = new OpenApiClient(apiServer, accessKey, secret);
BoolResponse r = client.exec(apiMethod, args, BoolResponse.class);

示例

//API入口
String apiServer = "https://b2b.awspaas.com/api";
String accessKey = "Salesforce#1";
String secret = "0a799959-8327";//注意保密
String apiMethod = "bo.query";//API方法，cmd参数

//API请求参数
Map<String, Object> args = new HashMap<String, Object>();
args.put("boName","BO_ACT_TEST" );

//构建客户端
OpenApiClient client = new OpenApiClient(apiServer, accessKey, secret);
//执行并获得查询结果
ListMapResponse r = client.exec(apiMethod, args, ListMapResponse.class);
List bos = r.getData();
if (bos != null) {
    for(int i=0;i<bos.size();i++){
    //...
    }
}