Package com.github.scribejava.core.model

Class OAuthRequest

java.lang.Object

com.github.scribejava.core.model.OAuthRequest

public class OAuthRequest
extends Object

The representation of an OAuth HttpRequest.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	OAuthRequest.ResponseConverter<T>

Constructor Summary

Constructors

Constructor	Description
OAuthRequest(Verb verb, String url)	Default constructor.

Method Summary

Modifier and Type	Method	Description
void	addBodyParameter(String key, String value)	Add a body Parameter (for POST/ PUT Requests)
void	addByteArrayBodyPartPayloadInMultipartPayload(byte[] bodyPartPayload)
void	addByteArrayBodyPartPayloadInMultipartPayload(byte[] bodyPartPayload, String contentType)
void	addByteArrayBodyPartPayloadInMultipartPayload(byte[] bodyPartPayload, Map<String,String> headers)
void	addFileByteArrayBodyPartPayloadInMultipartPayload(byte[] fileContent)
void	addFileByteArrayBodyPartPayloadInMultipartPayload(byte[] fileContent, String name)
void	addFileByteArrayBodyPartPayloadInMultipartPayload(byte[] fileContent, String name, String filename)
void	addFileByteArrayBodyPartPayloadInMultipartPayload(FileByteArrayBodyPartPayload fileByteArrayBodyPartPayload)
void	addFileByteArrayBodyPartPayloadInMultipartPayload(String contentType, byte[] fileContent)
void	addFileByteArrayBodyPartPayloadInMultipartPayload(String contentType, byte[] fileContent, String name)
void	addFileByteArrayBodyPartPayloadInMultipartPayload(String contentType, byte[] fileContent, String name, String filename)
void	addHeader(String key, String value)	Add an HTTP Header to the Request
void	addOAuthParameter(String key, String value)	Adds an OAuth parameter.
void	addParameter(String key, String value)
void	addQuerystringParameter(String key, String value)	Add a QueryString parameter
ParameterList	getBodyParams()	Obtains a ParameterList of the body parameters.
byte[]	getByteArrayPayload()
String	getCharset()
String	getCompleteUrl()	Returns the complete url (host + resource + encoded querystring parameters).
File	getFilePayload()
Map<String,String>	getHeaders()
MultipartPayload	getMultipartPayload()
Map<String,String>	getOauthParameters()
ParameterList	getQueryStringParams()	Get a ParameterList with the query string parameters.
String	getRealm()
String	getSanitizedUrl()	Returns the URL without the port and the query string part.
String	getStringPayload()	Returns the body of the request (set in setPayload(java.lang.String))
String	getUrl()	Obtains the URL of the HTTP Request.
Verb	getVerb()
void	initMultipartPayload()
void	initMultipartPayload(String boundary)
void	initMultipartPayload(String subtype, String boundary)
void	initMultipartPayload(String subtype, String boundary, Map<String,String> headers)
void	initMultipartPayload(String boundary, Map<String,String> headers)
void	initMultipartPayload(Map<String,String> headers)
void	setByteArrayBodyPartPayloadInMultipartPayload(byte[] bodyPartPayload)
void	setByteArrayBodyPartPayloadInMultipartPayload(byte[] bodyPartPayload, String contentType)
void	setByteArrayBodyPartPayloadInMultipartPayload(byte[] bodyPartPayload, Map<String,String> headers)
void	setCharset(String charsetName)	Set the charset of the body of the request
void	setFileByteArrayBodyPartPayloadInMultipartPayload(byte[] fileContent)
void	setFileByteArrayBodyPartPayloadInMultipartPayload(byte[] fileContent, String name)
void	setFileByteArrayBodyPartPayloadInMultipartPayload(byte[] fileContent, String name, String filename)
void	setFileByteArrayBodyPartPayloadInMultipartPayload(FileByteArrayBodyPartPayload fileByteArrayBodyPartPayload)
void	setFileByteArrayBodyPartPayloadInMultipartPayload(String contentType, byte[] fileContent)
void	setFileByteArrayBodyPartPayloadInMultipartPayload(String contentType, byte[] fileContent, String name)
void	setFileByteArrayBodyPartPayloadInMultipartPayload(String contentType, byte[] fileContent, String name, String filename)
void	setMultipartPayload(MultipartPayload multipartPayload)
void	setPayload(byte[] payload)	Overloaded version for byte arrays
void	setPayload(File payload)	Overloaded version for File
void	setPayload(String payload)	Set body payload.
void	setRealm(String realm)
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

