com.sun.jersey.oauth.signature
Class OAuthParameters

java.lang.Object
  extended by java.util.AbstractMap<K,V>
      extended by java.util.HashMap<String,String>
          extended by com.sun.jersey.oauth.signature.OAuthParameters
All Implemented Interfaces:
Serializable, Cloneable, Map<String,String>

public class OAuthParameters
extends HashMap<String,String>

A data structure class that represents OAuth protocol parameters.

Author:
Hubert A. Le Van Gong , Paul C. Bryan
See Also:
Serialized Form

Nested Class Summary
 
Nested classes/interfaces inherited from class java.util.AbstractMap
AbstractMap.SimpleEntry<K,V>, AbstractMap.SimpleImmutableEntry<K,V>
 
Field Summary
static String AUTHORIZATION_HEADER
          Name of HTTP authorization header.
static String CALLBACK
          Name of parameter containing the callback URL.
static String CALLBACK_CONFIRMED
          Name of parameter containing the token secret.
static String CONSUMER_KEY
          Name of parameter containing the consumer key.
static String NONCE
          Name of parameter containing the nonce.
static String REALM
          Name of parameter containing the protection realm.
static String SCHEME
          OAuth scheme in Authorization header.
static String SIGNATURE
          Name of parameter containing the signature.
static String SIGNATURE_METHOD
          Name of parameter containing the signature method.
static String TIMESTAMP
          Name of parameter containing the timestamp.
static String TOKEN
          Name of parameter containing the access/request token.
static String TOKEN_SECRET
          Name of parameter containing the token secret.
static String VERIFIER
          Name of parameter containing the verifier code.
static String VERSION
          Name of parameter containing the protocol version.
 
Constructor Summary
OAuthParameters()
           
 
Method Summary
 OAuthParameters callback(String callback)
          Builder pattern method to return OAuthParameters after setting callback URL.
 OAuthParameters consumerKey(String consumerKey)
          Builder pattern method to return OAuthParameters after setting consumer key.
 String getCallback()
          Returns the callback URL.
 String getConsumerKey()
          Returns the consumer key.
 String getNonce()
          Returns the nonce, a value that should be unique for a given timestamp.
 String getRealm()
          Returns the protection realm for the request.
 String getSignature()
          Returns the signature for the request.
 String getSignatureMethod()
          Returns the signature method used to sign the request.
 String getTimestamp()
          Returns the timestamp, a value expected to be a positive integer, typically containing the number of seconds since January 1, 1970 00:00:00 GMT (epoch).
 String getToken()
          Returns the request or access token.
 String getVerifier()
          Returns the verifier code.
 String getVersion()
          Returns the protocol version.
 OAuthParameters nonce()
          Builder pattern method to return OAuthParameters after setting nonce to a randomly-generated UUID.
 OAuthParameters nonce(String nonce)
          Builder pattern method to return OAuthParameters after setting nonce.
 OAuthParameters readRequest(OAuthRequest request)
          Reads a request for OAuth parameters, and populates this object.
 OAuthParameters realm(String realm)
          Builder pattern method to return OAuthParameters after setting protection realm.
 void setCallback(String callback)
          Sets the callback URL.
 void setConsumerKey(String consumerKey)
          Sets the consumer key.
 void setNonce()
          Sets the nonce to contain a randomly-generated UUID.
 void setNonce(String nonce)
          Sets the nonce, a value that should be unique for a given timestamp.
 void setRealm(String realm)
          Sets the protection realm for the request.
 void setSignature(String signature)
          Sets the signature for the request.
 void setSignatureMethod(String signatureMethod)
          Sets the signature method used to sign the request.
 void setTimestamp()
          Sets the timestamp to the current time as number of seconds since epoch.
 void setTimestamp(String timestamp)
          Sets the timestamp.
 void setToken(String token)
          Sets the request or access token.
 void setVerifier(String verifier)
          Sets the verifier code.
 void setVersion()
          Sets the protocol version to the default value of 1.0.
 void setVersion(String version)
          Sets the protocol version.
 OAuthParameters signature(String signature)
          Builder pattern method to return OAuthParameters after setting signature.
 OAuthParameters signatureMethod(String signatureMethod)
          Builder pattern method to return OAuthParameters after setting signature method.
 OAuthParameters timestamp()
          Builder pattern method to return OAuthParameters after setting timestamp to the current time.
 OAuthParameters timestamp(String timestamp)
          Builder pattern method to return OAuthParameters after setting timestamp.
 OAuthParameters token(String token)
          Builder pattern method to return OAuthParameters after setting token.
 OAuthParameters verifier(String verifier)
          Builder pattern method to return OAuthParameters after setting verifier code.
 OAuthParameters version()
          Builder pattern method to return OAuthParameters after setting version to the default value of 1.0.
 OAuthParameters version(String version)
          Builder pattern method to return OAuthParameters after setting version.
 OAuthParameters writeRequest(OAuthRequest request)
          Writes the OAuth parameters to a request, as an Authorization header.
 
