Chromium Code Reviews| 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_THREADING_THREAD_H_ | 5 #ifndef BASE_THREADING_THREAD_H_ |
| 6 #define BASE_THREADING_THREAD_H_ | 6 #define BASE_THREADING_THREAD_H_ |
| 7 | 7 |
| 8 #include <string> | 8 #include <string> |
| 9 | 9 |
| 10 #include "base/base_export.h" | 10 #include "base/base_export.h" |
| 11 #include "base/message_loop/message_loop.h" | 11 #include "base/message_loop/message_loop.h" |
| 12 #include "base/message_loop/message_loop_proxy.h" | 12 #include "base/message_loop/message_loop_proxy.h" |
| 13 #include "base/threading/platform_thread.h" | 13 #include "base/threading/platform_thread.h" |
| 14 | 14 |
| 15 namespace base { | 15 namespace base { |
| 16 | 16 |
| 17 class MessagePump; | |
| 18 | |
| 17 // A simple thread abstraction that establishes a MessageLoop on a new thread. | 19 // A simple thread abstraction that establishes a MessageLoop on a new thread. |
| 18 // The consumer uses the MessageLoop of the thread to cause code to execute on | 20 // The consumer uses the MessageLoop of the thread to cause code to execute on |
| 19 // the thread. When this object is destroyed the thread is terminated. All | 21 // the thread. When this object is destroyed the thread is terminated. All |
| 20 // pending tasks queued on the thread's message loop will run to completion | 22 // pending tasks queued on the thread's message loop will run to completion |
| 21 // before the thread is terminated. | 23 // before the thread is terminated. |
| 22 // | 24 // |
| 23 // WARNING! SUBCLASSES MUST CALL Stop() IN THEIR DESTRUCTORS! See ~Thread(). | 25 // WARNING! SUBCLASSES MUST CALL Stop() IN THEIR DESTRUCTORS! See ~Thread(). |
| 24 // | 26 // |
| 25 // After the thread is stopped, the destruction sequence is: | 27 // After the thread is stopped, the destruction sequence is: |
| 26 // | 28 // |
| 27 // (1) Thread::CleanUp() | 29 // (1) Thread::CleanUp() |
| 28 // (2) MessageLoop::~MessageLoop | 30 // (2) MessageLoop::~MessageLoop |
| 29 // (3.b) MessageLoop::DestructionObserver::WillDestroyCurrentMessageLoop | 31 // (3.b) MessageLoop::DestructionObserver::WillDestroyCurrentMessageLoop |
| 30 class BASE_EXPORT Thread : PlatformThread::Delegate { | 32 class BASE_EXPORT Thread : PlatformThread::Delegate { |
| 31 public: | 33 public: |
| 32 struct Options { | 34 struct Options { |
| 33 Options() : message_loop_type(MessageLoop::TYPE_DEFAULT), stack_size(0) {} | 35 Options() |
| 36 : message_loop_type(MessageLoop::TYPE_DEFAULT), | |
| 37 message_pump(NULL), | |
| 38 stack_size(0) { | |
| 39 } | |
| 34 Options(MessageLoop::Type type, size_t size) | 40 Options(MessageLoop::Type type, size_t size) |
| 35 : message_loop_type(type), stack_size(size) {} | 41 : message_loop_type(type), |
| 42 message_pump(NULL), | |
| 43 stack_size(size) {} | |
| 36 | 44 |
| 37 // Specifies the type of message loop that will be allocated on the thread. | 45 // Specifies the type of message loop that will be allocated on the thread. |
| 38 MessageLoop::Type message_loop_type; | 46 MessageLoop::Type message_loop_type; |
| 39 | 47 |
| 48 // If non-null this is used as the MessagePump for the Thread's MessageLoop. | |
| 49 // MessageLoop takes ownership of this. | |
| 50 MessagePump* message_pump; | |
|
sky
2013/11/07 01:06:38
This can't be a scoped_ptr because of how we pass
| |
| 51 | |
| 40 // Specifies the maximum stack size that the thread is allowed to use. | 52 // Specifies the maximum stack size that the thread is allowed to use. |
| 41 // This does not necessarily correspond to the thread's initial stack size. | 53 // This does not necessarily correspond to the thread's initial stack size. |
| 42 // A value of 0 indicates that the default maximum should be used. | 54 // A value of 0 indicates that the default maximum should be used. |
| 43 size_t stack_size; | 55 size_t stack_size; |
| 44 }; | 56 }; |
| 45 | 57 |
| 46 // Constructor. | 58 // Constructor. |
| 47 // name is a display string to identify the thread. | 59 // name is a display string to identify the thread. |
| 48 explicit Thread(const char* name); | 60 explicit Thread(const char* name); |
| 49 | 61 |
| (...skipping 157 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
| 207 std::string name_; | 219 std::string name_; |
| 208 | 220 |
| 209 friend void ThreadQuitHelper(); | 221 friend void ThreadQuitHelper(); |
| 210 | 222 |
| 211 DISALLOW_COPY_AND_ASSIGN(Thread); | 223 DISALLOW_COPY_AND_ASSIGN(Thread); |
| 212 }; | 224 }; |
| 213 | 225 |
| 214 } // namespace base | 226 } // namespace base |
| 215 | 227 |
| 216 #endif // BASE_THREADING_THREAD_H_ | 228 #endif // BASE_THREADING_THREAD_H_ |
| OLD | NEW |