Package com.github.scribejava.core.model
Class OAuthRequest
java.lang.Object
com.github.scribejava.core.model.OAuthRequest
public class OAuthRequest
extends java.lang.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, java.lang.String url)
Default constructor. -
Method Summary
Modifier and Type Method Description void
addBodyParameter(java.lang.String key, java.lang.String value)
Add a body Parameter (for POST/ PUT Requests)void
addBodyPartPayloadInMultipartPayload(BodyPartPayload bodyPartPayload)
void
addHeader(java.lang.String key, java.lang.String value)
Add an HTTP Header to the Requestvoid
addOAuthParameter(java.lang.String key, java.lang.String value)
Adds an OAuth parameter.void
addParameter(java.lang.String key, java.lang.String value)
void
addQuerystringParameter(java.lang.String key, java.lang.String value)
Add a QueryString parameterParameterList
getBodyParams()
Obtains aParameterList
of the body parameters.byte[]
getByteArrayPayload()
java.lang.String
getCharset()
java.lang.String
getCompleteUrl()
Returns the complete url (host + resource + encoded querystring parameters).java.io.File
getFilePayload()
java.util.Map<java.lang.String,java.lang.String>
getHeaders()
MultipartPayload
getMultipartPayload()
java.util.Map<java.lang.String,java.lang.String>
getOauthParameters()
ParameterList
getQueryStringParams()
Get aParameterList
with the query string parameters.java.lang.String
getRealm()
java.lang.String
getSanitizedUrl()
Returns the URL without the port and the query string part.java.lang.String
getStringPayload()
Returns the body of the request (set insetPayload(java.lang.String)
)java.lang.String
getUrl()
Obtains the URL of the HTTP Request.Verb
getVerb()
void
initMultipartPayload()
void
initMultipartPayload(java.lang.String boundary)
void
initMultipartPayload(java.lang.String subtype, java.lang.String boundary)
void
initMultipartPayload(java.lang.String subtype, java.lang.String boundary, java.util.Map<java.lang.String,java.lang.String> headers)
void
initMultipartPayload(java.lang.String boundary, java.util.Map<java.lang.String,java.lang.String> headers)
void
initMultipartPayload(java.util.Map<java.lang.String,java.lang.String> headers)
void
setBodyPartPayloadInMultipartPayload(BodyPartPayload bodyPartPayload)
void
setCharset(java.lang.String charsetName)
Set the charset of the body of the requestvoid
setMultipartPayload(MultipartPayload multipartPayload)
void
setPayload(byte[] payload)
Overloaded version for byte arraysvoid
setPayload(java.io.File payload)
Overloaded version for Filevoid
setPayload(java.lang.String payload)
Set body payload.void
setRealm(java.lang.String realm)
java.lang.String
toString()
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Constructor Details
-
OAuthRequest
Default constructor.- Parameters:
verb
- Http verb/methodurl
- resource URL
-
-
Method Details
-
addOAuthParameter
public void addOAuthParameter(java.lang.String key, java.lang.String value)Adds an OAuth parameter.- Parameters:
key
- name of the parametervalue
- value of the parameter- Throws:
java.lang.IllegalArgumentException
- if the parameter is not an OAuth parameter
-
getOauthParameters
public java.util.Map<java.lang.String,java.lang.String> getOauthParameters() -
setRealm
public void setRealm(java.lang.String realm) -
getRealm
public java.lang.String getRealm() -
getCompleteUrl
public java.lang.String getCompleteUrl()Returns the complete url (host + resource + encoded querystring parameters).- Returns:
- the complete url.
-
addHeader
public void addHeader(java.lang.String key, java.lang.String value)Add an HTTP Header to the Request- Parameters:
key
- the header namevalue
- the header value
-
addBodyParameter
public void addBodyParameter(java.lang.String key, java.lang.String value)Add a body Parameter (for POST/ PUT Requests)- Parameters:
key
- the parameter namevalue
- the parameter value
-
addQuerystringParameter
public void addQuerystringParameter(java.lang.String key, java.lang.String value)Add a QueryString parameter- Parameters:
key
- the parameter namevalue
- the parameter value
-
addParameter
public void addParameter(java.lang.String key, java.lang.String value) -
getMultipartPayload
-
setMultipartPayload
-
initMultipartPayload
public void initMultipartPayload() -
initMultipartPayload
public void initMultipartPayload(java.lang.String boundary) -
initMultipartPayload
public void initMultipartPayload(java.lang.String subtype, java.lang.String boundary) -
initMultipartPayload
public void initMultipartPayload(java.util.Map<java.lang.String,java.lang.String> headers) -
initMultipartPayload
public void initMultipartPayload(java.lang.String boundary, java.util.Map<java.lang.String,java.lang.String> headers) -
initMultipartPayload
public void initMultipartPayload(java.lang.String subtype, java.lang.String boundary, java.util.Map<java.lang.String,java.lang.String> headers) -
setBodyPartPayloadInMultipartPayload
-
addBodyPartPayloadInMultipartPayload
-
setPayload
public void setPayload(java.lang.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(java.io.File payload)Overloaded version for File- Parameters:
payload
- File
-
getQueryStringParams
Get aParameterList
with the query string parameters.- Returns:
- a
ParameterList
containing the query string parameters. - Throws:
OAuthException
- if the request URL is not valid.
-
getBodyParams
Obtains aParameterList
of the body parameters.- Returns:
- a
ParameterList
containing the body parameters.
-
getUrl
public java.lang.String getUrl()Obtains the URL of the HTTP Request.- Returns:
- the original URL of the HTTP Request
-
getSanitizedUrl
public java.lang.String getSanitizedUrl()Returns the URL without the port and the query string part.- Returns:
- the OAuth-sanitized URL
-
getStringPayload
public java.lang.String getStringPayload()Returns the body of the request (set insetPayload(java.lang.String)
)- Returns:
- form encoded string
-
getByteArrayPayload
public byte[] getByteArrayPayload()- Returns:
- the body of the request (set in
setPayload(byte[])
or inaddBodyParameter(java.lang.String, java.lang.String)
)
-
getFilePayload
public java.io.File getFilePayload() -
toString
public java.lang.String toString()- Overrides:
toString
in classjava.lang.Object
-
getVerb
-
getHeaders
public java.util.Map<java.lang.String,java.lang.String> getHeaders() -
getCharset
public java.lang.String getCharset() -
setCharset
public void setCharset(java.lang.String charsetName)Set the charset of the body of the request- Parameters:
charsetName
- name of the charset of the request
-