com.dropbox.core

Class DbxRequestUtil

java.lang.Object

com.dropbox.core.DbxRequestUtil

public class DbxRequestUtil
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DbxRequestUtil.RequestMaker<T,E extends Throwable>
static class	DbxRequestUtil.ResponseHandler<T>

Constructor Summary

Constructors

Constructor and Description
DbxRequestUtil()

Method Summary

Methods

Modifier and Type	Method and Description
static ArrayList<HttpRequestor.Header>	addUserAgentHeader(ArrayList<HttpRequestor.Header> headers, DbxRequestConfig requestConfig)
static String	buildUri(String host, String path)
static String	buildUrlWithParams(String userLocale, String host, String path, String[] params)
static HttpRequestor.Header	buildUserAgentHeader(DbxRequestConfig requestConfig)
static <T> T	doGet(DbxRequestConfig requestConfig, String accessToken, String host, String path, String[] params, ArrayList<HttpRequestor.Header> headers, DbxRequestUtil.ResponseHandler<T> handler)
static <T> T	doPost(DbxRequestConfig requestConfig, String accessToken, String host, String path, String[] params, ArrayList<HttpRequestor.Header> headers, DbxRequestUtil.ResponseHandler<T> handler)
static <T> T	doPostNoAuth(DbxRequestConfig requestConfig, String host, String path, String[] params, ArrayList<HttpRequestor.Header> headers, DbxRequestUtil.ResponseHandler<T> handler)
static String	encodeUrlParam(String s)
static <T> T	finishResponse(HttpRequestor.Response response, DbxRequestUtil.ResponseHandler<T> handler)
static String	getFirstHeader(HttpRequestor.Response response, String name)
static String	getFirstHeaderMaybe(HttpRequestor.Response response, String name)
static byte[]	loadErrorBody(HttpRequestor.Response response)
static String	parseErrorBody(int statusCode, byte[] body)
static <T> T	readJsonFromResponse(JsonReader<T> reader, InputStream body)
static <T,E extends Throwable> T	runAndRetry(int maxTries, DbxRequestUtil.RequestMaker<T,E> requestMaker)
static HttpRequestor.Response	startGet(DbxRequestConfig requestConfig, String accessToken, String host, String path, String[] params, ArrayList<HttpRequestor.Header> headers) Convenience function for making HTTP GET requests.
static HttpRequestor.Response	startPostNoAuth(DbxRequestConfig requestConfig, String host, String path, String[] params, ArrayList<HttpRequestor.Header> headers) Convenience function for making HTTP POST requests.
static HttpRequestor.Uploader	startPut(DbxRequestConfig requestConfig, String accessToken, String host, String path, String[] params, ArrayList<HttpRequestor.Header> headers) Convenience function for making HTTP PUT requests.
static DbxException	unexpectedStatus(HttpRequestor.Response response)

Methods inherited from class java.lang.Object

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

Constructor Detail

DbxRequestUtil

public DbxRequestUtil()

Method Detail

encodeUrlParam

public static String encodeUrlParam(String s)

buildUrlWithParams

public static String buildUrlWithParams(String userLocale,
                        String host,
                        String path,
                        String[] params)

buildUri

public static String buildUri(String host,
              String path)

addUserAgentHeader

public static ArrayList<HttpRequestor.Header> addUserAgentHeader(ArrayList<HttpRequestor.Header> headers,
                                                 DbxRequestConfig requestConfig)

buildUserAgentHeader

public static HttpRequestor.Header buildUserAgentHeader(DbxRequestConfig requestConfig)

startGet

public static HttpRequestor.Response startGet(DbxRequestConfig requestConfig,
                              String accessToken,
                              String host,
                              String path,
                              String[] params,
                              ArrayList<HttpRequestor.Header> headers)
                                       throws DbxException.NetworkIO

Convenience function for making HTTP GET requests.

Throws:

DbxException.NetworkIO

startPut

public static HttpRequestor.Uploader startPut(DbxRequestConfig requestConfig,
                              String accessToken,
                              String host,
                              String path,
                              String[] params,
                              ArrayList<HttpRequestor.Header> headers)
                                       throws DbxException.NetworkIO

Convenience function for making HTTP PUT requests.

Throws:

DbxException.NetworkIO

startPostNoAuth

public static HttpRequestor.Response startPostNoAuth(DbxRequestConfig requestConfig,
                                     String host,
                                     String path,
                                     String[] params,
                                     ArrayList<HttpRequestor.Header> headers)
                                              throws DbxException.NetworkIO

Convenience function for making HTTP POST requests.

Throws:

DbxException.NetworkIO

loadErrorBody

public static byte[] loadErrorBody(HttpRequestor.Response response)
                            throws DbxException.NetworkIO

Throws:

DbxException.NetworkIO

parseErrorBody

public static String parseErrorBody(int statusCode,
                    byte[] body)
                             throws DbxException.BadResponse

Throws:

DbxException.BadResponse

unexpectedStatus

public static DbxException unexpectedStatus(HttpRequestor.Response response)
                                     throws DbxException.NetworkIO,
                                            DbxException.BadResponse

Throws:

DbxException.NetworkIO

DbxException.BadResponse

readJsonFromResponse

public static <T> T readJsonFromResponse(JsonReader<T> reader,
                         InputStream body)
                              throws DbxException.BadResponse,
                                     DbxException.NetworkIO

Throws:

DbxException.BadResponse

DbxException.NetworkIO

doGet

public static <T> T doGet(DbxRequestConfig requestConfig,
          String accessToken,
          String host,
          String path,
          String[] params,
          ArrayList<HttpRequestor.Header> headers,
          DbxRequestUtil.ResponseHandler<T> handler)
               throws DbxException

Throws:

DbxException

doPost

public static <T> T doPost(DbxRequestConfig requestConfig,
           String accessToken,
           String host,
           String path,
           String[] params,
           ArrayList<HttpRequestor.Header> headers,
           DbxRequestUtil.ResponseHandler<T> handler)
                throws DbxException

Throws:

DbxException

doPostNoAuth

public static <T> T doPostNoAuth(DbxRequestConfig requestConfig,
                 String host,
                 String path,
                 String[] params,
                 ArrayList<HttpRequestor.Header> headers,
                 DbxRequestUtil.ResponseHandler<T> handler)
                      throws DbxException

Throws:

DbxException

finishResponse

public static <T> T finishResponse(HttpRequestor.Response response,
                   DbxRequestUtil.ResponseHandler<T> handler)
                        throws DbxException

Throws:

DbxException

getFirstHeader

public static String getFirstHeader(HttpRequestor.Response response,
                    String name)
                             throws DbxException

Throws:

DbxException

getFirstHeaderMaybe

public static String getFirstHeaderMaybe(HttpRequestor.Response response,
                         String name)
                                  throws DbxException

Throws:

DbxException

runAndRetry

public static <T,E extends Throwable> T runAndRetry(int maxTries,
                                    DbxRequestUtil.RequestMaker<T,E> requestMaker)
                     throws DbxException,
                            E extends Throwable

Throws:

DbxException

E extends Throwable