AbstractRequest (ScribeJava Core 2.1.0 API)

java.lang.Object
- com.github.scribejava.core.model.AbstractRequest

Direct Known Subclasses:

OAuthRequest, OAuthRequestAsync
```
public abstract class AbstractRequest
extends Object
```
The representation of an OAuth HttpRequest.

Author:

Pablo Fernandez

Field Summary

Fields
Modifier and Type Field and Description

protected static String CONTENT_LENGTH

protected static String CONTENT_TYPE

static String DEFAULT_CONTENT_TYPE

Fields
Modifier and Type	Field and Description
`protected static String`	`CONTENT_LENGTH`
`protected static String`	`CONTENT_TYPE`
`static String`	`DEFAULT_CONTENT_TYPE`

Constructor Summary

Constructors
Constructor and Description

AbstractRequest(Verb verb, String url, OAuthService service)
Default constructor.

Constructors
Constructor and Description
`AbstractRequest(Verb verb, String url, OAuthService service)` Default constructor.

Method Summary

All Methods Instance Methods Concrete Methods
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`	`addPayload(byte[] payload)` Overloaded version for byte arrays
`void`	`addPayload(String payload)` Add body payload.
`void`	`addQuerystringParameter(String key, String value)` Add a QueryString parameter
`String`	`getBodyContents()` Returns the body of the request
`ParameterList`	`getBodyParams()` Obtains a `ParameterList` of the body parameters.
`String`	`getCharset()`
`String`	`getCompleteUrl()` Returns the complete url (host + resource + encoded querystring parameters).
`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.
`OAuthService`	`getService()`
`String`	`getUrl()` Obtains the URL of the HTTP Request.
`Verb`	`getVerb()`
`protected boolean`	`hasBodyContent()`
`boolean`	`isConnectionKeepAlive()`
`boolean`	`isFollowRedirects()`
`void`	`setCharset(String charsetName)` Set the charset of the body of the request
`void`	`setConnectionKeepAlive(boolean connectionKeepAlive)` Sets whether the underlying Http Connection is persistent or not.
`void`	`setFollowRedirects(boolean followRedirects)` Sets whether the underlying Http Connection follows redirects or not.
`void`	`setRealm(String realm)`
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - CONTENT_LENGTH
```
protected static final String CONTENT_LENGTH
```
    See Also:
    
    Constant Field Values
  - CONTENT_TYPE
```
protected static final String CONTENT_TYPE
```
    See Also:
    
    Constant Field Values
  - DEFAULT_CONTENT_TYPE
```
public static final String DEFAULT_CONTENT_TYPE
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - AbstractRequest
```
public AbstractRequest(Verb verb,
                       String url,
                       OAuthService service)
```
    Default constructor.
    
    Parameters:
    
    verb - Http verb/method
    
    url - resource URL
    
    service - OAuthService
- 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()
```
  - addPayload
```
public void addPayload(String payload)
```
    Add 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
  - addPayload
```
public void addPayload(byte[] payload)
```
    Overloaded version for byte arrays
    
    Parameters:
    
    payload - byte[]
  - 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
  - getBodyContents
```
public String getBodyContents()
```
    Returns the body of the request
    
    Returns:
    
    form encoded string
    
    Throws:
    
    OAuthException - if the charset chosen is not supported
  - 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
  - setConnectionKeepAlive
```
public void setConnectionKeepAlive(boolean connectionKeepAlive)
```
    Sets whether the underlying Http Connection is persistent or not.
    
    Parameters:
    
    connectionKeepAlive - boolean
    
    See Also:
    
    http://download.oracle.com/javase/1.5.0/docs/guide/net/http-keepalive.html
  - setFollowRedirects
```
public void setFollowRedirects(boolean followRedirects)
```
    Sets whether the underlying Http Connection follows redirects or not. Defaults to true (follow redirects)
    
    Parameters:
    
    followRedirects - boolean
    
    See Also:
    
    http://docs.oracle.com/javase/6/docs/api/java/net/HttpURLConnection.html#setInstanceFollowRedirects(boolean)
  - isConnectionKeepAlive
```
public boolean isConnectionKeepAlive()
```
  - isFollowRedirects
```
public boolean isFollowRedirects()
```
  - getService
```
public OAuthService getService()
```

Class AbstractRequest

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

CONTENT_LENGTH

CONTENT_TYPE

DEFAULT_CONTENT_TYPE

Constructor Detail

AbstractRequest

Method Detail

addOAuthParameter

getOauthParameters

setRealm

getRealm

getCompleteUrl

addHeader

addBodyParameter

addQuerystringParameter

addParameter

hasBodyContent

addPayload

addPayload

getQueryStringParams

getBodyParams

getUrl

getSanitizedUrl

getBodyContents

toString

getVerb

getHeaders

getCharset

setCharset

setConnectionKeepAlive

setFollowRedirects

isConnectionKeepAlive

isFollowRedirects

getService