com.bandwidth.sdk

Class BandwidthClient

java.lang.Object

com.bandwidth.sdk.BandwidthClient

All Implemented Interfaces:

Client

public class BandwidthClient
extends Object
implements Client

Helper class to abstract the HTTP interface. This class wraps the HttpClient and the HTTP methods POST, GET, PUT and DELETE. This class also holds the credentials to the back end and includes several convenience methods for building the appropriate resource URIs. This class is used as a singleton by the different resource classes in com.bandwidth.sdk.models. Created by sbarstow on 10/3/14.

Field Summary

Fields

Modifier and Type	Field and Description
protected String	apiEndpoint
protected String	apiVersion
protected org.apache.http.client.HttpClient	httpClient
protected static BandwidthClient	INSTANCE
protected String	secret
protected String	token
protected String	usersUri

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	BandwidthClient(String userId, String apiToken, String apiSecret, String apiEndpoint, String apiVersion) Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected org.apache.http.client.methods.HttpUriRequest	buildMethod(String method, String path, Map<String,Object> params) Helper method that builds the request to the server.
protected URI	buildUri(String path) Helper method to return URI
protected URI	buildUri(String path, List<org.apache.http.NameValuePair> queryStringParams) Helper method to return URI query parameters
RestResponse	delete(String uri) This method implements an HTTP delete.
void	download(String uri, File destFile) Convenience method to download files from the server.
protected org.apache.http.client.methods.HttpDelete	generateDeleteRequest(String path) Helper method to build the HTTP DELETE request for the server.
protected org.apache.http.client.methods.HttpGet	generateGetRequest(String path, Map<String,Object> paramMap) Helper method to build the GET request for the server.
protected org.apache.http.client.methods.HttpPost	generatePostRequest(String path, Map<String,Object> paramMap) Helper method to build the POST request for the server.
protected org.apache.http.client.methods.HttpPut	generatePutRequest(String path, Map<String,Object> paramMap) Helper method to build the PUT request for the server.
RestResponse	get(String uri, Map<String,Object> params) This method implements an HTTP GET.
String	getBaseResourceUri(String path) Convenience method that returns the base resource URI.
static BandwidthClient	getInstance() getInstance() method returns a singleton instance of the BandwidthClient.
String	getPath(String uri) Convenience method to return the full URL, including Endpoint and version, to a given resource.
String	getUserResourceInstanceUri(String path, String instanceId) Convenience method that returns the resource instance uri.
String	getUserResourceUri(String path) Convenience method to return the resource URL with the users credentials, e.g.
String	getUserUri() Returns API URL with userid
protected RestResponse	performRequest(org.apache.http.client.methods.HttpUriRequest request) Helper method that executes the request on the server.
RestResponse	post(String uri, Map<String,Object> params) This method implements an HTTP POST.
RestResponse	put(String uri, Map<String,Object> params) This method implements an HTTP put.
protected RestResponse	request(String path, String method) Helper method to build the request to the server.
protected RestResponse	request(String path, String method, Map<String,Object> paramList) Helper method to build the request to the server.
void	setCredentials(String userId, String apiToken, String apiSecret) The setCredentials() provides a convenience method to pass the userId, API-token and API-secret after a client has been instantiated.
void	setEndpointandVersion(String apiEndpoint, String apiVersion) The setEndpointandVersion() method provides a convenience method to pass the apiEndpoint and apiVersion after a client has been instantiated.
protected org.apache.http.client.methods.HttpUriRequest	setupRequest(String path, String method, Map<String,Object> params) Helper method to build the request to the server.
void	upload(String uri, File sourceFile, String contentType) Convenience method to upload files to the server.

Methods inherited from class java.lang.Object

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

Field Detail

token

protected String token

secret

protected String secret

apiVersion

protected String apiVersion

apiEndpoint

protected String apiEndpoint

usersUri

protected String usersUri

httpClient

protected org.apache.http.client.HttpClient httpClient

INSTANCE

protected static BandwidthClient INSTANCE

Constructor Detail

BandwidthClient

protected BandwidthClient(String userId,
               String apiToken,
               String apiSecret,
               String apiEndpoint,
               String apiVersion)

Constructor. Instances are created through getInstance() method.

Parameters:

userId - the user id.

apiToken - the user API token.

apiSecret - the user API secret.

apiEndpoint - the API Endpoint.

apiVersion - the API version.

Method Detail

getInstance

public static BandwidthClient getInstance()

getInstance() method returns a singleton instance of the BandwidthClient. Looks for user-id, api-token and api-secret as environment variables or system properties. These can also be set using the setCredentials method.

Returns:

the BandwidthClient

setCredentials

public void setCredentials(String userId,
                  String apiToken,
                  String apiSecret)

The setCredentials() provides a convenience method to pass the userId, API-token and API-secret after a client has been instantiated.

Parameters:

userId - the user id.

apiToken - the API token.

apiSecret - the API secret.

setEndpointandVersion

public void setEndpointandVersion(String apiEndpoint,
                         String apiVersion)

The setEndpointandVersion() method provides a convenience method to pass the apiEndpoint and apiVersion after a client has been instantiated.

Parameters:

