RestApiHelper

public class RestApiHelper
extends Object implements IRestApiHelper

java.lang.Object
   ↳ com.android.tradefed.util.RestApiHelper


A helper class for performing REST API calls.

Summary

Constants

int DEFAULT_NUMBER_OF_RETRIES

Fields

protected static final JsonFactory JSON_FACTORY

protected static final String JSON_MIME

Public constructors

RestApiHelper(HttpRequestFactory requestFactory, String baseUri)

Creates an API helper instance with the given information.

Public methods

GenericUrl buildQueryUri(String[] uriParts, options)

Construct a URI for a API call with given URI parts and options.

HttpResponse execute(String method, String[] uriParts, options, JSONObject data)

Executes an API request.

HttpRequestFactory getRequestFactory()

Returns the HttpRequestFactory.

static RestApiHelper newInstanceWithGoogleCredential(String baseUri, File jsonKeyFile, scopes)

Creates an API helper instance which uses a Credential for authentication.

static RestApiHelper newInstanceWithGoogleCredential(String baseUri, String serviceAccount, File keyFile, scopes)

Creates an API helper instance which uses a Credential for authentication.

Constants

DEFAULT_NUMBER_OF_RETRIES

protected static final int DEFAULT_NUMBER_OF_RETRIES

Constant Value: 2 (0x00000002)

Fields

JSON_FACTORY

protected static final JsonFactory JSON_FACTORY

JSON_MIME

protected static final String JSON_MIME

Public constructors

RestApiHelper

public RestApiHelper (HttpRequestFactory requestFactory, 
                String baseUri)

Creates an API helper instance with the given information.

Parameters
requestFactory HttpRequestFactory: the factory to use when creating HttpRequests.

baseUri String: the base URI of API

Public methods

buildQueryUri

public GenericUrl buildQueryUri (String[] uriParts, 
                 options)

Construct a URI for a API call with given URI parts and options. uriParts should be URL-encoded already, while options should be unencoded Strings.

Parameters
uriParts String

options

Returns
GenericUrl

execute

public HttpResponse execute (String method, 
                String[] uriParts, 
                 options, 
                JSONObject data)

Executes an API request.

Parameters
method String: a HTTP method of the request

uriParts String: URL encoded URI parts to be used to construct the request URI.

options : unencoded parameter names and values used to construct the query string

data JSONObject: data to be sent with the request

Returns
HttpResponse a HttpResponse object

getRequestFactory

public HttpRequestFactory getRequestFactory ()

Returns the HttpRequestFactory.

Exposed for testing.

Returns
HttpRequestFactory

newInstanceWithGoogleCredential

public static RestApiHelper newInstanceWithGoogleCredential (String baseUri, 
                File jsonKeyFile, 
                 scopes)

Creates an API helper instance which uses a Credential for authentication.

Parameters
baseUri String: the base URI of the API

jsonKeyFile File: the service account json key file

scopes : the collection of OAuth scopes to use with the service account

Returns
RestApiHelper

Throws
GeneralSecurityException
IOException

newInstanceWithGoogleCredential

public static RestApiHelper newInstanceWithGoogleCredential (String baseUri, 
                String serviceAccount, 
                File keyFile, 
                 scopes)

Creates an API helper instance which uses a Credential for authentication.

Parameters
baseUri String: the base URI of the API

serviceAccount String: the name of the service account to use

keyFile File: the service account key file

scopes : the collection of OAuth scopes to use with the service account

Returns
RestApiHelper

Throws
GeneralSecurityException
IOException