搜索本产品文档关键词
初始化
所有文档
menu

专线 ET

初始化

确认Endpoint

在确认您使用SDK时配置的Endpoint时,可先参考阅读API参考中关于API服务域名的部分,理解Endpoint相关的概念。

访问区域
对应Endpoint
全局 bcc.bj.baidubce.com

获取AK/SK

要使用百度智能云ET,您需要拥有一个有效的 AK(Access Key ID)和SK(Secret Access Key)用来进行签名认证。AK/SK是由系统分配给用户的,均为字符串,用于标识用户,为访问服务做签名验证。 可以通过如下步骤获得并了解您的AK/SK信息:

  1. 注册百度智能云账号
  2. 创建AK/SK

新建EtClient

EtClient是ET服务的客户端,为开发者与Et服务进行交互提供了一系列的方法。

使用AK/SK新建EtClient

通过AK/SK方式访问ET,用户可以参考如下代码新建一个Client:

Java
1public class Sample {
2    public static void main(String[] args) {
3        String ACCESS_KEY_ID = <your-access-key-id>;                   // 用户的Access Key ID
4        String SECRET_ACCESS_KEY = <your-secret-access-key>;           // 用户的Secret Access Key
5        
6        // 初始化一个EtClient
7        EtClientConfiguration config = new EtClientConfiguration();
8        config.setCredentials(new DefaultBceCredentials(ACCESS_KEY_ID, SECRET_ACCESS_KEY));
9        EtClient client = new EtClient(config);
10    }
11}

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

上面的方式使用默认域名作为ET的服务地址,如果用户需要自己指定域名,可以通过传入ENDPOINT参数来指定。

Java
1 String ACCESS_KEY_ID = <your-access-key-id>;                   // 用户的Access Key ID
2 String SECRET_ACCESS_KEY = <your-secret-access-key>;           // 用户的Secret Access Key
3 String ENDPOINT = <domain-name>;                               // 用户自己指定的域名
4
5 EtClientConfiguration config = new EtClientConfiguration();
6 config.setCredentials(new DefaultBceCredentials(ACCESS_KEY_ID,SECRET_ACCESS_KEY));
7 config.setEndpoint(ENDPOINT);
8 EtClient client = new EtClient(config);

使用STS创建EtClient

申请STS token

ET可以通过STS机制实现第三方的临时授权访问。STS(Security Token Service)是百度智能云提供的临时授权服务。通过STS,您可以为第三方用户颁发一个自定义时效和权限的访问凭证。第三方用户可以使用该访问凭证直接调用百度智能云的API或SDK访问百度智能云资源。

通过STS方式访问ET,用户需要先通过STS的client申请一个认证字符串,申请方式可参见百度智能云STS使用介绍

用STS token新建EtClient

申请好STS后,可将STStoken配置到EtClient中,用户可以参考如下代码新建一个EtClient:

Java
1public class StsExample {
2    private static final String STS_ENDPOINT = "http://sts.bj.baidubce.com";
3    private static final String ACCESS_KEY_ID = "your accesskey id";
4    private static final String SECRET_ACCESS_KEY = "your secret accesskey";
5
6    public static void main(String[] args) {
7        BceCredentials credentials = new DefaultBceCredentials(ACCESS_KEY_ID, SECRET_ACCESS_KEY);
8        StsClient client = new StsClient(
9                new BceClientConfiguration().withEndpoint(STS_ENDPOINT).withCredentials(credentials)
10        );
11        GetSessionTokenResponse response = client.getSessionToken(new GetSessionTokenRequest());
12        // or simply call:
13        // GetSessionTokenResponse response = client.getSessionToken();
14        // or you can specify limited permissions with ACL:
15        // GetSessionTokenResponse response = client.getSessionToken(new GetSessionTokenRequest().withAcl("blabla"));
16        // build DefaultBceSessionCredentials object from response:
17        BceCredentials etStsCredentials = new DefaultBceSessionCredentials(
18                response.getAccessKeyId(),
19                response.getSecretAccessKey(),
20                response.getSessionToken());
21        System.out.println("==================================");
22        System.out.println("GetSessionToken result:");
23        System.out.println("    accessKeyId:  " + response.getAccessKeyId());
24        System.out.println("    secretAccessKey:  " + response.getSecretAccessKey());
25        System.out.println("    securityToken:  " + response.getSessionToken());
26        System.out.println("    expiresAt:  " + response.getExpiration().toString());
27        System.out.println("==================================");
28
29        // build ET client
30        EtClientConfiguration config = new EtClientConfiguration();
31        config.setCredentials(etStsCredentials);
32        EtClient client = new EtClient(config);
33    }
34}

