AWS PaaS API参考指南

使用Java客户端

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

环境准备

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

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

AWS 6.2.13及后续版本json类库调整为fastJSON

aws-api-client.jar

在AWS CC的服务接口文档首页提供类库和源码下载。

用于json序列化的fastJSON类库

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

* webserver/webapps/portal/WEB-INF/lib/jackson-core-2.4.1.jar
* webserver/webapps/portal/WEB-INF/lib/jackson-databind-2.4.1.jar
* webserver/webapps/portal/WEB-INF/lib/jackson-module-jaxb-annotations-2.5.2.jar
* webserver/webapps/portal/WEB-INF/lib/jackson-annotations-2.4.0.jar

AWS 6.2.13及后续版本json类库调整为fastJSON

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

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

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

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

说明
apiServer API入口,开发者应读取自己的配置。portal URL + /openapi,例如:https://b2b.awspaas.com/openapi
accessKey 访问凭证,开发者应读取自己的配置
secret 私钥,开发者应读取自己的加密配置
args API需要的业务参数
client.exec 执行API

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/openapi";
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++){
    //...
    }
}


Seven
 010-62962343-690
 liujx@actionsoft.com.cn
感谢您对该文档的关注!如果您对当前页面内容有疑问或好的建议,请与我联系。如果您需要解答相关技术问题请登录AWS客户成功社区