Methods inherited from class java.util.HashMap
clear, clone, containsKey, containsValue, entrySet, get, isEmpty, keySet, put, putAll, remove, size, values
 
Methods inherited from class java.util.AbstractMap
equals, hashCode, toString
 
Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface java.util.Map
equals, hashCode
 

Field Detail

AUTHORIZATION_HEADER

public static final String AUTHORIZATION_HEADER
Name of HTTP authorization header.

See Also:
Constant Field Values

SCHEME

public static final String SCHEME
OAuth scheme in Authorization header.

See Also:
Constant Field Values

REALM

public static final String REALM
Name of parameter containing the protection realm.

See Also:
Constant Field Values

CONSUMER_KEY

public static final String CONSUMER_KEY
Name of parameter containing the consumer key.

See Also:
Constant Field Values

TOKEN

public static final String TOKEN
Name of parameter containing the access/request token.

See Also:
Constant Field Values

SIGNATURE_METHOD

public static final String SIGNATURE_METHOD
Name of parameter containing the signature method.

See Also:
Constant Field Values

SIGNATURE

public static final String SIGNATURE
Name of parameter containing the signature.

See Also:
Constant Field Values

TIMESTAMP

public static final String TIMESTAMP
Name of parameter containing the timestamp.

See Also:
Constant Field Values

NONCE

public static final String NONCE
Name of parameter containing the nonce.

See Also:
Constant Field Values

VERSION

public static final String VERSION
Name of parameter containing the protocol version.

See Also:
Constant Field Values

VERIFIER

public static final String VERIFIER
Name of parameter containing the verifier code.

See Also:
Constant Field Values

CALLBACK

public static final String CALLBACK
Name of parameter containing the callback URL.

See Also:
Constant Field Values

TOKEN_SECRET

public static final String TOKEN_SECRET
Name of parameter containing the token secret. This parameter is never used in requests. It is part of a response to the request token and access token requests.

See Also:
Constant Field Values

CALLBACK_CONFIRMED

public static final String CALLBACK_CONFIRMED
Name of parameter containing the token secret. This parameter is never used in requests. It is part of a response to the request token requests.

See Also:
Constant Field Values
Constructor Detail

OAuthParameters

public OAuthParameters()
Method Detail

getRealm

public String getRealm()
Returns the protection realm for the request.


setRealm

public void setRealm(String realm)
Sets the protection realm for the request.


realm

public OAuthParameters realm(String realm)
Builder pattern method to return OAuthParameters after setting protection realm.

Parameters:
realm - the protection realm for the request.
Returns:
this parameters object.

getConsumerKey

public String getConsumerKey()
Returns the consumer key.


setConsumerKey

public void setConsumerKey(String consumerKey)
Sets the consumer key.


consumerKey

public OAuthParameters consumerKey(String consumerKey)
Builder pattern method to return OAuthParameters after setting consumer key.

Parameters:
consumerKey - the consumer key.

getToken

public String getToken()
Returns the request or access token.


setToken

public void setToken(String token)
Sets the request or access token.


token