注意: 目前使用STS配置client时,无论对应ET服务的endpoint在哪里,endpoint都需配置为http://sts.bj.baidubce.com

配置HTTPS协议访问ET

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

  • 在endpoint中指明https:
Java
1 String endpoint = "https://bcc.bj.baidubce.com";
2 String ak = "ak";
3 String sk = "sk";
4 EtClientConfiguration config = new EtClientConfiguration();
5 config.setCredentials(new DefaultBceCredentials(ak, sk));
6 EtClient client = new EtClient(config);
  • 通过调用setProtocol方法设置https协议:
Java
1 String endpoint = "bcc.bj.baidubce.com"; // endpoint中不包含protocol
2 String ak = "ak";
3 String sk = "sk";
4 EtClientConfiguration config = new EtClientConfiguration();
5 config.setCredentials(new DefaultBceCredentials(ak, sk));
6 config.setEndpoint(ENDPOINT);
7 config.setProtocol(Protocol.HTTPS); // 如果不指明, 则使用http
8 EtClient client = new EtClient(config);

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

Java
1 String endpoint = "http://bcc.bj.baidubce.com";
2 String ak = "ak";
3 String sk = "sk";
4 EtClientConfiguration config = new EtClientConfiguration();
5 config.setCredentials(new DefaultBceCredentials(ak, sk));
6 config.setEndpoint(ENDPOINT);    
7 config.setProtocol(Protocol.HTTPS); // endpoint中已经指明, 此为无效操作, 对http也是如此
8 EtClient client = new EtClient(config);

配置EtClient

如果用户需要配置EtClient的一些细节的参数,可以在构造EtClient的时候传入EtClientConfiguration对象,可以为客户端配置代理,最大连接数等参数。

使用代理

下面一段代码可以让客户端使用代理访问ET服务:

Java
1 String ACCESS_KEY_ID = <your-access-key-id>;                   // 用户的Access Key ID
2 String SECRET_ACCESS_KEY = <your-secret-access-key>;           // 用户的Secret Access Key
3 String ENDPOINT = <domain-name>;                               // 用户自己指定的域名
4
5 // 创建EtClientConfiguration实例
6 EtClientConfiguration config = new EtClientConfiguration();
7
8 // 配置代理为本地8080端口
9 config.setProxyHost("127.0.0.1");
10 config.setProxyPort(8080);
11
12 // 创建ET客户端
13 config.setCredentials(new DefaultBceCredentials(ACCESS_KEY_ID,SECRET_ACCESS_KEY));
14 config.setEndpoint(ENDPOINT);
15 EtClient client = new EtClient(config);

使用上面的代码段,客户端的所有操作都会通过127.0.0.1地址的8080端口做代理执行。

对于有用户验证的代理,可以通过下面的代码段配置用户名和密码:

Plain Text
1// 创建EtClientConfiguration实例
2 EtClientConfiguration config = new EtClientConfiguration();
3    
4 // 配置代理为本地8080端口
5 config.setProxyHost("127.0.0.1");
6 config.setProxyPort(8080);
7    
8 //设置用户名和密码
9 config.setProxyUsername(<username>);                             //用户名
10 config.setProxyPassword(<password>);                             //密码

设置网络参数

用户可以用EtClientConfiguration对基本网络参数进行设置:

Java
1EtClientConfiguration config = new EtClientConfiguration();
2    
3// 设置HTTP最大连接数为10
4config.setMaxConnections(10);
5    
6// 设置TCP连接超时为5000毫秒
7config.setConnectionTimeout(5000);
8    
9// 设置Socket传输数据超时的时间为2000毫秒
10config.setSocketTimeout(2000);

参数说明 通过EtClientConfiguration能指定的所有参数如下表所示:

参数
说明
UserAgent 用户代理,指HTTP的User-Agent
Protocol 连接协议类型
ProxyDomain 访问NTLM验证的代理服务器的Windows域名
ProxyHost 代理服务器主机地址
ProxyPort 代理服务器端口
ProxyUsername 代理服务器验证的用户名
ProxyPassword 代理服务器验证的密码
ProxyPreemptiveAuthenticationEnabled 是否设置用户代理认证
ProxyWorkstation NTLM代理服务器的Windows工作站名称
LocalAddress 本地地址
ConnectionTimeoutInMillis 建立连接的超时时间(单位:毫秒)
SocketTimeoutInMillis 通过打开的连接传输数据的超时时间(单位:毫秒)
MaxConnections 允许打开的最大HTTP连接数
RetryPolicy 连接重试策略
SocketBufferSizeInBytes Socket缓冲区大小
上一篇
安装SDK工具包
下一篇
专线