com.github.scribejava.core.model

Class OAuthRequest

java.lang.Object

com.github.scribejava.core.model.AbstractRequest

com.github.scribejava.core.model.OAuthRequest

Direct Known Subclasses:

OAuthRequestAsync

public class OAuthRequest
extends AbstractRequest

The representation of an OAuth HttpRequest.

Nested Class Summary

Nested Classes

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

Constructor Summary

Constructors

Constructor and Description
OAuthRequest(Verb verb, String url) Default constructor.
OAuthRequest(Verb verb, String url, OAuthConfig config) Deprecated. use OAuthRequest(com.github.scribejava.core.model.Verb, java.lang.String)

Method Summary

Modifier and Type	Method and Description
void	addBodyParameter(String key, String value) Add a body Parameter (for POST/ PUT Requests)
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()
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()
protected boolean	hasBodyContent()
void	setCharset(String charsetName) Set the charset of the body of the request
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

OAuthRequest

@Deprecated
public OAuthRequest(Verb verb,
                                String url,
                                OAuthConfig config)

Deprecated. use OAuthRequest(com.github.scribejava.core.model.Verb, java.lang.String)

Parameters:

verb - verb

url - url

config - unused

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)

hasBodyContent

protected boolean hasBodyContent()

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