BecClient

更新时间：2020-10-29

初始化

BecClient是Bec服务的Java客户端，为开发者与BEC服务进行交互提供了一系列的方法。使用Java SDK发起BEC请求，您需要初始化一个BecClient实例，并根据需要修改BecClientConfiguration的默认配置项。

新建BecClient

使用AK/SK新建BecClient

通过AK/SK方式访问BEC，用户可以参考如下代码新建一个BecClient：

public class Sample {
    public static void main(String[] args) {
        String ACCESS_KEY_ID = <your-access-key-id>;                   // 用户的Access Key ID
        String SECRET_ACCESS_KEY = <your-secret-access-key>;           // 用户的Secret Access Key

        // 初始化一个BecClient
        BecClientConfiguration config = new BecClientConfiguration();
        config.setCredentials(new DefaultBceCredentials(ACCESS_KEY_ID, SECRET_ACCESS_KEY));
        BecClient client = new BecClient(config);
    }
}

在上面代码中，ACCESS_KEY_ID对应控制台中的“Access Key ID”，SECRET_ACCESS_KEY对应控制台中的“Access Key Secret”，获取方式请参考《操作指南管理ACCESSKEY》。

用户需要自己指定域名，可以通过传入ENDPOINT参数来指定。

String ACCESS_KEY_ID = <your-access-key-id>;                   // 用户的Access Key ID
String SECRET_ACCESS_KEY = <your-secret-access-key>;           // 用户的Secret Access Key
String ENDPOINT = <domain-name>;                               // 用户自己指定的域名

BecClientConfiguration config = new BecClientConfiguration();
config.setCredentials(new DefaultBceCredentials(ACCESS_KEY_ID,SECRET_ACCESS_KEY));
config.setEndpoint(ENDPOINT);
BecClient client = new BecClient(config);

注意：ENDPOINT参数用于指定域名，BEC API的服务域名为bec.baidubce.com。

配置HTTPS协议访问BEC

BEC支持HTTPS传输协议，您可以通过如下两种方式在BEC Java SDK中使用HTTPS访问BEC服务：

在endpoint中指明https:

 String endpoint = "http://bec.baidubce.com";
 String ak = "ak";
 String sk = "sk";
 BecClientConfiguration config = new BecClientConfiguration();
 config.setCredentials(new DefaultBceCredentials(ak, sk));
 BecClient client = new BecClient(config);

通过调用setProtocol方法设置https协议:

 String endpoint = "bec.baidubce.com"; // endpoint中不包含protocol
 String ak = "ak";
 String sk = "sk";
 BecClientConfiguration config = new BecClientConfiguration();
 config.setCredentials(new DefaultBceCredentials(ak, sk));
 config.setEndpoint(ENDPOINT);
 config.setProtocol(Protocol.HTTPS); // 如果不指明, 则使用http
 BecClient client = new BecClient(config);

注意： 如果在endpoint中指明了protocol, 则endpoint中的生效, 另外单独再调用setProtocol()不起作用。

设置网络参数

用户可以用BecClientConfiguration对基本网络参数进行设置：

 BecClientConfiguration config = new BecClientConfiguration();
   
 // 设置HTTP最大连接数为10
 config.setMaxConnections(10);
    
 // 设置TCP连接超时为5000毫秒
 config.setConnectionTimeout(5000);
    
 // 设置Socket传输数据超时的时间为2000毫秒
 config.setSocketTimeout(2000);

参数说明

通过BecClientConfiguration能指定的所有参数如下表所示：

参数	说明
UserAgent	用户代理，指HTTP的User-Agent头
Protocol	连接协议类型
ProxyDomain	访问NTLM验证的代理服务器的Windows域名
ProxyHost	代理服务器主机地址
ProxyPort	代理服务器端口
ProxyUsername	代理服务器验证的用户名
ProxyPassword	代理服务器验证的密码
ProxyPreemptiveAuthenticationEnabled	是否设置用户代理认证
ProxyWorkstation	NTLM代理服务器的Windows工作站名称
LocalAddress	本地地址
ConnectionTimeoutInMillis	建立连接的超时时间（单位：毫秒）
SocketTimeoutInMillis	通过打开的连接传输数据的超时时间（单位：毫秒）
MaxConnections	允许打开的最大HTTP连接数
RetryPolicy	连接重试策略
SocketBufferSizeInBytes	Socket缓冲区大小
StreamBufferSize	流文件缓冲区大小

安装SDK工具包

总览

边缘计算节点 BEC