Java SDK入门指南

前提条件

本文旨在帮助您快速获取百度智能云Java SDK并开始调用。

前提条件

开发前请确保下述前提条件已准备就绪:

  • Java SDK工具包可在jdk1.6,jdk1.7,jdk1.8环境下运行。

  • AK/SK:SDK 认证时必须传入 AK/SK 参数,在安全认证页面 获取 Access Key和Secret Key。

    用户可以通过两种方式与百度智能云进行交互,包括认证方式和匿名方式。对于认证方式,需要通过使用Access Key Id / Secret Access Key加密的方法来验证某个请求的发送者身份。Access Key Id(AK)用于标示用户,Secret Access Key(SK)是用户用于加密认证字符串和百度智能云用来验证认证字符串的密钥,其中SK必须保密,只有用户和百度智能云知道。

安装SDK包

  • 方式一:使用Maven的安装

    在Maven的pom.xml中的文件中添加BCE-Java的SDK的依赖:

    <dependency>
        <groupId>com.baidubce</groupId>
        <artifactId>bce-java-sdk</artifactId>
        <version>{version}</version>
    </dependency>
    

    其中,{version}为版本号,可以在SDK页面下载找到。

  • 方式二:直接使用JAR包安装

    百度智能云官网下载Java SDK压缩工具包。将的bce-java-sdk-version.zip解压后,复制到工程文件夹中。

    在Eclipse右键“工程 - >属性 - > Java构建路径 - >添加JAR”。

    添加SDK包工具lib/bce-java-sdk-version.jar状语从句:第三方依赖工具包third-party/*.jar。

    其中,version为版本号。

SDK目录结构

com.baidubce
       ├── auth                                        //BCE签名相关类
       ├── http                                        //BCE的Http通信相关类
       ├── internal                                    //SDK内部类
       ├── model                                       //BCE公用model类
       ├── services
       │       └── iotdm                               //以物管理服务举例
       │           ├── model                           //物管理内部model,如Request或Response
       │           └── IotDmV3Client.class               //以物管理服务举例,物管理客户端入口类
       ├── util                                        //BCE公用工具类
       ├── BceClientConfiguration.class                //对BCE的HttpClient的配置
       ├── BceClientException.class                    //BCE客户端的异常类
       ├── BceServiceException.class                   //与BCE服务端交互后的异常类
       ├── ErrorCode.class                             //BCE通用的错误码
       └── Region.class                                //BCE提供服务的区域

使用Java SDK

调用Java SDK的3个主要步骤:

  • 创建并初始化xxxClient,百度智能云服务分别配置了详细的Java SDK 帮助指南,详细请参考产品指南。
  • 创建API请求并设置参数。
  • 发起请求并处理应答或异常。