com.atlassian.sal.api.net
Interface Request<T extends Request<?>>

Type Parameters:

T - the type of request used for method chaing

public interface Request<T extends Request<?>>

Interface Request represents a request to retrieve data. To execute a request call execute(ResponseHandler).

Since:

2.0

Nested Class Summary

static class

Request.MethodType Represents type of network request

Method Summary

T	addAuthentication(Authenticator authenticator) Adds generic Authenticator to the request.
T	addBasicAuthentication(java.lang.String username, java.lang.String password) Adds basic authentication to the request.
T	addHeader(java.lang.String headerName, java.lang.String headerValue) Adds the specified header to the request, not overwriting any previous value.
T	addRequestParameters(java.lang.String... params) Sets parameters of the request.
T	addSeraphAuthentication(java.lang.String username, java.lang.String password) Adds seraph authentication to the request.
T	addTrustedTokenAuthentication() Adds TrustedTokenAuthentication to the request.
T	addTrustedTokenAuthentication(java.lang.String username) Adds TrustedTokenAuthentication to the request.
java.lang.String	execute() Executes a request and if response is successful, returns response as a string.
void	execute(ResponseHandler responseHandler) Executes the request.
T	setConnectionTimeout(int connectionTimeout) Setting connection timeout in milliseconds.
T	setHeader(java.lang.String headerName, java.lang.String headerValue) Sets the specified header to the request, overwriting any previous value.
T	setRequestBody(java.lang.String requestBody) Sets the body of the request.
T	setRequestContentType(java.lang.String contentType) Sets Content-Type of the body of the request.
T	setSoTimeout(int soTimeout) Setting socket timeout in milliseconds.
T	setUrl(java.lang.String url)

Method Detail

setConnectionTimeout

T setConnectionTimeout(int connectionTimeout)

Setting connection timeout in milliseconds.

Parameters:

connectionTimeout - The timeout in milliseconds

Returns:

a reference to this object.

setSoTimeout

T setSoTimeout(int soTimeout)

Setting socket timeout in milliseconds.

Parameters:

soTimeout - the timeout in milliseconds

Returns:

a reference to this object.

setUrl

T setUrl(java.lang.String url)

Parameters:

url - the url to request

Returns:

a reference to this object.

setRequestBody

T setRequestBody(java.lang.String requestBody)

Sets the body of the request. In default implementation only requests of type Request.MethodType.POST and Request.MethodType.POST can have request body.

Parameters:

requestBody - the body of the request

Returns:

a reference to this object.

setRequestContentType

T setRequestContentType(java.lang.String contentType)

Sets Content-Type of the body of the request. In default implementation only requests of type Request.MethodType.POST and Request.MethodType.POST can have request body.

Parameters:

contentType - the contentType of the request

Returns:

a reference to this object.

addRequestParameters

T addRequestParameters(java.lang.String... params)

Sets parameters of the request. In default implementation only requests of type Request.MethodType.POST and Request.MethodType.POST can have parameters. For other requests include parameters in url. This method accepts odd number of arguments, in form of name, value, name, value, name, value, etc

Parameters:

params - parameters of the request in as name, value pairs

Returns:

a reference to this object.

addAuthentication

T addAuthentication(Authenticator authenticator)

Adds generic Authenticator to the request.

Parameters:

authenticator - the authenticator to use for authentication

Returns:

a reference to this object.

addTrustedTokenAuthentication

T addTrustedTokenAuthentication()

Adds TrustedTokenAuthentication to the request. Trusted token authenticator uses current user to make a trusted application call.

Returns:

a reference to this object.

addTrustedTokenAuthentication

T addTrustedTokenAuthentication(java.lang.String username)

Adds TrustedTokenAuthentication to the request. Trusted token authenticator uses the passed user to make a trusted application call.

Parameters:

username - The user to make the request with

Returns:

this

addBasicAuthentication

T addBasicAuthentication(java.lang.String username,
                         java.lang.String password)

Adds basic authentication to the request.

Parameters:

username - The user name

password - The password

Returns:

a reference to this object.

addSeraphAuthentication

T addSeraphAuthentication(java.lang.String username,
                          java.lang.String password)

Adds seraph authentication to the request.

Parameters:

username - The user name

password - The password

Returns:

a reference to this object.

addHeader

T addHeader(java.lang.String headerName,
            java.lang.String headerValue)

Adds the specified header to the request, not overwriting any previous value. Support for this operation is optional.

Parameters:

headerName - the header's name

headerValue - the header's value

Returns:

a reference to this object

See Also:

RequestFactory.supportsHeader()

setHeader

T setHeader(java.lang.String headerName,
            java.lang.String headerValue)

Sets the specified header to the request, overwriting any previous value. Support for this operation is optional.

Parameters:

headerName - the header's name

headerValue - the header's value

Returns:

a reference to this object

See Also:

RequestFactory.supportsHeader()

execute

void execute(ResponseHandler responseHandler)
             throws ResponseException

Executes the request.

Parameters:

responseHandler - Callback handler of the response.

Throws:

ResponseException - If the response cannot be retrieved

execute

java.lang.String execute()
                         throws ResponseException

Executes a request and if response is successful, returns response as a string. @see Response.getResponseBodyAsString()

Returns:

response as String

Throws:

ResponseException - If the response cannot be retrieved