# Packages

c

A recursive result-bearing `ForkJoinTask`.

For a classic example, here is a task computing Fibonacci numbers:

``` ```
final int n;
Fibonacci(int n) { this.n = n; ```
Integer compute() {
if (n <= 1)
return n;
Fibonacci f1 = new Fibonacci(n - 1);
f1.fork();
Fibonacci f2 = new Fibonacci(n - 2);
return f2.compute() + f1.join();
}
}}
```

However, besides being a dumb way to compute Fibonacci functions (there is a simple fast linear algorithm that you'd use in practice), this is likely to perform poorly because the smallest subtasks are too small to be worthwhile splitting up. Instead, as is the case for nearly all fork/join applications, you'd pick some minimum granularity size (for example 10 here) for which you always sequentially solve rather than subdividing.

Source
Since

1.7

Linear Supertypes
Ordering
1. Alphabetic
2. By Inheritance
Inherited
3. Serializable
4. Future
5. AnyRef
6. Any
Implicitly
2. by StringFormat
3. by Ensuring
4. by ArrowAssoc
1. Hide All
2. Show All
Visibility
1. Public
2. All

### Abstract Value Members

1. abstract def compute(): V

The main computation performed by this task.

The main computation performed by this task.

Attributes
protected[akka.dispatch.forkjoin]

### Concrete Value Members

1. final def !=(arg0: Any)
Definition Classes
AnyRef → Any
2. final def ##(): Int
Definition Classes
AnyRef → Any
3. def +(other: String): String
Implicit
Definition Classes
4. def ->[B](y: B): (RecursiveTask[V], B)
Implicit
This member is added by an implicit conversion from RecursiveTask[V] to ArrowAssoc[RecursiveTask[V]] performed by method ArrowAssoc in scala.Predef.
Definition Classes
ArrowAssoc
Annotations
@inline()
5. final def ==(arg0: Any)
Definition Classes
AnyRef → Any
6. final def asInstanceOf[T0]: T0
Definition Classes
Any
7. def cancel(mayInterruptIfRunning: Boolean)

Attempts to cancel execution of this task.

Attempts to cancel execution of this task. This attempt will fail if the task has already completed or could not be cancelled for some other reason. If successful, and this task has not started when `cancel` is called, execution of this task is suppressed. After this method returns successfully, unless there is an intervening call to `#reinitialize`, subsequent calls to `#isCancelled`, `#isDone`, and `cancel` will return `true` and calls to `#join` and related methods will result in `CancellationException`.

This method may be overridden in subclasses, but if so, must still ensure that these properties hold. In particular, the `cancel` method itself must not throw exceptions.

This method is designed to be invoked by other tasks. To terminate the current task, you can just return or throw an unchecked exception from its computation method, or invoke `#completeExceptionally`.

mayInterruptIfRunning

this value has no effect in the default implementation because interrupts are not used to control cancellation.

returns

`true` if this task is now cancelled

Definition Classes
8. def clone()
Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@native() @HotSpotIntrinsicCandidate() @throws( ... )
9. final def compareAndSetForkJoinTaskTag(e: Short, tag: Short)

Atomically conditionally sets the tag value for this task.

Atomically conditionally sets the tag value for this task. Among other applications, tags can be used as visit markers in tasks operating on graphs, as in methods that check: ``` if (task.compareAndSetForkJoinTaskTag((short)0, (short)1))``` before processing, otherwise exiting because the node has already been visited.

e

the expected tag value

tag

the new tag value

returns

true if successful; i.e., the current value was equal to e and is now tag.

Definition Classes
Since

1.8

10. def complete(value: V): Unit

Completes this task, and if not already aborted or cancelled, returning the given value as the result of subsequent invocations of `join` and related operations.

Completes this task, and if not already aborted or cancelled, returning the given value as the result of subsequent invocations of `join` and related operations. This method may be used to provide results for asynchronous tasks, or to provide alternative handling for tasks that would not otherwise complete normally. Its use in other situations is discouraged. This method is overridable, but overridden versions must invoke `super` implementation to maintain guarantees.

value

the result value for this task

Definition Classes
11. def completeExceptionally(ex: Throwable): Unit

Completes this task abnormally, and if not already aborted or cancelled, causes it to throw the given exception upon `join` and related operations.

Completes this task abnormally, and if not already aborted or cancelled, causes it to throw the given exception upon `join` and related operations. This method may be used to induce exceptions in asynchronous tasks, or to force completion of tasks that would not otherwise complete. Its use in other situations is discouraged. This method is overridable, but overridden versions must invoke `super` implementation to maintain guarantees.

ex

the exception to throw. If this exception is not a `RuntimeException` or `Error`, the actual exception thrown will be a `RuntimeException` with cause `ex`.

Definition Classes
Implicit
This member is added by an implicit conversion from RecursiveTask[V] to Ensuring[RecursiveTask[V]] performed by method Ensuring in scala.Predef.
Definition Classes
Ensuring
Implicit
This member is added by an implicit conversion from RecursiveTask[V] to Ensuring[RecursiveTask[V]] performed by method Ensuring in scala.Predef.
Definition Classes
Ensuring
14. def ensuring(cond: Boolean, msg: ⇒ Any): RecursiveTask[V]
Implicit
This member is added by an implicit conversion from RecursiveTask[V] to Ensuring[RecursiveTask[V]] performed by method Ensuring in scala.Predef.
Definition Classes
Ensuring
Implicit
This member is added by an implicit conversion from RecursiveTask[V] to Ensuring[RecursiveTask[V]] performed by method Ensuring in scala.Predef.
Definition Classes
Ensuring
16. final def eq(arg0: AnyRef)
Definition Classes
AnyRef
17. def equals(arg0: Any)
Definition Classes
AnyRef → Any
18. final def exec()

returns

`true` if this task is known to have completed normally

Attributes
protected[akka.dispatch.forkjoin]
Definition Classes

Arranges to asynchronously execute this task in the pool the current task is running in, if applicable, or using the `ForkJoinPool#commonPool()` if not `#inForkJoinPool`.

Arranges to asynchronously execute this task in the pool the current task is running in, if applicable, or using the `ForkJoinPool#commonPool()` if not `#inForkJoinPool`. While it is not necessarily enforced, it is a usage error to fork a task more than once unless it has completed and been reinitialized. Subsequent modifications to the state of this task or any data it operates on are not necessarily consistently observable by any thread other than the one executing it unless preceded by a call to `#join` or related methods, or a call to `#isDone` returning ``` true```.

returns

`this`, to simplify usage

Definition Classes
20. def formatted(fmtstr: String): String
Implicit
This member is added by an implicit conversion from RecursiveTask[V] to StringFormat[RecursiveTask[V]] performed by method StringFormat in scala.Predef.
Definition Classes
StringFormat
Annotations
@inline()
21. final def get(timeout: Long, unit: TimeUnit): V

Waits if necessary for at most the given time for the computation to complete, and then retrieves its result, if available.

Waits if necessary for at most the given time for the computation to complete, and then retrieves its result, if available.

timeout

the maximum time to wait

unit

the time unit of the timeout argument

returns

the computed result

Definition Classes
Exceptions thrown

`CancellationException` if the computation was cancelled

`ExecutionException` if the computation threw an exception

`InterruptedException` if the current thread is not a member of a ForkJoinPool and was interrupted while waiting

`TimeoutException` if the wait timed out

22. final def get(): V

Waits if necessary for the computation to complete, and then retrieves its result.

Waits if necessary for the computation to complete, and then retrieves its result.

returns

the computed result

Definition Classes
Exceptions thrown

`CancellationException` if the computation was cancelled

`ExecutionException` if the computation threw an exception

`InterruptedException` if the current thread is not a member of a ForkJoinPool and was interrupted while waiting

23. final def getClass(): Class[_]
Definition Classes
AnyRef → Any
Annotations
@native() @HotSpotIntrinsicCandidate()
24. final def getException()

Returns the exception thrown by the base computation, or a `CancellationException` if cancelled, or `null` if none or if the method has not yet completed.

Returns the exception thrown by the base computation, or a `CancellationException` if cancelled, or `null` if none or if the method has not yet completed.

returns

the exception, or `null` if none

Definition Classes

Returns the tag for this task.

Returns the tag for this task.

returns

Definition Classes
Since

1.8

26. final def getRawResult(): V

Returns the result that would be returned by `#join`, even if this task completed abnormally, or `null` if this task is not known to have been completed.

Returns the result that would be returned by `#join`, even if this task completed abnormally, or `null` if this task is not known to have been completed. This method is designed to aid debugging, as well as to support extensions. Its use in any other context is discouraged.

returns

the result, or `null` if not completed

Definition Classes
27. def hashCode(): Int
Definition Classes
AnyRef → Any
Annotations
@native() @HotSpotIntrinsicCandidate()
28. final def invoke(): V

Commences performing this task, awaits its completion if necessary, and returns its result, or throws an (unchecked) `RuntimeException` or `Error` if the underlying computation did so.

Commences performing this task, awaits its completion if necessary, and returns its result, or throws an (unchecked) `RuntimeException` or `Error` if the underlying computation did so.

returns

the computed result

Definition Classes
29. final def isCancelled()
Definition Classes
30. final def isCompletedAbnormally()

Returns `true` if this task threw an exception or was cancelled.

Returns `true` if this task threw an exception or was cancelled.

returns

`true` if this task threw an exception or was cancelled

Definition Classes
31. final def isCompletedNormally()

Returns `true` if this task completed without throwing an exception and was not cancelled.

Returns `true` if this task completed without throwing an exception and was not cancelled.

returns

`true` if this task completed without throwing an exception and was not cancelled

Definition Classes
32. final def isDone()
Definition Classes
33. final def isInstanceOf[T0]
Definition Classes
Any
34. final def join(): V

Returns the result of the computation when it ```is done```.

Returns the result of the computation when it ```is done```. This method differs from `#get()` in that abnormal completion results in `RuntimeException` or `Error`, not `ExecutionException`, and that interrupts of the calling thread do not cause the method to abruptly return by throwing ``` InterruptedException```.

returns

the computed result

Definition Classes
35. final def ne(arg0: AnyRef)
Definition Classes
AnyRef
36. final def notify(): Unit
Definition Classes
AnyRef
Annotations
@native() @HotSpotIntrinsicCandidate()
37. final def notifyAll(): Unit
Definition Classes
AnyRef
Annotations
@native() @HotSpotIntrinsicCandidate()
38. final def quietlyComplete(): Unit

Completes this task normally without setting a value.

Completes this task normally without setting a value. The most recent value established by `#setRawResult` (or ``` null``` by default) will be returned as the result of subsequent invocations of `join` and related operations.

Definition Classes
Since

1.8

39. final def quietlyInvoke(): Unit

Commences performing this task and awaits its completion if necessary, without returning its result or throwing its exception.

Commences performing this task and awaits its completion if necessary, without returning its result or throwing its exception.

Definition Classes
40. final def quietlyJoin(): Unit

Joins this task, without returning its result or throwing its exception.

Joins this task, without returning its result or throwing its exception. This method may be useful when processing collections of tasks when some have been cancelled or otherwise known to have aborted.

Definition Classes
41. def reinitialize(): Unit

Resets the internal bookkeeping state of this task, allowing a subsequent `fork`.

Resets the internal bookkeeping state of this task, allowing a subsequent `fork`. This method allows repeated reuse of this task, but only if reuse occurs when this task has either never been forked, or has been forked, then completed and all outstanding joins of this task have also completed. Effects under any other usage conditions are not guaranteed. This method may be useful when executing pre-constructed trees of subtasks in loops.

Upon completion of this method, `isDone()` reports `false`, and `getException()` reports ``` null```. However, the value returned by `getRawResult` is unaffected. To clear this value, you can invoke ``` setRawResult(null)```.

Definition Classes

Atomically sets the tag value for this task.

Atomically sets the tag value for this task.

tag

the tag value

returns

the previous value of the tag

Definition Classes
Since

1.8

43. final def setRawResult(value: V): Unit

Forces the given value to be returned as a result.

Forces the given value to be returned as a result. This method is designed to support extensions, and should not in general be called otherwise.

value

the value

Attributes
protected[akka.dispatch.forkjoin]
Definition Classes
44. final def synchronized[T0](arg0: ⇒ T0): T0
Definition Classes
AnyRef
45. def toString()
Definition Classes
AnyRef → Any
46. def tryUnfork()

Tries to unschedule this task for execution.

Tries to unschedule this task for execution. This method will typically (but is not guaranteed to) succeed if this task is the most recently forked task by the current thread, and has not commenced executing in another thread. This method may be useful when arranging alternative local processing of tasks that could have been, but were not, stolen.

returns

`true` if unforked

Definition Classes
47. final def wait(arg0: Long, arg1: Int): Unit
Definition Classes
AnyRef
Annotations
@throws( ... )
48. final def wait(arg0: Long): Unit
Definition Classes
AnyRef
Annotations
@native() @throws( ... )
49. final def wait(): Unit
Definition Classes
AnyRef
Annotations
@throws( ... )
50. def [B](y: B): (RecursiveTask[V], B)
Implicit
This member is added by an implicit conversion from RecursiveTask[V] to ArrowAssoc[RecursiveTask[V]] performed by method ArrowAssoc in scala.Predef.
Definition Classes
ArrowAssoc

### Deprecated Value Members

1. def finalize(): Unit
Attributes
protected[java.lang]
Definition Classes
AnyRef
Annotations
@Deprecated @deprecated @throws( classOf[java.lang.Throwable] )
Deprecated