summaryrefslogtreecommitdiff
path: root/src/library/scala/collection/parallel/TaskSupport.scala
blob: 59b75f523fe6c71001ce8791a3b091987477d20d (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
/*                     __                                               *\
**     ________ ___   / /  ___     Scala API                            **
**    / __/ __// _ | / /  / _ |    (c) 2003-2011, LAMP/EPFL             **
**  __\ \/ /__/ __ |/ /__/ __ |    http://scala-lang.org/               **
** /____/\___/_/ |_/____/_/ | |                                         **
**                          |/                                          **
\*                                                                      */


package scala.collection.parallel



import java.util.concurrent.ThreadPoolExecutor
import scala.concurrent.forkjoin.ForkJoinPool
import scala.concurrent.ExecutionContext



/** A trait implementing the scheduling of
 *  a parallel collection operation.
 *  
 *  Task support objects handle how a task is split and
 *  distributed across processors. A task support object can be
 *  changed in a parallel collection after it has been created,
 *  but only during a quiescent period, i.e. while there are no
 *  concurrent invocations to parallel collection methods.
 */
trait TaskSupport extends Tasks


/** A task support that uses a fork join pool to schedule tasks */
class ForkJoinTaskSupport(val environment: ForkJoinPool = ForkJoinTasks.defaultForkJoinPool)
extends TaskSupport with AdaptiveWorkStealingForkJoinTasks


/** A task support that uses a thread pool executor to schedule tasks */
class ThreadPoolTaskSupport(val environment: ThreadPoolExecutor = ThreadPoolTasks.defaultThreadPool)
extends TaskSupport with AdaptiveWorkStealingThreadPoolTasks


/** A task support that uses an execution context to schedule tasks.
 *  
 *  It can be used with the default execution context implementation in the `scala.concurrent` package.
 *  It internally forwards the call to either a forkjoin based task support or a thread pool executor one,
 *  depending on what the execution context uses.
 *  
 *  By default, parallel collections are parametrized with this task support object, so parallel collections
 *  share the same execution context backend as the rest of the `scala.concurrent` package.
 */
class ExecutionContextTaskSupport(val environment: ExecutionContext = scala.concurrent.executionContext)
extends TaskSupport with ExecutionContextTasks