# Java SDK
本章节介绍天筹求解器服务Java SDK，您可以参考本章节进行快速集成开发。
#### 准备工作
- 已注册华为云账号，并完成实名认证，账号不能处于欠费或冻结状态。
- 已具备开发环境，支持Java JDK 1.8 及其以上版本。。
- 登录"[我的凭证](https://console.huaweicloud.com/iam/#/myCredential)"页面，获取"IAM用户名""、账号名"以及待使用区域的"项目ID"。。
  调用服务时会用到这些信息，请提前保存。
  本样例以"华北-北京四"区域为例，获取对应的项目ID（project_id）。
  图1我的凭证   
  ![](https://support.huaweicloud.com/sdkreference-optverse/figure/zh-cn_image_0000001812783980.png) 
 
#### 安装SDK
推荐您通过Maven方式获取和安装SDK，首先需要在您的操作系统中[下载](https://maven.apache.org/download.cgi)并[安装](https://maven.apache.org/install.html)Maven，安装完成后您只需要在Java项目的pom.xml文件中加入相应的依赖项即可。
使用SDK前，需要安装"huaweicloud-sdk-core"和"huaweicloud-sdk-optverse"。SDK的版本信息请参见[SDK中心](https://sdkcenter.developer.huaweicloud.com/?product=CBS&language=java)。
```
<dependency>
   <groupId>com.huaweicloud.sdk</groupId>
   <artifactId>huaweicloud-sdk-core</artifactId>
   <version>3.1.134</version>
</dependency>
<dependency>
   <groupId>com.huaweicloud.sdk</groupId>
   <artifactId>huaweicloud-sdk-optverse</artifactId>
   <version>3.1.140</version>
</dependency>
```
#### 开始使用
详细的SDK介绍，使用异步客户端，配置日志请参见[SDK中心](https://sdkcenter.developer.huaweicloud.com/?product=CBS&language=java)、[Java SDK使用指导](https://github.com/huaweicloud/huaweicloud-sdk-java-v3/blob/master/README_CN.md)、[Java SDK使用视频](https://res-static.hc-cdn.cn/cloudbu-site/china/zh-cn/support/sdk-video/1620783979754083351.mp4)。
1. 导入依赖模块
   ```
   import com.huaweicloud.sdk.core.auth.ICredential;
   // 对用户身份进行认证
   import com.huaweicloud.sdk.core.auth.BasicCredentials;
   // Http配置 
   import com.huaweicloud.sdk.core.http.HttpConfig;
   // 请求异常类
   import com.huaweicloud.sdk.core.exception.ConnectionException;
   import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
   import com.huaweicloud.sdk.core.exception.ServiceResponseException;
   // 导入optverse sdk
   import com.huaweicloud.sdk.optverse.v2.region.OptVerseRegion;
   import com.huaweicloud.sdk.optverse.v2.*;
   import com.huaweicloud.sdk.optverse.v2.model.*;
   ```
   
2. 配置客户端连接参数
   - 默认配置
     ```
     // 使用默认配置
     HttpConfig config = HttpConfig.getDefaultHttpConfig();
     ```
     
   
   - 网络配置（可选）
     ```
     // 根据需要配置代理，默认的协议为 `http` 协议
     config.withProxyHost("proxy.huaweicloud.com")
         .withProxyPort(8080)
         .withProxyUsername("test")
         .withProxyPassword("test");
     ```
     
   
   - 超时配置（可选）
     ```
     // 默认连接超时时间为60秒，可根据需要调整
     config.withTimeout(60);
     ```
     
   
   - SSL配置（可选）
     ```
     // 根据需要配置是否跳过SSL证书验证
     config.withIgnoreSSLVerification(true);
     ```
     
    
3. 配置认证信息
   - ak、sk：访问密钥信息，获取方法请参见[获取AK/SK](https://support.huaweicloud.com/devg-apisign/api-sign-provide-aksk.html)。
   
   - project_id：华为云项目ID，获取方法请参见[准备工作](https://support.huaweicloud.com/sdkreference-optverse/nottoctopics/zh-cn_topic_0000001241710438.html#ZH-CN_TOPIC_0000001241710438__section13676174884)。
    
4. 初始化客户端
   - 指定region方式（推荐）
     ```
     // 增加region依赖
     import com.huaweicloud.sdk.optverse.v2.region.OptVerseRegion;
     // 初始化客户端认证信息，使用当前客户端初始化方式可不填 projectId/domainId，以初始化 BasicCredentials 为例
     BasicCredentials basicCredentials = new BasicCredentials()
         .withAk(ak)
         .withSk(sk);
     // 初始化指定云服务的客户端 {Service}Client ，以初始化 Region 级服务OptVerse的 OptVerseClient 为例
     OptVerseClient client = OptVerseClient.newBuilder()
         .withHttpConfig(config)
         .withCredential(basicCredentials)
         .withRegion(OptVerseRegion.valueOf("cn-north-4"))
         .build();
     ```
     
   
   - 指定云服务endpoint方式
     ```
     // 指定终端节点，以OptVerse服务北京四的 endpoint 为例
     String endpoint = "https://optverse.cn-north-4.myhuaweicloud.com";
     // 初始化客户端认证信息，需要填写相应 projectId/domainId，以初始化 BasicCredentials 为例
     BasicCredentials basicCredentials = new BasicCredentials()
         .withAk(ak)
         .withSk(sk)
         .withProjectId(projectId);
     // 初始化指定云服务的客户端 {Service}Client ，以初始化 Region 级服务OptVerse的 OptVerseClient 为例
     OptVerseClient client = OptVerseClient.newBuilder()
         .withHttpConfig(config)
         .withCredential(basicCredentials)
         .withEndpoint(endpoint)
         .build();
     ```
     endpoint是华为云各服务应用区域和各服务的终端节点，详情请查看 [地区和终端节点](https://developer.huaweicloud.com/endpoint?CBS) 。
     
    

5. 发送请求并查看响应
   ```
   // 以调用天筹求解器查询任务列表接口ListTask为例
   ListTaskRequest request = new ListTaskRequest();
   request.withServiceType("irregular-textile");
   ```
   

6. 异常处理
   表1异常处理 
   | 一级分类                     | 一级分类说明  | 二级分类                       | 二级分类说明                       |
   |:---|:---|:---|:---|
   | ConnectionException      | 连接类异常   | HostUnreachableException   | 网络不可达、被拒绝。                   |
   | ConnectionException      | 连接类异常   | SslHandShakeException      | SSL认证异常。                     |
   | ConnectionException      | 连接类异常   | ConnectionTimeoutException | 连接超时异常。                      |
   | RequestTimeoutException  | 响应超时异常  | CallTimeoutException       | 单次请求，服务器处理超时未返回，包括读写超时等异常。   |
   | RequestTimeoutException  | 响应超时异常  | RetryOutageException       | 在重试策略消耗完成后，仍无有效的响应。          |
   | ServiceResponseException | 服务器响应异常 | ServerResponseException    | 服务端内部错误，Http响应码：\[500,\]。    |
   | ServiceResponseException | 服务器响应异常 | ClientRequestException     | 请求参数不合法，Http响应码：\[400, 500)。 |
      
   ```
   // 异常处理
   try {
       ListTaskRequest request = new ListTaskRequest();
       ListTaskResponse response = client.listTask(request);
       System.out.println(response.toString());
   } catch (ServiceResponseException e) {
       e.printStackTrace();
       logger.error("HttpStatusCode: " + e.getHttpStatusCode());
       logger.error("RequestId: " + e.getRequestId());
       logger.error("ErrorCode: " + e.getErrorCode());
       logger.error("ErrorMsg: " + e.getErrorMsg());
   }
   ```
   
#### 自动生成SDK代码示例
[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/OptVerse/doc?api=CreateTask)提供API检索及平台调试，支持全量快速检索、可视化调试、帮助文档查看、在线咨询。
您只需要在API Explorer中修改接口参数，即可自动生成对应的代码示例。同时，可在集成开发环境CloudIDE中完成代码的构建、调试、运行等操作。
图2API Explorer   
![](https://support.huaweicloud.com/sdkreference-optverse/figure/zh-cn_image_0000002224347234.png)