com.jimmoores.quandl.util

Class QuandlTooManyRequestsException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.jimmoores.quandl.util.QuandlRuntimeException

com.jimmoores.quandl.util.QuandlTooManyRequestsException

All Implemented Interfaces:

Serializable

public class QuandlTooManyRequestsException
extends QuandlRuntimeException

A runtime exception from the Quandl client indicating an HTTP 429 response code (Too many requests). This generally indicates that you've made more than your allowance of requests in that day. A common solution is to use a proper API auth token (available via your account login on Quandl) to pass in when creating the QuandlSession.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
QuandlTooManyRequestsException(String message) Constructor when exception is not caused by an underlying exception.
QuandlTooManyRequestsException(String message, Long retryAfter, Long rateLimitLimit, Long rateLimitRemaining) Constructor when exception is not caused by an underlying exception.
QuandlTooManyRequestsException(String message, Long retryAfter, Long rateLimitLimit, Long rateLimitRemaining, Throwable cause) Constructor when exception is caused by an underlying exception.
QuandlTooManyRequestsException(String message, Throwable cause) Constructor when another exception is being included.

Method Summary

Modifier and Type	Method and Description
Long	getRateLimitLimit()
Long	getRateLimitRemaining()
Long	getRetryAfter()
boolean	isDataExhausted()

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

QuandlTooManyRequestsException

public QuandlTooManyRequestsException(String message,
                                      Throwable cause)

Constructor when another exception is being included.

Parameters:

message - a message describing the exception, not null

cause - the cause of the exception if there is one, not null

QuandlTooManyRequestsException

public QuandlTooManyRequestsException(String message)

Constructor when exception is not caused by an underlying exception.

Parameters:

message - a message describing the exception, not null

QuandlTooManyRequestsException

public QuandlTooManyRequestsException(String message,
                                      Long retryAfter,
                                      Long rateLimitLimit,
                                      Long rateLimitRemaining)

Constructor when exception is not caused by an underlying exception.

Parameters:

message - a message describing the exception, not null

retryAfter - the number of seconds the server has told the client to retry after, or null if not available

rateLimitLimit - the server reported total number of requests allowed in this session in total (presumably one day), or null if not available

rateLimitRemaining - the server reported remaining number of requests allowed in this session (presumably reset each day), or null if not available

QuandlTooManyRequestsException

public QuandlTooManyRequestsException(String message,
                                      Long retryAfter,
                                      Long rateLimitLimit,
                                      Long rateLimitRemaining,
                                      Throwable cause)

Constructor when exception is caused by an underlying exception.

Parameters:

message - a message describing the exception, not null

retryAfter - the number of seconds the server has told the client to retry after, or null if not available

rateLimitLimit - the server reported total number of requests allowed in this session in total (presumably one day), or null if not available

rateLimitRemaining - the server reported remaining number of requests allowed in this session (presumably reset each day), or null if not available

cause - the cause of the exception if there is one, not null

Method Detail

getRetryAfter

public Long getRetryAfter()

Returns:

the number of seconds to retry after, if provided by the server, or null if not provided.

getRateLimitLimit

public Long getRateLimitLimit()

Returns:

the limit of the number of requests this client can make (presumably in a day).

getRateLimitRemaining

public Long getRateLimitRemaining()

Returns:

the remaining number of requests this client can make to the server (presumably reset daily).

isDataExhausted

public boolean isDataExhausted()

Returns:

true, if the server has stated that the number of requests remaining for this client is <= 0 or the server did not specify.