net.oauth.signature

Class OAuthSignatureMethod

java.lang.Object

net.oauth.signature.OAuthSignatureMethod

Direct Known Subclasses:

RSA_SHA1

public abstract class OAuthSignatureMethod
extends Object

A pair of algorithms for computing and verifying an OAuth digital signature.

Static methods of this class implement a registry of signature methods. It's pre-populated with the standard OAuth algorithms. Appliations can replace them or add new ones.

Author:

John Kristian

Field Summary

Fields

Modifier and Type	Field and Description
static String	_ACCESSOR

Constructor Summary

Constructors

Constructor and Description
OAuthSignatureMethod()

Method Summary

Modifier and Type	Method and Description
static String	base64Encode(byte[] b)
static byte[]	decodeBase64(String s)
static boolean	equals(byte[] a, byte[] b) Determine whether the given arrays contain the same sequence of bytes.
static boolean	equals(String x, String y) Determine whether the given strings contain the same sequence of characters.
static String	getBaseString(OAuthMessage message)
protected String	getConsumerSecret()
protected String	getSignature(OAuthMessage message)
protected abstract String	getSignature(String baseString) Compute the signature for the given base string.
String	getTokenSecret()
protected void	initialize(String name, OAuthAccessor accessor)
protected abstract boolean	isValid(String signature, String baseString) Decide whether the signature is valid.
static OAuthSignatureMethod	newMethod(String name, OAuthAccessor accessor) The factory for signature methods.
static OAuthSignatureMethod	newSigner(OAuthMessage message, OAuthAccessor accessor)
protected static String	normalizeParameters(Collection<? extends Map.Entry> parameters)
protected static String	normalizeUrl(String url)
static void	registerMethodClass(String name, Class clazz) Subsequently, newMethod(name) will attempt to instantiate the given class, with no constructor parameters.
protected void	setConsumerSecret(String consumerSecret)
void	setTokenSecret(String tokenSecret)
void	sign(OAuthMessage message) Add a signature to the message.
static void	unregisterMethod(String name) Subsequently, newMethod(name) will fail.
void	validate(OAuthMessage message) Check whether the message has a valid signature.

Methods inherited from class java.lang.Object

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

Field Detail

_ACCESSOR

public static final String _ACCESSOR

See Also:

Constant Field Values

Constructor Detail

OAuthSignatureMethod

public OAuthSignatureMethod()

Method Detail

sign

public void sign(OAuthMessage message)
          throws OAuthException,
                 IOException,
                 URISyntaxException

Add a signature to the message.

Throws:

URISyntaxException

IOException

OAuthException

validate

public void validate(OAuthMessage message)
              throws IOException,
                     OAuthException,
                     URISyntaxException

Check whether the message has a valid signature.

Throws:

URISyntaxException

OAuthProblemException - the signature is invalid

IOException

OAuthException

getSignature

protected String getSignature(OAuthMessage message)
                       throws OAuthException,
                              IOException,
                              URISyntaxException

Throws:

OAuthException

IOException

URISyntaxException

initialize

protected void initialize(String name,
                          OAuthAccessor accessor)
                   throws OAuthException

Throws:

OAuthException

getSignature

protected abstract String getSignature(String baseString)
                                throws OAuthException

Compute the signature for the given base string.

Throws:

OAuthException

isValid

protected abstract boolean isValid(String signature,
                                   String baseString)
                            throws OAuthException

Decide whether the signature is valid.

Throws:

OAuthException

getConsumerSecret

protected String getConsumerSecret()

setConsumerSecret

protected void setConsumerSecret(String consumerSecret)

getTokenSecret

public String getTokenSecret()

setTokenSecret

public void setTokenSecret(String tokenSecret)

getBaseString

public static String getBaseString(OAuthMessage message)
                            throws IOException,
                                   URISyntaxException

Throws:

IOException

URISyntaxException

normalizeUrl

protected static String normalizeUrl(String url)
                              throws URISyntaxException

Throws:

URISyntaxException

normalizeParameters

protected static String normalizeParameters(Collection<? extends Map.Entry> parameters)
                                     throws IOException

Throws:

IOException

equals

public static boolean equals(String x,
                             String y)

Determine whether the given strings contain the same sequence of characters. The implementation discourages a timing attack.

equals

public static boolean equals(byte[] a,
                             byte[] b)

Determine whether the given arrays contain the same sequence of bytes. The implementation discourages a timing attack.

decodeBase64

public static byte[] decodeBase64(String s)

base64Encode

public static String base64Encode(byte[] b)

newSigner

public static OAuthSignatureMethod newSigner(OAuthMessage message,
                                             OAuthAccessor accessor)
                                      throws IOException,
                                             OAuthException

Throws:

IOException

OAuthException

newMethod

public static OAuthSignatureMethod newMethod(String name,
                                             OAuthAccessor accessor)
                                      throws OAuthException

The factory for signature methods.

Throws:

OAuthException

registerMethodClass

public static void registerMethodClass(String name,
                                       Class clazz)

Subsequently, newMethod(name) will attempt to instantiate the given class, with no constructor parameters.

unregisterMethod

public static void unregisterMethod(String name)

Subsequently, newMethod(name) will fail.