| OLD | NEW |
| 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2012 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 #ifndef BASE_TASK_RUNNER_H_ | 5 #ifndef BASE_TASK_RUNNER_H_ |
| 6 #define BASE_TASK_RUNNER_H_ | 6 #define BASE_TASK_RUNNER_H_ |
| 7 | 7 |
| 8 #include <stddef.h> | 8 #include <stddef.h> |
| 9 | 9 |
| 10 #include "base/base_export.h" | 10 #include "base/base_export.h" |
| (...skipping 44 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 55 // method Run() that runs each runnable task in random order. | 55 // method Run() that runs each runnable task in random order. |
| 56 class BASE_EXPORT TaskRunner | 56 class BASE_EXPORT TaskRunner |
| 57 : public RefCountedThreadSafe<TaskRunner, TaskRunnerTraits> { | 57 : public RefCountedThreadSafe<TaskRunner, TaskRunnerTraits> { |
| 58 public: | 58 public: |
| 59 // Posts the given task to be run. Returns true if the task may be | 59 // Posts the given task to be run. Returns true if the task may be |
| 60 // run at some point in the future, and false if the task definitely | 60 // run at some point in the future, and false if the task definitely |
| 61 // will not be run. | 61 // will not be run. |
| 62 // | 62 // |
| 63 // Equivalent to PostDelayedTask(from_here, task, 0). | 63 // Equivalent to PostDelayedTask(from_here, task, 0). |
| 64 bool PostTask(const tracked_objects::Location& from_here, | 64 bool PostTask(const tracked_objects::Location& from_here, |
| 65 const Closure& task); | 65 OnceClosure task); |
| 66 | 66 |
| 67 // Like PostTask, but tries to run the posted task only after | 67 // Like PostTask, but tries to run the posted task only after |
| 68 // |delay_ms| has passed. | 68 // |delay_ms| has passed. |
| 69 // | 69 // |
| 70 // It is valid for an implementation to ignore |delay_ms|; that is, | 70 // It is valid for an implementation to ignore |delay_ms|; that is, |
| 71 // to have PostDelayedTask behave the same as PostTask. | 71 // to have PostDelayedTask behave the same as PostTask. |
| 72 virtual bool PostDelayedTask(const tracked_objects::Location& from_here, | 72 virtual bool PostDelayedTask(const tracked_objects::Location& from_here, |
| 73 const Closure& task, | 73 OnceClosure task, |
| 74 base::TimeDelta delay) = 0; | 74 base::TimeDelta delay) = 0; |
| 75 | 75 |
| 76 // Returns true if the current thread is a thread on which a task | 76 // Returns true if the current thread is a thread on which a task |
| 77 // may be run, and false if no task will be run on the current | 77 // may be run, and false if no task will be run on the current |
| 78 // thread. | 78 // thread. |
| 79 // | 79 // |
| 80 // It is valid for an implementation to always return true, or in | 80 // It is valid for an implementation to always return true, or in |
| 81 // general to use 'true' as a default value. | 81 // general to use 'true' as a default value. |
| 82 virtual bool RunsTasksOnCurrentThread() const = 0; | 82 virtual bool RunsTasksOnCurrentThread() const = 0; |
| 83 | 83 |
| (...skipping 32 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
| 116 // | 116 // |
| 117 // | 117 // |
| 118 // Things to notice: | 118 // Things to notice: |
| 119 // * Results of |task| are shared with |reply| by binding a shared argument | 119 // * Results of |task| are shared with |reply| by binding a shared argument |
| 120 // (a DataBuffer instance). | 120 // (a DataBuffer instance). |
| 121 // * The DataLoader object has no special thread safety. | 121 // * The DataLoader object has no special thread safety. |
| 122 // * The DataLoader object can be deleted while |task| is still running, | 122 // * The DataLoader object can be deleted while |task| is still running, |
| 123 // and the reply will cancel itself safely because it is bound to a | 123 // and the reply will cancel itself safely because it is bound to a |
| 124 // WeakPtr<>. | 124 // WeakPtr<>. |
| 125 bool PostTaskAndReply(const tracked_objects::Location& from_here, | 125 bool PostTaskAndReply(const tracked_objects::Location& from_here, |
| 126 const Closure& task, | 126 OnceClosure task, |
| 127 const Closure& reply); | 127 OnceClosure reply); |
| 128 | 128 |
| 129 protected: | 129 protected: |
| 130 friend struct TaskRunnerTraits; | 130 friend struct TaskRunnerTraits; |
| 131 | 131 |
| 132 // Only the Windows debug build seems to need this: see | 132 // Only the Windows debug build seems to need this: see |
| 133 // http://crbug.com/112250. | 133 // http://crbug.com/112250. |
| 134 friend class RefCountedThreadSafe<TaskRunner, TaskRunnerTraits>; | 134 friend class RefCountedThreadSafe<TaskRunner, TaskRunnerTraits>; |
| 135 | 135 |
| 136 TaskRunner(); | 136 TaskRunner(); |
| 137 virtual ~TaskRunner(); | 137 virtual ~TaskRunner(); |
| 138 | 138 |
| 139 // Called when this object should be destroyed. By default simply | 139 // Called when this object should be destroyed. By default simply |
| 140 // deletes |this|, but can be overridden to do something else, like | 140 // deletes |this|, but can be overridden to do something else, like |
| 141 // delete on a certain thread. | 141 // delete on a certain thread. |
| 142 virtual void OnDestruct() const; | 142 virtual void OnDestruct() const; |
| 143 }; | 143 }; |
| 144 | 144 |
| 145 struct BASE_EXPORT TaskRunnerTraits { | 145 struct BASE_EXPORT TaskRunnerTraits { |
| 146 static void Destruct(const TaskRunner* task_runner); | 146 static void Destruct(const TaskRunner* task_runner); |
| 147 }; | 147 }; |
| 148 | 148 |
| 149 } // namespace base | 149 } // namespace base |
| 150 | 150 |
| 151 #endif // BASE_TASK_RUNNER_H_ | 151 #endif // BASE_TASK_RUNNER_H_ |
| OLD | NEW |