Package org.opendaylight.controller.md.sal.common.api

Class MappingCheckedFuture<V,X extends Exception>

java.lang.Object

com.google.common.collect.ForwardingObject

com.google.common.util.concurrent.ForwardingFuture<V>

com.google.common.util.concurrent.ForwardingListenableFuture<V>

com.google.common.util.concurrent.ForwardingListenableFuture.SimpleForwardingListenableFuture<V>

com.google.common.util.concurrent.AbstractCheckedFuture<V,X>

org.opendaylight.controller.md.sal.common.api.MappingCheckedFuture<V,X>

Type Parameters:

V - The result type returned by this Future's get method

X - The checked exception type

All Implemented Interfaces:

CheckedFuture<V,X>, ListenableFuture<V>, Future<V>

@Deprecated(forRemoval=true)
public final class MappingCheckedFuture<V,X extends Exception>
extends AbstractCheckedFuture<V,X>

Deprecated, for removal: This API element is subject to removal in a future version.

An implementation of CheckedFuture that provides similar behavior for the get methods that the checkedGet methods provide.

For CancellationException and InterruptedException, the specified exception mapper is invoked to translate them to the checked exception type.

For ExecutionException, the mapper is invoked to translate the cause to the checked exception and a new ExecutionException is thrown with the translated cause.

Author:

Thomas Pantelis

Nested Class Summary

Nested classes/interfaces inherited from class com.google.common.util.concurrent.ForwardingListenableFuture

ForwardingListenableFuture.SimpleForwardingListenableFuture<V extends Object>

Nested classes/interfaces inherited from class com.google.common.util.concurrent.ForwardingFuture

ForwardingFuture.SimpleForwardingFuture<V extends Object>

Method Summary

Modifier and Type	Method	Description
static <V,X extends Exception> MappingCheckedFuture<V,X>	create(ListenableFuture<V> delegate, Function<Exception,X> mapper)	Deprecated, for removal: This API element is subject to removal in a future version. Creates a new MappingCheckedFuture that wraps the given ListenableFuture delegate.
V	get()	Deprecated, for removal: This API element is subject to removal in a future version.
V	get(long timeout, TimeUnit unit)	Deprecated, for removal: This API element is subject to removal in a future version.
protected X	mapException(Exception e)	Deprecated, for removal: This API element is subject to removal in a future version.

Methods inherited from class com.google.common.util.concurrent.AbstractCheckedFuture

checkedGet, checkedGet

Methods inherited from class com.google.common.util.concurrent.ForwardingListenableFuture.SimpleForwardingListenableFuture

delegate

Methods inherited from class com.google.common.util.concurrent.ForwardingListenableFuture

addListener

Methods inherited from class com.google.common.util.concurrent.ForwardingFuture

cancel, isCancelled, isDone

Methods inherited from class com.google.common.collect.ForwardingObject

toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.concurrent.Future

cancel, isCancelled, isDone

Methods inherited from interface com.google.common.util.concurrent.ListenableFuture

addListener

Method Detail

create

public static <V,X extends Exception> MappingCheckedFuture<V,X> create(ListenableFuture<V> delegate,
                                                                                   Function<Exception,X> mapper)

Deprecated, for removal: This API element is subject to removal in a future version.

Creates a new MappingCheckedFuture that wraps the given ListenableFuture delegate.

Parameters:

delegate - the ListenableFuture to wrap

mapper - the mapping Function used to translate exceptions from the delegate

Returns:

a new MappingCheckedFuture

mapException

protected X mapException(Exception e)

Deprecated, for removal: This API element is subject to removal in a future version.

Specified by:

mapException in class AbstractCheckedFuture<V,X extends Exception>

get

public V get()
      throws InterruptedException,
             ExecutionException

Deprecated, for removal: This API element is subject to removal in a future version.

Specified by:

get in interface Future<V>

Overrides:

get in class ForwardingFuture<V>

Throws:

InterruptedException

ExecutionException

get

public V get(long timeout,
             TimeUnit unit)
      throws InterruptedException,
             ExecutionException,
             TimeoutException

Deprecated, for removal: This API element is subject to removal in a future version.

Specified by:

get in interface Future<V>

Overrides:

get in class ForwardingFuture<V>

Throws:

InterruptedException

ExecutionException

TimeoutException