OAuthRequest

public OAuthRequest(Verb verb,
                    String url)

Default constructor.

Parameters:

verb - Http verb/method

url - resource URL

Method Detail

addOAuthParameter

public void addOAuthParameter(String key,
                              String value)

Adds an OAuth parameter.

Parameters:

key - name of the parameter

value - value of the parameter

Throws:

IllegalArgumentException - if the parameter is not an OAuth parameter

getOauthParameters

public Map<String,String> getOauthParameters()

setRealm

public void setRealm(String realm)

getRealm

public String getRealm()

getCompleteUrl

public String getCompleteUrl()

Returns the complete url (host + resource + encoded querystring parameters).

Returns:

the complete url.

addHeader

public void addHeader(String key,
                      String value)

Add an HTTP Header to the Request

Parameters:

key - the header name

value - the header value

addBodyParameter

public void addBodyParameter(String key,
                             String value)

Add a body Parameter (for POST/ PUT Requests)

Parameters:

key - the parameter name

value - the parameter value

addQuerystringParameter

public void addQuerystringParameter(String key,
                                    String value)

Add a QueryString parameter

Parameters:

key - the parameter name

value - the parameter value

addParameter

public void addParameter(String key,
                         String value)

getMultipartPayload

public MultipartPayload getMultipartPayload()

setMultipartPayload

public void setMultipartPayload(MultipartPayload multipartPayload)

initMultipartPayload

public void initMultipartPayload()

initMultipartPayload

public void initMultipartPayload(String boundary)

initMultipartPayload

public void initMultipartPayload(String subtype,
                                 String boundary)

initMultipartPayload

public void initMultipartPayload(Map<String,String> headers)

initMultipartPayload

public void initMultipartPayload(String boundary,
                                 Map<String,String> headers)

initMultipartPayload

public void initMultipartPayload(String subtype,
                                 String boundary,
                                 Map<String,String> headers)

setByteArrayBodyPartPayloadInMultipartPayload

public void setByteArrayBodyPartPayloadInMultipartPayload(byte[] bodyPartPayload)

setByteArrayBodyPartPayloadInMultipartPayload

public void setByteArrayBodyPartPayloadInMultipartPayload(byte[] bodyPartPayload,
                                                          String contentType)

setByteArrayBodyPartPayloadInMultipartPayload

public void setByteArrayBodyPartPayloadInMultipartPayload(byte[] bodyPartPayload,
                                                          Map<String,String> headers)

addByteArrayBodyPartPayloadInMultipartPayload

public void addByteArrayBodyPartPayloadInMultipartPayload(byte[] bodyPartPayload)

addByteArrayBodyPartPayloadInMultipartPayload

public void addByteArrayBodyPartPayloadInMultipartPayload(byte[] bodyPartPayload,
                                                          String contentType)

addByteArrayBodyPartPayloadInMultipartPayload

public void addByteArrayBodyPartPayloadInMultipartPayload(byte[] bodyPartPayload,
                                                          Map<String,String> headers)

setFileByteArrayBodyPartPayloadInMultipartPayload

public void setFileByteArrayBodyPartPayloadInMultipartPayload(byte[] fileContent)

setFileByteArrayBodyPartPayloadInMultipartPayload

public void setFileByteArrayBodyPartPayloadInMultipartPayload(String contentType,
                                                              byte[] fileContent)

setFileByteArrayBodyPartPayloadInMultipartPayload

public void setFileByteArrayBodyPartPayloadInMultipartPayload(byte[] fileContent,
                                                              String name)

