全部產品
Search
文件中心

Alibaba Cloud SDK:V2.0 Java SDK(推薦)

更新時間:Aug 15, 2025

本文將為您詳細介紹V2.0 SDK中所涉及的公用依賴包,以及在開發過程中所使用的配置類資訊,協助您減少在開發過程中解決報錯問題所需的時間,提升開發效率。

公用依賴包

在V2.0 SDK中,大部分雲產品所需的公用依賴包如下所示,最新版本可從Maven倉庫擷取。當您在專案中遇到包衝突時,可以手動在專案中添加最新版本的依賴包。

說明

在正常情況下,列表中所列的包會在安裝雲產品SDK時自動安裝。若在使用過程中出現錯誤,建議手動添加最新版本。

包名

Maven地址

GitHub代碼倉庫地址

tea-util

Maven Central: com.aliyun:tea-util

tea-util

tea

Maven Central: com.aliyun:tea

tea-java

credentials-java

Maven Central: com.aliyun:credentials-java

credentials-java

credentials-api

Maven Central: com.aliyun:credentials-api

credentials-api

openapiutil

Maven Central: com.aliyun:openapiutil

openapiutil

alibabacloud-gateway-spi

Maven Central: com.aliyun:alibabacloud-gateway-spi

alibabacloud-gateway-spi

tea-xml

Maven Central: com.aliyun:tea-xml

tea-xml

tea-openapi

Maven Central: com.aliyun:tea-openapi

tea-openapi

配置類介紹

com.aliyun.teaopenapi.models.Config

該類主要用於配置全域參數,例如配置憑據資訊、Endpoint、代理配置、逾時配置等,相關參數的具體介紹如下:

說明

未在表格中列出的參數,可能由於已被棄用或暫無實際意義,因此不建議使用。

參數名稱

描述

credential

憑據用戶端,V2.0 SDK的憑據資訊統一由credentials工具管理。詳細資料,請參見管理訪問憑據

accessKeyId

Accesskey ID。與credential參數二選一設定,若同時設定credentialaccessKeyId,則使用credential中的憑據。

accessKeySecret

Accesskey Secret。與credential參數二選一設定,若同時設定credentialaccessKeySecret,則使用credential中的憑據。

securityToken

STS Token。與credential參數二選一設定,若同時設定credentialsecurityToken,則使用credential中的憑據。

bearerToken

bearer Token。與credential參數二選一設定,若同時設定credentialbearerToken,則使用credential中的憑據。

endpoint

雲上資源所在地區對應的服務存取點,您可以通過該服務存取點調用API以訪問雲上資源。詳細資料,請參見Endpoint配置

regionId

雲上資源所在的地區。當未設定endpoint參數時,可以通過配置該參數來擷取與regionId對應的服務存取點。詳細資料,請參見Endpoint配置

network

在設定regionId時,可以通過該參數指定擷取的服務存取點類型,預設情況下採用公網服務存取點。可選值如下:

  • vpc:表示擷取VPC服務存取點。

使用Log ServiceSDK(sls20201230)時,預設情況下採用公網服務存取點。您可以通過以下可選值選擇不同的服務存取點:

  • intranet:表示擷取Log Service的VPC存取點。

  • accelerate:表示擷取Log Service的傳輸加速的服務入口。

maxIdleConns

串連池中允許保持的最大空閑(未被使用)資料庫連接數量,當串連數超過該值時,超出部分的空閑串連將被關閉以釋放資源,預設值為5。詳細資料,請參見HTTP串連池配置

protocol

請求協議,支援HTTPS和HTTP,預設值為HTTPS。詳細資料,請參見HTTPS請求配置

readTimeout

讀逾時,預設值為10000毫秒。詳細資料,請參見逾時機制

connectTimeout

連線逾時,預設值為5000毫秒。詳細資料,請參見逾時機制

httpProxy

用於指定Proxy 伺服器地址與連接埠,格式為http://proxyServer:port。詳細資料,請參見代理配置

httpsProxy

用於指定Proxy 伺服器地址與連接埠,格式為https://username:password@proxyServer:port,若無需代理認證,格式為https://proxyServer:port。詳細資料,請參見代理配置

noProxy

用於指定無需通過代理訪問的地址清單,多個地址之間用逗號分隔,支援網域名稱和IP地址格式。詳細資料,請參見代理配置

com.aliyun.teautil.models.RuntimeOptions

該類主要用於配置某個API請求的運行時參數,例如代理配置、逾時配置等,相關參數的具體介紹如下:

說明

未在表格中列出的參數,可能由於已被棄用或暫無實際意義,因此不建議使用。

參數名稱

描述

autoretry

是否啟用重試功能。該功能僅適用於因網路問題導致的報錯,預設值為false,表示不啟用重試功能。詳細資料,請參見重試機制

maxAttempts

當啟用重試功能時,可通過該參數設定重試次數,預設為3次。詳細資料,請參見重試機制

maxIdleConns

串連池中允許保持的最大空閑(未被使用)資料庫連接數量,當串連數超過該值時,超出部分的空閑串連將被關閉以釋放資源,預設值為5。詳細資料,請參見HTTP串連池配置

ignoreSSL

protocol值為HTTPS時,SDK將預設啟用SSL/TLS認證有效性校正。若您的代碼運行環境未配置SSL/TLS認證,可以通過該參數臨時忽略認證校正。預設值為false,表示需進行SSL/TLS認證有效性校正。詳細資料,請參見HTTPS請求配置

說明

為保障生產環境通訊安全,建議您開啟認證有效性校正。

readTimeout

讀逾時,預設值為10000毫秒。詳細資料,請參見逾時機制

connectTimeout

連線逾時,預設值為5000毫秒。詳細資料,請參見逾時機制

httpProxy

用於指定Proxy 伺服器地址與連接埠,格式為http://proxyServer:port。詳細資料,請參見代理配置

httpsProxy

用於指定Proxy 伺服器地址與連接埠,格式為https://username:password@proxyServer:port,若無需代理認證,格式為https://proxyServer:port。詳細資料,請參見代理配置

noProxy

用於指定無需通過代理訪問的地址清單,多個地址之間用逗號分隔,支援網域名稱和IP地址格式。詳細資料,請參見代理配置