public OAuthParameters token(String token)
Builder pattern method to return OAuthParameters after setting token.

Parameters:
token - the access or request token.
Returns:
this parameters object.

getSignatureMethod

public String getSignatureMethod()
Returns the signature method used to sign the request.


setSignatureMethod

public void setSignatureMethod(String signatureMethod)
Sets the signature method used to sign the request.


signatureMethod

public OAuthParameters signatureMethod(String signatureMethod)
Builder pattern method to return OAuthParameters after setting signature method.

Parameters:
signatureMethod - the signature method used to sign the request.
Returns:
this parameters object.

getSignature

public String getSignature()
Returns the signature for the request.


setSignature

public void setSignature(String signature)
Sets the signature for the request.


signature

public OAuthParameters signature(String signature)
Builder pattern method to return OAuthParameters after setting signature.

Parameters:
signature - the signature for the request.
Returns:
this parameters object.

getTimestamp

public String getTimestamp()
Returns the timestamp, a value expected to be a positive integer, typically containing the number of seconds since January 1, 1970 00:00:00 GMT (epoch).


setTimestamp

public void setTimestamp(String timestamp)
Sets the timestamp. Its value is not validated, but should be a positive integer, typically containing the number of seconds since January 1, 1970 00:00:00 GMT (epoch).


timestamp

public OAuthParameters timestamp(String timestamp)
Builder pattern method to return OAuthParameters after setting timestamp.

Parameters:
timestamp - positive integer, typically number of seconds since epoch.
Returns:
this parameters object.

setTimestamp

public void setTimestamp()
Sets the timestamp to the current time as number of seconds since epoch.


timestamp

public OAuthParameters timestamp()
Builder pattern method to return OAuthParameters after setting timestamp to the current time.

Returns:
this parameters object.

getNonce

public String getNonce()
Returns the nonce, a value that should be unique for a given timestamp.


setNonce

public void setNonce(String nonce)
Sets the nonce, a value that should be unique for a given timestamp.


nonce

public OAuthParameters nonce(String nonce)
Builder pattern method to return OAuthParameters after setting nonce.

Parameters:
nonce - a value that should be unique for a given timestamp.
Returns:
this parameters object.

setNonce

public void setNonce()
Sets the nonce to contain a randomly-generated UUID.


nonce

public OAuthParameters nonce()
Builder pattern method to return OAuthParameters after setting nonce to a randomly-generated UUID.

Returns:
this parameters object.

getVersion

public String getVersion()
Returns the protocol version.


setVersion

public void setVersion(String version)
Sets the protocol version.


version

public OAuthParameters version(String version)
Builder pattern method to return OAuthParameters after setting version.

Parameters:
version - the protocol version.
Returns:
this parameters object.

setVersion

public void setVersion()
Sets the protocol version to the default value of 1.0.


version

public OAuthParameters version()
Builder pattern method to return OAuthParameters after setting version to the default value of 1.0.

Returns:
this parameters object.

getVerifier

public String getVerifier()
Returns the verifier code.


setVerifier

public void setVerifier(String verifier)
Sets the verifier code.


verifier

public OAuthParameters verifier(String verifier)
Builder pattern method to return OAuthParameters after setting verifier code.

Parameters:
verifier - the verifier code.
Returns:
this parameters object.

getCallback

public String getCallback()
Returns the callback URL.


setCallback

public void setCallback(String callback)
Sets the callback URL.


callback

public OAuthParameters callback(String callback)
Builder pattern method to return OAuthParameters after setting callback URL.

Parameters:
callback - the callback URL.
Returns:
this parameters object.

readRequest

public OAuthParameters readRequest(OAuthRequest request)
Reads a request for OAuth parameters, and populates this object.

Parameters:
request - the request to read OAuth parameters from.
Returns:
this parameters object.

writeRequest

public OAuthParameters writeRequest(OAuthRequest request)
Writes the OAuth parameters to a request, as an Authorization header.

Parameters:
request - the request to write OAuth parameters to.
Returns:
this parameters object.


Copyright © 2013 Oracle Corporation. All Rights Reserved.