setFileByteArrayBodyPartPayloadInMultipartPayload

public void setFileByteArrayBodyPartPayloadInMultipartPayload(String contentType,
                                                              byte[] fileContent,
                                                              String name)

setFileByteArrayBodyPartPayloadInMultipartPayload

public void setFileByteArrayBodyPartPayloadInMultipartPayload(byte[] fileContent,
                                                              String name,
                                                              String filename)

setFileByteArrayBodyPartPayloadInMultipartPayload

public void setFileByteArrayBodyPartPayloadInMultipartPayload(String contentType,
                                                              byte[] fileContent,
                                                              String name,
                                                              String filename)

setFileByteArrayBodyPartPayloadInMultipartPayload

public void setFileByteArrayBodyPartPayloadInMultipartPayload(FileByteArrayBodyPartPayload fileByteArrayBodyPartPayload)

addFileByteArrayBodyPartPayloadInMultipartPayload

public void addFileByteArrayBodyPartPayloadInMultipartPayload(byte[] fileContent)

addFileByteArrayBodyPartPayloadInMultipartPayload

public void addFileByteArrayBodyPartPayloadInMultipartPayload(String contentType,
                                                              byte[] fileContent)

addFileByteArrayBodyPartPayloadInMultipartPayload

public void addFileByteArrayBodyPartPayloadInMultipartPayload(byte[] fileContent,
                                                              String name)

addFileByteArrayBodyPartPayloadInMultipartPayload

public void addFileByteArrayBodyPartPayloadInMultipartPayload(String contentType,
                                                              byte[] fileContent,
                                                              String name)

addFileByteArrayBodyPartPayloadInMultipartPayload

public void addFileByteArrayBodyPartPayloadInMultipartPayload(byte[] fileContent,
                                                              String name,
                                                              String filename)

addFileByteArrayBodyPartPayloadInMultipartPayload

public void addFileByteArrayBodyPartPayloadInMultipartPayload(String contentType,
                                                              byte[] fileContent,
                                                              String name,
                                                              String filename)

addFileByteArrayBodyPartPayloadInMultipartPayload

public void addFileByteArrayBodyPartPayloadInMultipartPayload(FileByteArrayBodyPartPayload fileByteArrayBodyPartPayload)

setPayload

public void setPayload(String payload)

Set body payload. This method is used when the HTTP body is not a form-url-encoded string, but another thing. Like for example XML. Note: The contents are not part of the OAuth signature

Parameters:

payload - the body of the request

setPayload

public void setPayload(byte[] payload)

Overloaded version for byte arrays

Parameters:

payload - byte[]

setPayload

public void setPayload(File payload)

Overloaded version for File

Parameters:

payload - File

getQueryStringParams

public ParameterList getQueryStringParams()

Get a ParameterList with the query string parameters.

Returns:

a ParameterList containing the query string parameters.

Throws:

OAuthException - if the request URL is not valid.

getBodyParams

public ParameterList getBodyParams()

Obtains a ParameterList of the body parameters.

Returns:

a ParameterListcontaining the body parameters.

getUrl

public String getUrl()

Obtains the URL of the HTTP Request.

Returns:

the original URL of the HTTP Request

getSanitizedUrl

public String getSanitizedUrl()

Returns the URL without the port and the query string part.

Returns:

the OAuth-sanitized URL

getStringPayload

public String getStringPayload()

Returns the body of the request (set in setPayload(java.lang.String))

Returns:

form encoded string

getByteArrayPayload

public byte[] getByteArrayPayload()

Returns:

the body of the request (set in setPayload(byte[]) or in addBodyParameter(java.lang.String, java.lang.String) )

getFilePayload

public File getFilePayload()

toString

public String toString()

Overrides:

toString in class Object

getVerb

public Verb getVerb()

getHeaders

public Map<String,String> getHeaders()

getCharset

public String getCharset()

setCharset

public void setCharset(String charsetName)

Set the charset of the body of the request

Parameters:

charsetName - name of the charset of the request