com.baidubce.http

Class BceHttpClient

java.lang.Object

com.baidubce.http.BceHttpClient

@ThreadSafe
public class BceHttpClient
extends Object

Constructor Summary

Constructors

Constructor and Description
BceHttpClient(BceClientConfiguration config, Signer signer) Constructs a new BCE client using the specified client configuration options (ex: max retry attempts, proxy settings, etc), and request metric collector.

Method Summary

Methods

Modifier and Type	Method and Description
<T extends AbstractBceResponse> T	execute(InternalRequest request, Class<T> responseClass, HttpResponseHandler[] responseHandlers) Executes the request and returns the result.
protected void	finalize()
void	shutdown() Shuts down this HTTP client object, releasing any resources that might be held open.

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BceHttpClient

public BceHttpClient(BceClientConfiguration config,
             Signer signer)

Constructs a new BCE client using the specified client configuration options (ex: max retry attempts, proxy settings, etc), and request metric collector.

Parameters:

config - Configuration options specifying how this client will communicate with BCE (ex: proxy settings, retry count, etc.).

Throws:

IllegalArgumentException - If config or signer is null.

Method Detail

execute

public <T extends AbstractBceResponse> T execute(InternalRequest request,
                                        Class<T> responseClass,
                                        HttpResponseHandler[] responseHandlers)

Executes the request and returns the result.

Parameters:

request - The BCE request to send to the remote server

responseClass - A response handler to accept a successful response from the remote server

responseHandlers - A response handler to accept an unsuccessful response from the remote server

Throws:

BceClientException - If any errors are encountered on the client while making the request or handling the response.

BceServiceException - If any errors occurred in BCE while processing the request.

shutdown

public void shutdown()

Shuts down this HTTP client object, releasing any resources that might be held open. This is an optional method, and callers are not expected to call it, but can if they want to explicitly release any open resources. Once a client has been shutdown, it cannot be used to make more requests.

finalize

protected void finalize()
                 throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable