com.facebook.buck.util.concurrent

Class WorkThreadTrackingTask<T>

java.lang.Object

java.util.concurrent.ForkJoinTask<T>

com.facebook.buck.util.concurrent.WorkThreadTrackingTask<T>

All Implemented Interfaces:

Serializable, Future<T>

public class WorkThreadTrackingTask<T>
extends ForkJoinTask<T>

A ForkJoinTask which keeps track of the thread running its computation.

This task performs compute() in a thread safe manner, guaranteeing only one computation will happen even when called between multiple threads.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected Thread	workThread

Constructor Summary

Constructors

Constructor and Description
WorkThreadTrackingTask(java.util.function.Supplier<T> work)

Method Summary

Modifier and Type	Method and Description
void	complete(T value)
static <T> WorkThreadTrackingTask<T>	completed(T value)
protected T	compute()
protected boolean	exec()
T	externalCompute() computes and completes this task, which can be called outside of the forkjoin framework, or by threads that did not originally fork the task.
T	getRawResult()
boolean	isBeingWorkedOnByCurrentThread()
protected void	setRawResult(T value)

Methods inherited from class java.util.concurrent.ForkJoinTask

adapt, adapt, adapt, cancel, compareAndSetForkJoinTaskTag, completeExceptionally, fork, get, get, getException, getForkJoinTaskTag, getPool, getQueuedTaskCount, getSurplusQueuedTaskCount, helpQuiesce, inForkJoinPool, invoke, invokeAll, invokeAll, invokeAll, isCancelled, isCompletedAbnormally, isCompletedNormally, isDone, join, peekNextLocalTask, pollNextLocalTask, pollTask, quietlyComplete, quietlyInvoke, quietlyJoin, reinitialize, setForkJoinTaskTag, tryUnfork

Methods inherited from class java.lang.Object

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

Field Detail

workThread

@Nullable
protected volatile Thread workThread

Constructor Detail

WorkThreadTrackingTask

public WorkThreadTrackingTask(java.util.function.Supplier<T> work)

Method Detail

externalCompute

@Nullable
public final T externalCompute()

computes and completes this task, which can be called outside of the forkjoin framework, or by threads that did not originally fork the task.

Exceptions are propagated via UncheckedExecutionExceptions

Returns:

the result of the task

compute

@Nullable
protected final T compute()

isBeingWorkedOnByCurrentThread

public final boolean isBeingWorkedOnByCurrentThread()

complete

public void complete(T value)

Overrides:

complete in class ForkJoinTask<T>

getRawResult

@Nullable
public T getRawResult()

Specified by:

getRawResult in class ForkJoinTask<T>

setRawResult

protected void setRawResult(T value)

Specified by:

setRawResult in class ForkJoinTask<T>

exec

protected boolean exec()

Specified by:

exec in class ForkJoinTask<T>

completed

public static <T> WorkThreadTrackingTask<T> completed(T value)

Returns:

an already completed task