com.atlassian.asap.core.keys.publickey

Class ChainedKeyProvider

java.lang.Object

com.atlassian.asap.core.keys.publickey.ChainedKeyProvider

All Implemented Interfaces:

KeyProvider<PublicKey>

public class ChainedKeyProvider
extends Object
implements KeyProvider<PublicKey>

Looks up keys sequentially in a given list of key providers.

Note that the current implementation doesn't perform any caching, in particular it doesn't remember where the key was found last time. That may reduce the effectiveness of the provider's http cache if it comes later in the keyProviderChain.

Method Summary

Modifier and Type	Method and Description
static KeyProvider<PublicKey>	createChainedKeyProvider(List<KeyProvider<PublicKey>> keyProviderChain) Create a chained key provider representing a given list of key repository providers.
PublicKey	getKey(ValidatedKeyId validatedKeyId) Provides a Key for a validated key identifier.
List<KeyProvider<PublicKey>>	getKeyProviderChain()

Methods inherited from class java.lang.Object

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

Method Detail

createChainedKeyProvider

public static KeyProvider<PublicKey> createChainedKeyProvider(List<KeyProvider<PublicKey>> keyProviderChain)

Create a chained key provider representing a given list of key repository providers. If there is only one provider in the chain, then return the provider instead of wrapping it.

Parameters:

keyProviderChain - set of chained key repository providers in order

Returns:

the chained key provider if there are more than one providers, or a key provider when it is the only provider in the chain

getKey

public PublicKey getKey(ValidatedKeyId validatedKeyId)
                 throws CannotRetrieveKeyException

Description copied from interface: KeyProvider

Provides a Key for a validated key identifier.

Specified by:

getKey in interface KeyProvider<PublicKey>

Parameters:

validatedKeyId - the validated keyId of interest which is safe from directory traversal

Returns:

the relevant key if found

Throws:

CannotRetrieveKeyException - if the key couldn't be retrieved or found.

getKeyProviderChain

public List<KeyProvider<PublicKey>> getKeyProviderChain()

Returns:

the chain of key providers in the same order as they are consulted to resolve a key