简介
欢迎使用 TBaaS 产品开发者工具套件(SDK)3.0,SDK3.0 是云 API3.0 平台的配套工具。为方便 Java 开发者调试和接入 TBaaS 产品 API,这里向您介绍适用于 Java 的 TBaaS 产品开发工具包,并提供首次使用开发工具包的简单示例。让您快速获取 TBaaS 产品 Java SDK 并开始调用。
依赖环境
1. 依赖环境:JDK 7版本及以上。
2. 通过腾讯云控制台开通 TBaaS 产品。
3. 获取 SecretID、SecretKey 以及调用地址(tbaas.tencentcloudapi.com)。
获取安装
安装 Java SDK 和第一次使用云 API 之前,用户需要在腾讯云控制台上申请并获取安全凭证。安全凭证包括 SecretID 和 SecretKey。 SecretID 用于标识 API 调用者的身份,SecretKey 用于加密签名字符串和服务器端验证签名字符串的密钥。SecretKey 必须严格保管,避免泄露。
通过 Maven 安装(推荐)
1. 前往 Maven 官网 下载对应系统的 Maven 安装包,并进行安装。
2. 在 Maven pom.xml 添加以下内容,为您的项目添加 Maven 依赖项。
<dependency><groupId>com.tencentcloudapi</groupId><artifactId>tencentcloud-sdk-java</artifactId><version>3.0.1</version></dependency>
说明
<version> 标签中的版本号为参考示例,请在 Maven 仓库上找到最新的版本进行填写。
3. 引用方法可参考 示例。
通过源码包安装
1. 前往 Github 代码托管地址 下载源码压缩包。
2. 将获取到的源码包解压缩到您项目合适的位置。
3. 将 vendor 目录下的 jar 包拷贝到 Java 可找到的路径中。
4. 引用方法可参考 示例。
接口列表
示例
以新增交易(Invoke)接口为例:
import com.tencentcloudapi.common.Credential;import com.tencentcloudapi.common.profile.ClientProfile;import com.tencentcloudapi.common.profile.HttpProfile;import com.tencentcloudapi.common.exception.TencentCloudSDKException;// 导入对应产品模块的clientimport com.tencentcloudapi.tbaas.v20180416.TbaasClient;// 导入要请求接口对应的request response类import com.tencentcloudapi.tbaas.v20180416.models.InvokeRequest;import com.tencentcloudapi.tbaas.v20180416.models.InvokeResponse;public class InvokeTransaction{public static void main(String [] args) {try{// 实例化一个认证对象,入参需要传入腾讯云账户密钥对secretId,secretKeyCredential cred = new Credential("secretId", "secretKey");// 设置访问域名// SDK会自动指定域名。通常是不需要特地指定域名的,但是如果您访问的是金融区的服务,// 则必须手动指定域名,例如云服务器的上海金融区域名: tbaas.ap-shanghai-fsi.tencentcloudapi.comHttpProfile httpProfile = new HttpProfile();httpProfile.setEndpoint("tbaas.tencentcloudapi.com");// 实例化Tbaas的client对象ClientProfile clientProfile = new ClientProfile();clientProfile.setHttpProfile(httpProfile);// 第二个参数是地域信息,根据资源所属地域填写相应的地域信息,例如广州地域的资源可以直接填写字符串ap-guangzhou,或者引用预设的常量TbaasClient client = new TbaasClient(cred, "ap-guangzhou", clientProfile);// 实例化一个请求对象,根据调用的接口和实际情况,可以进一步设置请求参数String params = "{\\"Module\\":\\"transaction\\",\\"Operation\\":\\"invoke\\",\\"ClusterId\\":\\"251005746ctestenv\\",\\"ChaincodeName\\":\\"pettycc1\\",\\"ChannelName\\":\\"pettyc1\\",\\"Peers\\":[{\\"PeerName\\":\\"peer0.pettycorg.ctestenv\\",\\"OrgName\\":\\"pettycOrg\\"}],\\"FuncName\\":\\"invoke\\",\\"Args\\":[\\"a\\",\\"b\\",\\"10\\"],\\"AsyncFlag\\":0,\\"GroupName\\":\\"pettycOrg\\"}";InvokeRequest req = InvokeRequest.fromJsonString(params, InvokeRequest.class);// 通过client对象调用想要访问的接口,需要传入请求对象InvokeResponse resp = client.Invoke(req);// 输出json格式的字符串回包System.out.println(InvokeResponse.toJsonString(resp));} catch (TencentCloudSDKException e) {System.out.println(e.toString());}}}