org.jclouds.cache

Class RetryingCacheLoaderDecorator<K,V>

java.lang.Object

org.jclouds.cache.RetryingCacheLoaderDecorator<K,V>

Type Parameters:

K - the base key type for all cache loaders created by this decorator

V - the base value type for all cache loaders created by this decorator

Direct Known Subclasses:

RetryingCacheLoaderDecorator.BackoffExponentiallyAndRetryOnThrowableCacheLoaderDecorator

@Beta
public class RetryingCacheLoaderDecorator<K,V>
extends Object

A decorator of CacheLoader instances having any combination of the following features:

• exponential backoff based on a particular Throwable type

These features are all optional; cache loaders can be created using all or none of them. By default, the input cache loader is returned unaffected.

Usage example:

Since:

1.5

Author:

Adrian Cole

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RetryingCacheLoaderDecorator.BackoffExponentiallyAndRetryOnThrowableCacheLoaderDecorator<K,V>
static class	RetryingCacheLoaderDecorator.OnThrowableBuilder<K,V>

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	RetryingCacheLoaderDecorator()

Method Summary

Methods

Modifier and Type	Method and Description
<K1 extends K,V1 extends V> com.google.common.cache.CacheLoader<K1,V1>	decorate(com.google.common.cache.CacheLoader<K1,V1> loader) Decorates a cacheloader, or returns the same value, if no retrying features were requested.
static RetryingCacheLoaderDecorator<Object,Object>	newDecorator() Constructs a new RetryingCacheLoaderDecorator instance with default settings, and no retrying any kind.
RetryingCacheLoaderDecorator.OnThrowableBuilder<K,V>	on(Class<? extends Throwable> retryableThrowable) Determines the action to carry out on a particular throwable.
protected com.google.common.base.Objects.ToStringHelper	string() append any state that should be considered in toString() here.
String	toString() Returns a string representation for this RetryingCacheLoaderDecorator instance.

Methods inherited from class java.lang.Object

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

Constructor Detail

RetryingCacheLoaderDecorator

protected RetryingCacheLoaderDecorator()

Method Detail

newDecorator

public static RetryingCacheLoaderDecorator<Object,Object> newDecorator()

Constructs a new RetryingCacheLoaderDecorator instance with default settings, and no retrying any kind.

on

public RetryingCacheLoaderDecorator.OnThrowableBuilder<K,V> on(Class<? extends Throwable> retryableThrowable)

Determines the action to carry out on a particular throwable.

decorate

public <K1 extends K,V1 extends V> com.google.common.cache.CacheLoader<K1,V1> decorate(com.google.common.cache.CacheLoader<K1,V1> loader)

Decorates a cacheloader, or returns the same value, if no retrying features were requested.

This method does not alter the state of this RetryingCacheLoaderDecorator instance, so it can be invoked again to create multiple independent cache loaders.

Parameters:

loader - the cache loader used to obtain new values

Returns:

a cache loader having the requested features

toString

public String toString()

Returns a string representation for this RetryingCacheLoaderDecorator instance. The exact form of the returned string is not specified.

Overrides:

toString in class Object

string

protected com.google.common.base.Objects.ToStringHelper string()

append any state that should be considered in toString() here.