com.sendgrid

Class SendGrid

java.lang.Object

com.sendgrid.SendGrid

All Implemented Interfaces:

SendGridAPI

public class SendGrid
extends Object
implements SendGridAPI

Class Twilio SendGrid allows for quick and easy access to the Twilio SendGrid API.

Constructor Summary

Constructors

Constructor and Description
SendGrid(String apiKey) Construct a new Twilio SendGrid API wrapper.
SendGrid(String apiKey, Boolean test) Construct a new Twilio SendGrid API wrapper.
SendGrid(String apiKey, com.sendgrid.Client client) Construct a new Twilio SendGrid API wrapper.

Method Summary

Modifier and Type	Method and Description
void	addImpersonateSubuser(String subuser) Impersonate subuser for subsequent requests
Map<String,String>	addRequestHeader(String key, String value) Add a new request header.
com.sendgrid.Response	api(com.sendgrid.Request request) Class api sets up the request to the Twilio SendGrid API, this is main interface.
void	attempt(com.sendgrid.Request request) Attempt an API call.
void	attempt(com.sendgrid.Request request, APICallback callback) Attempt an API call.
String	getHost() Get the Twilio SendGrid host (api.sendgrid.com by default).
String	getImpersonateSubuser() Get the impersonated subuser or null if empty
String	getLibraryVersion() Retrieve the current library version.
int	getRateLimitRetry() Get the maximum number of retries on a rate limit response.
int	getRateLimitSleep() Get the duration of time (in milliseconds) to sleep between consecutive rate limit retries.
Map<String,String>	getRequestHeaders() Obtain the request headers.
String	getVersion() Get the API version.
void	initializeSendGrid(String apiKey) Initialize the client.
com.sendgrid.Response	makeCall(com.sendgrid.Request request) Makes the call to the Twilio SendGrid API, override this method for testing.
void	removeImpersonateSubuser() Stop Impersonating the subuser
Map<String,String>	removeRequestHeader(String key) Remove a request header.
void	setHost(String host) Set the Twilio SendGrid host.
void	setRateLimitRetry(int rateLimitRetry) Set the maximum number of retries on a rate limit response.
void	setRateLimitSleep(int rateLimitSleep) Set the duration of time (in milliseconds) to sleep between consecutive rate limit retries.
void	setVersion(String version) Set the API version.

Methods inherited from class java.lang.Object

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

Constructor Detail

SendGrid

public SendGrid(String apiKey)

Construct a new Twilio SendGrid API wrapper.

Parameters:

apiKey - is your Twilio SendGrid API Key: https://app.sendgrid.com/settings/api_keys

SendGrid

public SendGrid(String apiKey,
                Boolean test)

Construct a new Twilio SendGrid API wrapper.

Parameters:

apiKey - is your Twilio SendGrid API Key: https://app.sendgrid.com/settings/api_keys

test - is true if you are unit testing

SendGrid

public SendGrid(String apiKey,
                com.sendgrid.Client client)

Construct a new Twilio SendGrid API wrapper.

Parameters:

apiKey - is your Twilio SendGrid API Key: https://app.sendgrid.com/settings/api_keys

client - the Client to use (allows to customize its configuration)

Method Detail

initializeSendGrid

public void initializeSendGrid(String apiKey)

Initialize the client.

Specified by:

initializeSendGrid in interface SendGridAPI

Parameters:

apiKey - the user's API key.

getLibraryVersion

public String getLibraryVersion()

Retrieve the current library version.

Specified by:

getLibraryVersion in interface SendGridAPI

Returns:

the current version.

getVersion

public String getVersion()

Get the API version.

Specified by:

getVersion in interface SendGridAPI

Returns:

the current API versioin (v3 by default).

setVersion

public void setVersion(String version)

Set the API version.

Specified by:

setVersion in interface SendGridAPI

Parameters:

version - the new version.

getRequestHeaders

public Map<String,String> getRequestHeaders()

Obtain the request headers.

Specified by:

getRequestHeaders in interface SendGridAPI

Returns:

the request headers.

addRequestHeader

public Map<String,String> addRequestHeader(String key,
                                           String value)

Add a new request header.

Specified by:

addRequestHeader in interface SendGridAPI

Parameters:

key - the header key.

value - the header value.

Returns:

the new set of request headers.

removeRequestHeader

public Map<String,String> removeRequestHeader(String key)

Remove a request header.

Specified by:

removeRequestHeader in interface SendGridAPI

Parameters:

key - the header key to remove.

Returns:

the new set of request headers.

getHost

public String getHost()

Get the Twilio SendGrid host (api.sendgrid.com by default).

Specified by:

getHost in interface SendGridAPI

Returns:

the Twilio SendGrid host.

setHost

public void setHost(String host)

Set the Twilio SendGrid host.

Specified by:

setHost in interface SendGridAPI

Parameters:

host - the new Twilio SendGrid host.

getRateLimitRetry

public int getRateLimitRetry()

Get the maximum number of retries on a rate limit response. The default is 5.

Returns:

the number of retries on a rate limit.

setRateLimitRetry

public void setRateLimitRetry(int rateLimitRetry)

Set the maximum number of retries on a rate limit response.

Parameters:

rateLimitRetry - the maximum retry count.

getRateLimitSleep

public int getRateLimitSleep()

Get the duration of time (in milliseconds) to sleep between consecutive rate limit retries. The Twilio SendGrid API enforces the rate limit to the second. The default value is 1.1 seconds.

Returns:

the sleep duration.

setRateLimitSleep

public void setRateLimitSleep(int rateLimitSleep)

Set the duration of time (in milliseconds) to sleep between consecutive rate limit retries.

Parameters:

rateLimitSleep - the sleep duration.

addImpersonateSubuser

public void addImpersonateSubuser(String subuser)

Impersonate subuser for subsequent requests

Parameters:

subuser - the subuser to be impersonated

removeImpersonateSubuser

public void removeImpersonateSubuser()

Stop Impersonating the subuser

getImpersonateSubuser

public String getImpersonateSubuser()

Get the impersonated subuser or null if empty

Returns:

the impersonated subuser

makeCall

public com.sendgrid.Response makeCall(com.sendgrid.Request request)
                               throws IOException

Makes the call to the Twilio SendGrid API, override this method for testing.

Specified by:

makeCall in interface SendGridAPI

Parameters:

request - the request to make.

Returns:

the response object.

Throws:

IOException - in case of a network error.

api

public com.sendgrid.Response api(com.sendgrid.Request request)
                          throws IOException

Class api sets up the request to the Twilio SendGrid API, this is main interface.

Specified by:

api in interface SendGridAPI

Parameters:

request - the request object.

Returns:

the response object.

Throws:

IOException - in case of a network error.

attempt

public void attempt(com.sendgrid.Request request)

Attempt an API call. This method executes the API call asynchronously on an internal thread pool. If the call is rate limited, the thread will retry up to the maximum configured time.

Parameters:

request - the API request.

attempt

public void attempt(com.sendgrid.Request request,
                    APICallback callback)

Attempt an API call. This method executes the API call asynchronously on an internal thread pool. If the call is rate limited, the thread will retry up to the maximum configured time. The supplied callback will be called in the event of an error, or a successful response.

Parameters:

request - the API request.

callback - the callback.