com.yahoo.search.searchchain

Class FutureResult

java.lang.Object

java.util.concurrent.FutureTask<Result>

com.yahoo.search.searchchain.FutureResult

All Implemented Interfaces:

Runnable, Future<Result>, RunnableFuture<Result>

public class FutureResult
extends FutureTask<Result>

Extends a FutureTask<Result>, with some added error handling

Author:

bratseth

Field Summary

Fields

Modifier and Type	Field and Description
private Execution	execution Only used for generating messages
private static Logger	log
private Query	query

Constructor Summary

Constructors

Constructor and Description
FutureResult(Callable<Result> callable, Execution execution, Query query)

Method Summary

Modifier and Type	Method and Description
private ErrorMessage	createExecutionError(Exception e)
private ErrorMessage	createInterruptedError(Exception e)
ErrorMessage	createTimeoutError()
Result	get() Returns a Result containing the hits returned from this source, or an error otherwise.
Result	get(long timeout, TimeUnit timeunit) Returns a Result containing the hits returned from this source, or an error otherwise.
Optional<Result>	getIfAvailable(long timeout, TimeUnit timeunit) Same as get(timeout, timeunit) but returns Optional.empty instead of a result with error if the result is not available in time
Query	getQuery() Returns the query used in this execution, never null

Methods inherited from class java.util.concurrent.FutureTask

cancel, done, isCancelled, isDone, run, runAndReset, set, setException

Methods inherited from class java.lang.Object

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

Field Detail

query

private final Query query

execution

private final Execution execution

Only used for generating messages

log

private static final Logger log

Constructor Detail

FutureResult

public FutureResult(Callable<Result> callable,
                    Execution execution,
                    Query query)

Method Detail

get

public Result get()

Returns a Result containing the hits returned from this source, or an error otherwise. This will block for however long it takes to get the result: Using this is a bad idea.

Specified by:

get in interface Future<Result>

Overrides:

get in class FutureTask<Result>

get

public Result get(long timeout,
                  TimeUnit timeunit)

Returns a Result containing the hits returned from this source, or an error otherwise. This blocks for at most the given timeout and returns a Result containing a timeout error if the result is not available within this time.

Specified by:

get in interface Future<Result>

Overrides:

get in class FutureTask<Result>

getIfAvailable

public Optional<Result> getIfAvailable(long timeout,
                                       TimeUnit timeunit)

Same as get(timeout, timeunit) but returns Optional.empty instead of a result with error if the result is not available in time

getQuery

public Query getQuery()

Returns the query used in this execution, never null

createInterruptedError

private ErrorMessage createInterruptedError(Exception e)

createExecutionError

private ErrorMessage createExecutionError(Exception e)

createTimeoutError

public ErrorMessage createTimeoutError()