OLD | NEW |
1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2011 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 // | 4 // |
5 // The thread pool used in the POSIX implementation of WorkerPool dynamically | 5 // The thread pool used in the POSIX implementation of WorkerPool dynamically |
6 // adds threads as necessary to handle all tasks. It keeps old threads around | 6 // adds threads as necessary to handle all tasks. It keeps old threads around |
7 // for a period of time to allow them to be reused. After this waiting period, | 7 // for a period of time to allow them to be reused. After this waiting period, |
8 // the threads exit. This thread pool uses non-joinable threads, therefore | 8 // the threads exit. This thread pool uses non-joinable threads, therefore |
9 // worker threads are not joined during process shutdown. This means that | 9 // worker threads are not joined during process shutdown. This means that |
10 // potentially long running tasks (such as DNS lookup) do not block process | 10 // potentially long running tasks (such as DNS lookup) do not block process |
(...skipping 11 matching lines...) Expand all Loading... |
22 // These symbols are exported in a header purely for testing purposes. | 22 // These symbols are exported in a header purely for testing purposes. |
23 | 23 |
24 #ifndef BASE_THREADING_WORKER_POOL_POSIX_H_ | 24 #ifndef BASE_THREADING_WORKER_POOL_POSIX_H_ |
25 #define BASE_THREADING_WORKER_POOL_POSIX_H_ | 25 #define BASE_THREADING_WORKER_POOL_POSIX_H_ |
26 #pragma once | 26 #pragma once |
27 | 27 |
28 #include <queue> | 28 #include <queue> |
29 #include <string> | 29 #include <string> |
30 | 30 |
31 #include "base/basictypes.h" | 31 #include "base/basictypes.h" |
| 32 #include "base/callback.h" |
32 #include "base/memory/ref_counted.h" | 33 #include "base/memory/ref_counted.h" |
33 #include "base/memory/scoped_ptr.h" | 34 #include "base/memory/scoped_ptr.h" |
34 #include "base/synchronization/condition_variable.h" | 35 #include "base/synchronization/condition_variable.h" |
35 #include "base/synchronization/lock.h" | 36 #include "base/synchronization/lock.h" |
36 #include "base/threading/platform_thread.h" | 37 #include "base/threading/platform_thread.h" |
| 38 #include "base/tracked.h" |
37 | 39 |
38 class Task; | 40 class Task; |
39 | 41 |
40 namespace base { | 42 namespace base { |
41 | 43 |
42 class BASE_API PosixDynamicThreadPool | 44 class BASE_API PosixDynamicThreadPool |
43 : public RefCountedThreadSafe<PosixDynamicThreadPool> { | 45 : public RefCountedThreadSafe<PosixDynamicThreadPool> { |
44 public: | 46 public: |
45 class PosixDynamicThreadPoolPeer; | 47 class PosixDynamicThreadPoolPeer; |
46 | 48 |
| 49 struct PendingTask { |
| 50 PendingTask(const tracked_objects::Location& posted_from, |
| 51 const base::Closure& task); |
| 52 #if defined(TRACK_ALL_TASK_OBJECTS) |
| 53 // Counter for location where the Closure was posted from. |
| 54 tracked_objects::Births* post_births; |
| 55 |
| 56 // Time the task was posted. |
| 57 TimeTicks time_posted; |
| 58 #endif // defined(TRACK_ALL_TASK_OBJECTS) |
| 59 |
| 60 // The task to run. |
| 61 base::Closure task; |
| 62 }; |
| 63 |
47 // All worker threads will share the same |name_prefix|. They will exit after | 64 // All worker threads will share the same |name_prefix|. They will exit after |
48 // |idle_seconds_before_exit|. | 65 // |idle_seconds_before_exit|. |
49 PosixDynamicThreadPool(const std::string& name_prefix, | 66 PosixDynamicThreadPool(const std::string& name_prefix, |
50 int idle_seconds_before_exit); | 67 int idle_seconds_before_exit); |
51 ~PosixDynamicThreadPool(); | 68 ~PosixDynamicThreadPool(); |
52 | 69 |
53 // Indicates that the thread pool is going away. Stops handing out tasks to | 70 // Indicates that the thread pool is going away. Stops handing out tasks to |
54 // worker threads. Wakes up all the idle threads to let them exit. | 71 // worker threads. Wakes up all the idle threads to let them exit. |
55 void Terminate(); | 72 void Terminate(); |
56 | 73 |
57 // Adds |task| to the thread pool. PosixDynamicThreadPool assumes ownership | 74 // Adds |task| to the thread pool. PosixDynamicThreadPool assumes ownership |
58 // of |task|. | 75 // of |task|. |
59 void PostTask(Task* task); | 76 // |
| 77 // TODO(ajwong): Remove this compatibility API once the Task -> Closure |
| 78 // migration is finished. |
| 79 void PostTask(const tracked_objects::Location& from_here, Task* task); |
60 | 80 |
| 81 // Adds |task| to the thread pool. |
| 82 void PostTask(const tracked_objects::Location& from_here, |
| 83 const base::Closure& task); |
61 // Worker thread method to wait for up to |idle_seconds_before_exit| for more | 84 // Worker thread method to wait for up to |idle_seconds_before_exit| for more |
62 // work from the thread pool. Returns NULL if no work is available. | 85 // work from the thread pool. Returns NULL if no work is available. |
63 Task* WaitForTask(); | 86 PendingTask WaitForTask(); |
64 | 87 |
65 private: | 88 private: |
66 friend class PosixDynamicThreadPoolPeer; | 89 friend class PosixDynamicThreadPoolPeer; |
67 | 90 |
| 91 // Adds pending_task to the thread pool. This function will clear |
| 92 // |pending_task->task|. |
| 93 void AddTask(PendingTask* pending_task); |
| 94 |
68 const std::string name_prefix_; | 95 const std::string name_prefix_; |
69 const int idle_seconds_before_exit_; | 96 const int idle_seconds_before_exit_; |
70 | 97 |
71 Lock lock_; // Protects all the variables below. | 98 Lock lock_; // Protects all the variables below. |
72 | 99 |
73 // Signal()s worker threads to let them know more tasks are available. | 100 // Signal()s worker threads to let them know more tasks are available. |
74 // Also used for Broadcast()'ing to worker threads to let them know the pool | 101 // Also used for Broadcast()'ing to worker threads to let them know the pool |
75 // is being deleted and they can exit. | 102 // is being deleted and they can exit. |
76 ConditionVariable tasks_available_cv_; | 103 ConditionVariable pending_tasks_available_cv_; |
77 int num_idle_threads_; | 104 int num_idle_threads_; |
78 std::queue<Task*> tasks_; | 105 std::queue<PendingTask> pending_tasks_; |
79 bool terminated_; | 106 bool terminated_; |
80 // Only used for tests to ensure correct thread ordering. It will always be | 107 // Only used for tests to ensure correct thread ordering. It will always be |
81 // NULL in non-test code. | 108 // NULL in non-test code. |
82 scoped_ptr<ConditionVariable> num_idle_threads_cv_; | 109 scoped_ptr<ConditionVariable> num_idle_threads_cv_; |
83 | 110 |
84 DISALLOW_COPY_AND_ASSIGN(PosixDynamicThreadPool); | 111 DISALLOW_COPY_AND_ASSIGN(PosixDynamicThreadPool); |
85 }; | 112 }; |
86 | 113 |
87 } // namespace base | 114 } // namespace base |
88 | 115 |
89 #endif // BASE_THREADING_WORKER_POOL_POSIX_H_ | 116 #endif // BASE_THREADING_WORKER_POOL_POSIX_H_ |
OLD | NEW |