首页 阿里云SDK 开发参考 Java SDK V2.0 Java SDK(推荐)

V2.0 Java SDK(推荐)

更新时间: 2025-08-14 09:41:09

本文将为您详细介绍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服务接入点。

使用日志服务SDK(sls20201230)时,默认情况下采用公网服务接入点。您可以通过以下可选值选择不同的服务接入点:

  • intranet:表示获取日志服务的VPC接入点。

  • accelerate:表示获取日志服务的传输加速的服务入口。

maxIdleConns

连接池中允许保持的最大空闲(未被使用)数据库连接数量,当连接数超过该值时,超出部分的空闲连接将被关闭以释放资源,默认值为5。详细信息,请参见HTTP连接池配置

protocol

请求协议,支持HTTPS和HTTP,默认值为HTTPS。详细信息,请参见HTTPS 请求配置

readTimeout

读超时,默认值为10000毫秒。详细信息,请参见超时机制

connectTimeout

连接超时,默认值为5000毫秒。详细信息,请参见超时机制

httpProxy

用于指定代理服务器地址与端口,格式为http://proxyServer:port。详细信息,请参见代理配置

httpsProxy

用于指定代理服务器地址与端口,格式为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

用于指定代理服务器地址与端口,格式为http://proxyServer:port。详细信息,请参见代理配置

httpsProxy

用于指定代理服务器地址与端口,格式为https://username:password@proxyServer:port,若无需代理认证,格式为https://proxyServer:port。详细信息,请参见代理配置

noProxy

用于指定无需通过代理访问的地址列表,多个地址之间用逗号分隔,支持域名和IP地址格式。详细信息,请参见代理配置

上一篇: 通过IDE使用阿里云Java SDK 下一篇: 同步与异步模式