apiEndpoint - the API Endpoint.

apiVersion - the API version.

getUserResourceUri

public String getUserResourceUri(String path)

Convenience method to return the resource URL with the users credentials, e.g.

Parameters:

path - the path.

Returns:

the joined path.

getUserResourceInstanceUri

public String getUserResourceInstanceUri(String path,
                                String instanceId)

Convenience method that returns the resource instance uri. E.g.

Parameters:

path - the path.

instanceId - the instance id.

Returns:

The user Instance URI.

getBaseResourceUri

public String getBaseResourceUri(String path)

Convenience method that returns the base resource URI. E.g.

Parameters:

path - the path.

Returns:

the base resource URI.

getPath

public String getPath(String uri)

Convenience method to return the full URL, including Endpoint and version, to a given resource. E.g.

Parameters:

uri - the URI.

Returns:

the path.

getUserUri

public String getUserUri()

Returns API URL with userid

Returns:

usersUri

post

public RestResponse post(String uri,
                Map<String,Object> params)
                  throws IOException

This method implements an HTTP POST. Use this method to create a new resource.

Parameters:

uri - the URI.

params - the parameters.

Returns:

the post response.

Throws:

IOException - unexpected exception.

get

public RestResponse get(String uri,
               Map<String,Object> params)
                 throws Exception

This method implements an HTTP GET. Use this method to retrieve a resource.

Specified by:

get in interface Client

Parameters:

uri - the URI.

params - the parameters.

Returns:

the get response.

Throws:

Exception - unexpected exception.

put

public RestResponse put(String uri,
               Map<String,Object> params)
                 throws IOException

This method implements an HTTP put. Use this method to update a resource.

Parameters:

uri - the URI

params - the parameters.

Returns:

the put response.

Throws:

IOException - unexpected exception.

delete

public RestResponse delete(String uri)
                    throws IOException

This method implements an HTTP delete. Use this method to remove a resource.

Parameters:

uri - the URI.

Returns:

the response.

Throws:

IOException - unexpected exception.

upload

public void upload(String uri,
          File sourceFile,
          String contentType)
            throws IOException

Convenience method to upload files to the server. User to upload media.

Parameters:

uri - the URI

sourceFile - the source file

contentType - the content type.

Throws:

IOException - unexpected exception.

download

public void download(String uri,
            File destFile)
              throws IOException

Convenience method to download files from the server. Used to retrieve media files.

Parameters:

uri - the URI.

destFile - the destination file.

Throws:

IOException - unexpected exception.

request

protected RestResponse request(String path,
                   String method)
                        throws IOException

Helper method to build the request to the server.

Parameters:

path - the path.

method - the method.

Returns:

the request response.

Throws:

IOException - unexpected exception.

request

protected RestResponse request(String path,
                   String method,
                   Map<String,Object> paramList)
                        throws IOException

Helper method to build the request to the server.

Parameters:

path - the path

method - the method

paramList - the parameter list.

Returns:

the response.

Throws:

IOException - unexpected exception.

performRequest

protected RestResponse performRequest(org.apache.http.client.methods.HttpUriRequest request)
                               throws IOException

Helper method that executes the request on the server.

Parameters:

request - the request.

Returns:

the response.

Throws:

IOException - unexpected exception.

setupRequest

protected org.apache.http.client.methods.HttpUriRequest setupRequest(String path,
                                                         String method,
                                                         Map<String,Object> params)

Helper method to build the request to the server.

Parameters:

path - the path.

method - the method.

params - the parameters.

Returns:

the request.

buildMethod

protected org.apache.http.client.methods.HttpUriRequest buildMethod(String method,
                                                        String path,
                                                        Map<String,Object> params)

Helper method that builds the request to the server.

Parameters:

method - the method.

path - the path.

params - the parameters.

Returns:

the request.

generateGetRequest

protected org.apache.http.client.methods.HttpGet generateGetRequest(String path,
                                                        Map<String,Object> paramMap)

Helper method to build the GET request for the server.

Parameters:

path - the path.

paramMap - the parameters map.

Returns:

the get object.

generatePostRequest

protected org.apache.http.client.methods.HttpPost generatePostRequest(String path,
                                                          Map<String,Object> paramMap)

Helper method to build the POST request for the server.

Parameters:

path - the path.

paramMap - the parameters map.

Returns:

the post object.

generatePutRequest

protected org.apache.http.client.methods.HttpPut generatePutRequest(String path,
                                                        Map<String,Object> paramMap)

Helper method to build the PUT request for the server.

Parameters:

path - the path

paramMap - the parameters map.

Returns:

the put object.

generateDeleteRequest

protected org.apache.http.client.methods.HttpDelete generateDeleteRequest(String path)

Helper method to build the HTTP DELETE request for the server.

Parameters:

path - the path

Returns:

the delete object.

buildUri

protected URI buildUri(String path)

Helper method to return URI

Parameters:

path - the path.

Returns:

the URI object.

buildUri

protected URI buildUri(String path,
           List<org.apache.http.NameValuePair> queryStringParams)

Helper method to return URI query parameters

Parameters:

path - the path.

queryStringParams - the query string parameters.

Returns:

the URI object.