blob: f60bf69d8302a2c8122cbf26ef5948f340656178 [file] [log] [blame]
jhawkins@chromium.orge194f3d2012-01-05 11:18:18 +09001// Copyright (c) 2012 The Chromium Authors. All rights reserved.
license.botf003cfe2008-08-24 09:55:55 +09002// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
initial.commit3f4a7322008-07-27 06:49:38 +09004
darin@google.com6ddeb842008-08-15 16:31:20 +09005#include "base/message_loop.h"
6
darin@google.com981f3552008-08-16 12:09:05 +09007#include <algorithm>
8
ajwong@chromium.org94d2a582011-04-21 01:02:23 +09009#include "base/bind.h"
mmentovai@google.comfa5f9932008-08-22 07:26:06 +090010#include "base/compiler_specific.h"
apatrick@chromium.org87164042011-05-20 07:28:25 +090011#include "base/debug/alias.h"
jbates@chromium.orgb84db522011-10-04 02:51:25 +090012#include "base/debug/trace_event.h"
deanm@chromium.orgcd1ce302008-09-10 19:54:06 +090013#include "base/lazy_instance.h"
initial.commit3f4a7322008-07-27 06:49:38 +090014#include "base/logging.h"
thestig@chromium.orgefd4aaf2011-06-15 13:14:23 +090015#include "base/memory/scoped_ptr.h"
nduca@chromium.orgba048612011-08-16 05:33:46 +090016#include "base/message_loop_proxy_impl.h"
darin@google.com12d40bb2008-08-20 03:36:23 +090017#include "base/message_pump_default.h"
brettw@chromium.org275c2ec2010-10-14 13:38:38 +090018#include "base/metrics/histogram.h"
timurrrr@chromium.org490200b2011-01-05 04:06:51 +090019#include "base/third_party/dynamic_annotations/dynamic_annotations.h"
brettw@chromium.org63965582010-12-31 07:18:56 +090020#include "base/threading/thread_local.h"
mbelshe@chromium.orgbee85b32011-05-16 04:20:49 +090021#include "base/time.h"
ajwong@chromium.org94d2a582011-04-21 01:02:23 +090022#include "base/tracked_objects.h"
initial.commit3f4a7322008-07-27 06:49:38 +090023
mark@chromium.org059d0492008-09-24 06:08:28 +090024#if defined(OS_MACOSX)
25#include "base/message_pump_mac.h"
26#endif
dkegel@google.com9e044ae2008-09-19 03:46:26 +090027#if defined(OS_POSIX)
28#include "base/message_pump_libevent.h"
29#endif
michaelbai@google.com686190b2011-08-03 01:11:16 +090030#if defined(OS_ANDROID)
31#include "base/message_pump_android.h"
32#endif
oshima@chromium.org59a08552012-04-05 09:21:22 +090033
34#if defined(TOOLKIT_GTK)
ajwong@chromium.org94d2a582011-04-21 01:02:23 +090035#include <gdk/gdk.h>
36#include <gdk/gdkx.h>
oshima@chromium.org59a08552012-04-05 09:21:22 +090037#endif
dkegel@google.com9e044ae2008-09-19 03:46:26 +090038
jhawkins@chromium.org2af12f22011-11-16 08:36:30 +090039using base::PendingTask;
dsh@google.com0f8dd262008-10-28 05:43:33 +090040using base::TimeDelta;
jar@chromium.org9b0fb062010-11-07 07:23:29 +090041using base::TimeTicks;
dsh@google.com0f8dd262008-10-28 05:43:33 +090042
erg@chromium.orga7528522010-07-16 02:23:23 +090043namespace {
44
deanm@chromium.orgcd1ce302008-09-10 19:54:06 +090045// A lazily created thread local storage for quick access to a thread's message
46// loop, if one exists. This should be safe and free of static constructors.
joth@chromium.orgb24883c2011-11-15 22:31:49 +090047base::LazyInstance<base::ThreadLocalPointer<MessageLoop> > lazy_tls_ptr =
48 LAZY_INSTANCE_INITIALIZER;
initial.commit3f4a7322008-07-27 06:49:38 +090049
initial.commit3f4a7322008-07-27 06:49:38 +090050// Logical events for Histogram profiling. Run with -message-loop-histogrammer
51// to get an accounting of messages and actions taken on each thread.
erg@chromium.orga7528522010-07-16 02:23:23 +090052const int kTaskRunEvent = 0x1;
53const int kTimerEvent = 0x2;
initial.commit3f4a7322008-07-27 06:49:38 +090054
55// Provide range of message IDs for use in histogramming and debug display.
erg@chromium.orga7528522010-07-16 02:23:23 +090056const int kLeastNonZeroMessageId = 1;
57const int kMaxMessageId = 1099;
58const int kNumberOfDistinctMessagesDisplayed = 1100;
59
60// Provide a macro that takes an expression (such as a constant, or macro
61// constant) and creates a pair to initalize an array of pairs. In this case,
62// our pair consists of the expressions value, and the "stringized" version
63// of the expression (i.e., the exrpression put in quotes). For example, if
64// we have:
65// #define FOO 2
66// #define BAR 5
67// then the following:
68// VALUE_TO_NUMBER_AND_NAME(FOO + BAR)
69// will expand to:
70// {7, "FOO + BAR"}
71// We use the resulting array as an argument to our histogram, which reads the
72// number as a bucket identifier, and proceeds to use the corresponding name
73// in the pair (i.e., the quoted string) when printing out a histogram.
74#define VALUE_TO_NUMBER_AND_NAME(name) {name, #name},
75
brettw@chromium.org275c2ec2010-10-14 13:38:38 +090076const base::LinearHistogram::DescriptionPair event_descriptions_[] = {
erg@chromium.orga7528522010-07-16 02:23:23 +090077 // Provide some pretty print capability in our histogram for our internal
78 // messages.
79
80 // A few events we handle (kindred to messages), and used to profile actions.
81 VALUE_TO_NUMBER_AND_NAME(kTaskRunEvent)
82 VALUE_TO_NUMBER_AND_NAME(kTimerEvent)
83
84 {-1, NULL} // The list must be null terminated, per API to histogram.
85};
86
87bool enable_histogrammer_ = false;
88
michaelbai@google.com686190b2011-08-03 01:11:16 +090089MessageLoop::MessagePumpFactory* message_pump_for_ui_factory_ = NULL;
90
erg@chromium.orga7528522010-07-16 02:23:23 +090091} // namespace
initial.commit3f4a7322008-07-27 06:49:38 +090092
93//------------------------------------------------------------------------------
94
darin@google.com981f3552008-08-16 12:09:05 +090095#if defined(OS_WIN)
initial.commit3f4a7322008-07-27 06:49:38 +090096
initial.commit3f4a7322008-07-27 06:49:38 +090097// Upon a SEH exception in this thread, it restores the original unhandled
98// exception filter.
99static int SEHFilter(LPTOP_LEVEL_EXCEPTION_FILTER old_filter) {
100 ::SetUnhandledExceptionFilter(old_filter);
101 return EXCEPTION_CONTINUE_SEARCH;
102}
103
104// Retrieves a pointer to the current unhandled exception filter. There
105// is no standalone getter method.
106static LPTOP_LEVEL_EXCEPTION_FILTER GetTopSEHFilter() {
107 LPTOP_LEVEL_EXCEPTION_FILTER top_filter = NULL;
108 top_filter = ::SetUnhandledExceptionFilter(0);
109 ::SetUnhandledExceptionFilter(top_filter);
110 return top_filter;
111}
112
darin@google.com981f3552008-08-16 12:09:05 +0900113#endif // defined(OS_WIN)
114
initial.commit3f4a7322008-07-27 06:49:38 +0900115//------------------------------------------------------------------------------
116
erg@chromium.org493f5f62010-07-16 06:03:54 +0900117MessageLoop::TaskObserver::TaskObserver() {
118}
119
120MessageLoop::TaskObserver::~TaskObserver() {
121}
122
123MessageLoop::DestructionObserver::~DestructionObserver() {
124}
125
126//------------------------------------------------------------------------------
127
darin@google.comd936b5b2008-08-26 14:53:57 +0900128MessageLoop::MessageLoop(Type type)
129 : type_(type),
darin@google.comee6fa722008-08-13 08:25:43 +0900130 nestable_tasks_allowed_(true),
darin@google.com12d40bb2008-08-20 03:36:23 +0900131 exception_restoration_(false),
jar@chromium.org34571142011-04-05 13:48:53 +0900132 message_histogram_(NULL),
darin@google.combe165ae2008-09-07 17:08:29 +0900133 state_(NULL),
ananta@chromium.orgc542fec2011-03-24 12:40:28 +0900134#ifdef OS_WIN
135 os_modal_loop_(false),
136#endif // OS_WIN
darin@google.combe165ae2008-09-07 17:08:29 +0900137 next_sequence_num_(0) {
deanm@chromium.orgcd1ce302008-09-10 19:54:06 +0900138 DCHECK(!current()) << "should only have one message loop per thread";
139 lazy_tls_ptr.Pointer()->Set(this);
darin@google.comd936b5b2008-08-26 14:53:57 +0900140
nduca@chromium.orgba048612011-08-16 05:33:46 +0900141 message_loop_proxy_ = new base::MessageLoopProxyImpl();
142
thestig@chromium.org7016bac2010-04-15 10:04:29 +0900143// TODO(rvargas): Get rid of the OS guards.
darin@google.com981f3552008-08-16 12:09:05 +0900144#if defined(OS_WIN)
thestig@chromium.org7016bac2010-04-15 10:04:29 +0900145#define MESSAGE_PUMP_UI new base::MessagePumpForUI()
146#define MESSAGE_PUMP_IO new base::MessagePumpForIO()
147#elif defined(OS_MACOSX)
148#define MESSAGE_PUMP_UI base::MessagePumpMac::Create()
149#define MESSAGE_PUMP_IO new base::MessagePumpLibevent()
abarth@chromium.org1f1c2172010-12-01 17:45:51 +0900150#elif defined(OS_NACL)
151// Currently NaCl doesn't have a UI or an IO MessageLoop.
152// TODO(abarth): Figure out if we need these.
153#define MESSAGE_PUMP_UI NULL
154#define MESSAGE_PUMP_IO NULL
thestig@chromium.org7016bac2010-04-15 10:04:29 +0900155#elif defined(OS_POSIX) // POSIX but not MACOSX.
piman@chromium.orgbfd272d2011-12-15 01:34:31 +0900156#define MESSAGE_PUMP_UI new base::MessagePumpForUI()
thestig@chromium.org7016bac2010-04-15 10:04:29 +0900157#define MESSAGE_PUMP_IO new base::MessagePumpLibevent()
evan@chromium.org875bb6e2009-12-29 09:32:52 +0900158#else
thestig@chromium.org7016bac2010-04-15 10:04:29 +0900159#error Not implemented
evan@chromium.org875bb6e2009-12-29 09:32:52 +0900160#endif
thestig@chromium.org7016bac2010-04-15 10:04:29 +0900161
162 if (type_ == TYPE_UI) {
michaelbai@google.com686190b2011-08-03 01:11:16 +0900163 if (message_pump_for_ui_factory_)
164 pump_ = message_pump_for_ui_factory_();
165 else
166 pump_ = MESSAGE_PUMP_UI;
dsh@google.com119a2522008-10-04 01:52:59 +0900167 } else if (type_ == TYPE_IO) {
thestig@chromium.org7016bac2010-04-15 10:04:29 +0900168 pump_ = MESSAGE_PUMP_IO;
dkegel@google.com9e044ae2008-09-19 03:46:26 +0900169 } else {
thestig@chromium.org7016bac2010-04-15 10:04:29 +0900170 DCHECK_EQ(TYPE_DEFAULT, type_);
dkegel@google.com9e044ae2008-09-19 03:46:26 +0900171 pump_ = new base::MessagePumpDefault();
172 }
initial.commit3f4a7322008-07-27 06:49:38 +0900173}
174
175MessageLoop::~MessageLoop() {
thestig@chromium.org226880a2010-11-11 05:28:06 +0900176 DCHECK_EQ(this, current());
darin@google.com965e5342008-08-06 08:16:41 +0900177
darin@google.com0e500502008-09-09 14:55:35 +0900178 DCHECK(!state_);
179
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900180 // Clean up any unprocessed tasks, but take care: deleting a task could
181 // result in the addition of more tasks (e.g., via DeleteSoon). We set a
182 // limit on the number of times we will allow a deleted task to generate more
183 // tasks. Normally, we should only pass through this loop once or twice. If
184 // we end up hitting the loop limit, then it is probably due to one task that
185 // is being stubborn. Inspect the queues to see who is left.
186 bool did_work;
187 for (int i = 0; i < 100; ++i) {
188 DeletePendingTasks();
189 ReloadWorkQueue();
190 // If we end up with empty queues, then break out of the loop.
191 did_work = DeletePendingTasks();
192 if (!did_work)
193 break;
darin@google.com0e500502008-09-09 14:55:35 +0900194 }
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900195 DCHECK(!did_work);
196
sanjeevr@chromium.org03b44d52010-11-30 09:25:29 +0900197 // Let interested parties have one last shot at accessing this.
198 FOR_EACH_OBSERVER(DestructionObserver, destruction_observers_,
199 WillDestroyCurrentMessageLoop());
200
nduca@chromium.orgba048612011-08-16 05:33:46 +0900201 // Tell the message_loop_proxy that we are dying.
202 static_cast<base::MessageLoopProxyImpl*>(message_loop_proxy_.get())->
203 WillDestroyCurrentMessageLoop();
204 message_loop_proxy_ = NULL;
205
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900206 // OK, now make it so that no one can find us.
deanm@chromium.orge4cc5922008-09-10 20:14:56 +0900207 lazy_tls_ptr.Pointer()->Set(NULL);
mbelshe@chromium.orgbee85b32011-05-16 04:20:49 +0900208
209#if defined(OS_WIN)
210 // If we left the high-resolution timer activated, deactivate it now.
211 // Doing this is not-critical, it is mainly to make sure we track
212 // the high resolution timer activations properly in our unit tests.
213 if (!high_resolution_timer_expiration_.is_null()) {
214 base::Time::ActivateHighResolutionTimer(false);
215 high_resolution_timer_expiration_ = base::TimeTicks();
216 }
217#endif
initial.commit3f4a7322008-07-27 06:49:38 +0900218}
219
erg@google.com67a25432011-01-08 05:23:43 +0900220// static
221MessageLoop* MessageLoop::current() {
222 // TODO(darin): sadly, we cannot enable this yet since people call us even
223 // when they have no intention of using us.
224 // DCHECK(loop) << "Ouch, did you forget to initialize me?";
225 return lazy_tls_ptr.Pointer()->Get();
226}
227
228// static
229void MessageLoop::EnableHistogrammer(bool enable) {
230 enable_histogrammer_ = enable;
231}
232
michaelbai@google.com686190b2011-08-03 01:11:16 +0900233// static
234void MessageLoop::InitMessagePumpForUIFactory(MessagePumpFactory* factory) {
235 DCHECK(!message_pump_for_ui_factory_);
236 message_pump_for_ui_factory_ = factory;
237}
238
sky@chromium.org18c66dc2010-09-16 07:14:36 +0900239void MessageLoop::AddDestructionObserver(
240 DestructionObserver* destruction_observer) {
thestig@chromium.org226880a2010-11-11 05:28:06 +0900241 DCHECK_EQ(this, current());
sky@chromium.org18c66dc2010-09-16 07:14:36 +0900242 destruction_observers_.AddObserver(destruction_observer);
darin@google.com965e5342008-08-06 08:16:41 +0900243}
244
sky@chromium.org18c66dc2010-09-16 07:14:36 +0900245void MessageLoop::RemoveDestructionObserver(
246 DestructionObserver* destruction_observer) {
thestig@chromium.org226880a2010-11-11 05:28:06 +0900247 DCHECK_EQ(this, current());
sky@chromium.org18c66dc2010-09-16 07:14:36 +0900248 destruction_observers_.RemoveObserver(destruction_observer);
darin@google.com965e5342008-08-06 08:16:41 +0900249}
250
darin@google.combe165ae2008-09-07 17:08:29 +0900251void MessageLoop::PostTask(
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900252 const tracked_objects::Location& from_here, const base::Closure& task) {
brettw@chromium.org5faed3c2011-10-27 06:48:00 +0900253 DCHECK(!task.is_null()) << from_here.ToString();
jhawkins@chromium.org2af12f22011-11-16 08:36:30 +0900254 PendingTask pending_task(from_here, task, CalculateDelayedRuntime(0), true);
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900255 AddToIncomingQueue(&pending_task);
256}
257
258void MessageLoop::PostDelayedTask(
tedvessenes@gmail.com658a87f2011-12-30 10:04:36 +0900259 const tracked_objects::Location& from_here,
260 const base::Closure& task,
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900261 int64 delay_ms) {
brettw@chromium.org5faed3c2011-10-27 06:48:00 +0900262 DCHECK(!task.is_null()) << from_here.ToString();
jhawkins@chromium.org2af12f22011-11-16 08:36:30 +0900263 PendingTask pending_task(from_here, task,
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900264 CalculateDelayedRuntime(delay_ms), true);
265 AddToIncomingQueue(&pending_task);
266}
267
tedvessenes@gmail.com658a87f2011-12-30 10:04:36 +0900268void MessageLoop::PostDelayedTask(
269 const tracked_objects::Location& from_here,
270 const base::Closure& task,
271 base::TimeDelta delay) {
272 PostDelayedTask(from_here, task, delay.InMillisecondsRoundedUp());
273}
274
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900275void MessageLoop::PostNonNestableTask(
276 const tracked_objects::Location& from_here, const base::Closure& task) {
brettw@chromium.org5faed3c2011-10-27 06:48:00 +0900277 DCHECK(!task.is_null()) << from_here.ToString();
jhawkins@chromium.org2af12f22011-11-16 08:36:30 +0900278 PendingTask pending_task(from_here, task, CalculateDelayedRuntime(0), false);
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900279 AddToIncomingQueue(&pending_task);
280}
281
282void MessageLoop::PostNonNestableDelayedTask(
283 const tracked_objects::Location& from_here, const base::Closure& task,
284 int64 delay_ms) {
brettw@chromium.org5faed3c2011-10-27 06:48:00 +0900285 DCHECK(!task.is_null()) << from_here.ToString();
jhawkins@chromium.org2af12f22011-11-16 08:36:30 +0900286 PendingTask pending_task(from_here, task,
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900287 CalculateDelayedRuntime(delay_ms), false);
288 AddToIncomingQueue(&pending_task);
darin@google.combe165ae2008-09-07 17:08:29 +0900289}
290
tedvessenes@gmail.com658a87f2011-12-30 10:04:36 +0900291void MessageLoop::PostNonNestableDelayedTask(
292 const tracked_objects::Location& from_here,
293 const base::Closure& task,
294 base::TimeDelta delay) {
295 PostNonNestableDelayedTask(from_here, task, delay.InMillisecondsRoundedUp());
296}
297
erg@google.com67a25432011-01-08 05:23:43 +0900298void MessageLoop::Run() {
299 AutoRunState save_state(this);
300 RunHandler();
301}
darin@google.com0795f572008-08-30 09:22:48 +0900302
erg@google.com67a25432011-01-08 05:23:43 +0900303void MessageLoop::RunAllPending() {
304 AutoRunState save_state(this);
305 state_->quit_received = true; // Means run until we would otherwise block.
306 RunHandler();
307}
darin@google.com0795f572008-08-30 09:22:48 +0900308
erg@google.com67a25432011-01-08 05:23:43 +0900309void MessageLoop::Quit() {
310 DCHECK_EQ(this, current());
311 if (state_) {
312 state_->quit_received = true;
darin@google.com0795f572008-08-30 09:22:48 +0900313 } else {
erg@google.com67a25432011-01-08 05:23:43 +0900314 NOTREACHED() << "Must be inside Run to call Quit";
darin@google.com0795f572008-08-30 09:22:48 +0900315 }
erg@google.com67a25432011-01-08 05:23:43 +0900316}
darin@google.com0795f572008-08-30 09:22:48 +0900317
erg@google.com67a25432011-01-08 05:23:43 +0900318void MessageLoop::QuitNow() {
319 DCHECK_EQ(this, current());
320 if (state_) {
321 pump_->Quit();
322 } else {
323 NOTREACHED() << "Must be inside Run to call Quit";
mbelshe@chromium.orgde50b7d2010-06-29 13:58:15 +0900324 }
initial.commit3f4a7322008-07-27 06:49:38 +0900325}
326
kalman@chromium.orgc89ed902011-10-21 15:21:57 +0900327static void QuitCurrent() {
328 MessageLoop::current()->Quit();
329}
330
jhawkins@chromium.org573d4182011-10-17 10:20:36 +0900331// static
332base::Closure MessageLoop::QuitClosure() {
kalman@chromium.orgc89ed902011-10-21 15:21:57 +0900333 return base::Bind(&QuitCurrent);
jhawkins@chromium.org573d4182011-10-17 10:20:36 +0900334}
335
initial.commit3f4a7322008-07-27 06:49:38 +0900336void MessageLoop::SetNestableTasksAllowed(bool allowed) {
mpcomplete@google.com989d5f82008-08-09 09:14:09 +0900337 if (nestable_tasks_allowed_ != allowed) {
338 nestable_tasks_allowed_ = allowed;
339 if (!nestable_tasks_allowed_)
340 return;
341 // Start the native pump if we are not already pumping.
darin@google.com981f3552008-08-16 12:09:05 +0900342 pump_->ScheduleWork();
mpcomplete@google.com989d5f82008-08-09 09:14:09 +0900343 }
initial.commit3f4a7322008-07-27 06:49:38 +0900344}
345
346bool MessageLoop::NestableTasksAllowed() const {
347 return nestable_tasks_allowed_;
348}
349
jcampan@chromium.orgeac57172009-07-02 04:53:59 +0900350bool MessageLoop::IsNested() {
351 return state_->run_depth > 1;
352}
353
erg@google.com67a25432011-01-08 05:23:43 +0900354void MessageLoop::AddTaskObserver(TaskObserver* task_observer) {
355 DCHECK_EQ(this, current());
356 task_observers_.AddObserver(task_observer);
357}
358
359void MessageLoop::RemoveTaskObserver(TaskObserver* task_observer) {
360 DCHECK_EQ(this, current());
361 task_observers_.RemoveObserver(task_observer);
362}
363
willchan@chromium.org3a397672011-01-26 09:53:48 +0900364void MessageLoop::AssertIdle() const {
365 // We only check |incoming_queue_|, since we don't want to lock |work_queue_|.
366 base::AutoLock lock(incoming_queue_lock_);
367 DCHECK(incoming_queue_.empty());
368}
369
willchan@chromium.orgfe2201e2011-11-02 07:06:58 +0900370bool MessageLoop::is_running() const {
371 DCHECK_EQ(this, current());
372 return state_ != NULL;
373}
374
initial.commit3f4a7322008-07-27 06:49:38 +0900375//------------------------------------------------------------------------------
initial.commit3f4a7322008-07-27 06:49:38 +0900376
erg@google.com67a25432011-01-08 05:23:43 +0900377// Runs the loop in two different SEH modes:
378// enable_SEH_restoration_ = false : any unhandled exception goes to the last
379// one that calls SetUnhandledExceptionFilter().
380// enable_SEH_restoration_ = true : any unhandled exception goes to the filter
381// that was existed before the loop was run.
382void MessageLoop::RunHandler() {
383#if defined(OS_WIN)
384 if (exception_restoration_) {
385 RunInternalInSEHFrame();
386 return;
387 }
388#endif
389
390 RunInternal();
391}
392
393#if defined(OS_WIN)
394__declspec(noinline) void MessageLoop::RunInternalInSEHFrame() {
395 LPTOP_LEVEL_EXCEPTION_FILTER current_filter = GetTopSEHFilter();
396 __try {
397 RunInternal();
398 } __except(SEHFilter(current_filter)) {
399 }
400 return;
401}
402#endif
403
404void MessageLoop::RunInternal() {
405 DCHECK_EQ(this, current());
406
407 StartHistogrammer();
408
michaelbai@google.com686190b2011-08-03 01:11:16 +0900409#if !defined(OS_MACOSX) && !defined(OS_ANDROID)
erg@google.com67a25432011-01-08 05:23:43 +0900410 if (state_->dispatcher && type() == TYPE_UI) {
411 static_cast<base::MessagePumpForUI*>(pump_.get())->
412 RunWithDispatcher(this, state_->dispatcher);
413 return;
414 }
415#endif
416
417 pump_->Run(this);
418}
419
420bool MessageLoop::ProcessNextDelayedNonNestableTask() {
421 if (state_->run_depth != 1)
422 return false;
423
424 if (deferred_non_nestable_work_queue_.empty())
425 return false;
426
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900427 PendingTask pending_task = deferred_non_nestable_work_queue_.front();
erg@google.com67a25432011-01-08 05:23:43 +0900428 deferred_non_nestable_work_queue_.pop();
429
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900430 RunTask(pending_task);
erg@google.com67a25432011-01-08 05:23:43 +0900431 return true;
432}
433
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900434void MessageLoop::RunTask(const PendingTask& pending_task) {
jbates@chromium.org5a97c212012-02-24 04:16:35 +0900435 TRACE_EVENT2("task", "MessageLoop::RunTask",
436 "src_file", pending_task.posted_from.file_name(),
437 "src_func", pending_task.posted_from.function_name());
initial.commit3f4a7322008-07-27 06:49:38 +0900438 DCHECK(nestable_tasks_allowed_);
439 // Execute the task and assume the worst: It is probably not reentrant.
440 nestable_tasks_allowed_ = false;
darin@google.combe165ae2008-09-07 17:08:29 +0900441
apatrick@chromium.org87164042011-05-20 07:28:25 +0900442 // Before running the task, store the program counter where it was posted
443 // and deliberately alias it to ensure it is on the stack if the task
444 // crashes. Be careful not to assume that the variable itself will have the
445 // expected value when displayed by the optimizer in an optimized build.
446 // Look at a memory dump of the stack.
jbates@chromium.orgb84db522011-10-04 02:51:25 +0900447 const void* program_counter =
448 pending_task.posted_from.program_counter();
apatrick@chromium.org87164042011-05-20 07:28:25 +0900449 base::debug::Alias(&program_counter);
450
darin@google.combe165ae2008-09-07 17:08:29 +0900451 HistogramEvent(kTaskRunEvent);
jar@chromium.org79a58c32011-10-16 08:52:45 +0900452
jar@chromium.orgb536eef2011-11-14 14:24:07 +0900453 tracked_objects::TrackedTime start_time =
jar@chromium.orgb5c974b2011-12-14 10:36:48 +0900454 tracked_objects::ThreadData::NowForStartOfRun(pending_task.birth_tally);
jar@chromium.org79a58c32011-10-16 08:52:45 +0900455
willchan@chromium.orga9047632010-06-10 06:20:41 +0900456 FOR_EACH_OBSERVER(TaskObserver, task_observers_,
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900457 WillProcessTask(pending_task.time_posted));
458 pending_task.task.Run();
459 FOR_EACH_OBSERVER(TaskObserver, task_observers_,
460 DidProcessTask(pending_task.time_posted));
jar@chromium.org4be2cb02011-11-01 07:36:21 +0900461
462 tracked_objects::ThreadData::TallyRunOnNamedThreadIfTracking(pending_task,
jar@chromium.orgb536eef2011-11-14 14:24:07 +0900463 start_time, tracked_objects::ThreadData::NowForEndOfRun());
darin@google.combe165ae2008-09-07 17:08:29 +0900464
465 nestable_tasks_allowed_ = true;
initial.commit3f4a7322008-07-27 06:49:38 +0900466}
467
jar@chromium.org79a58c32011-10-16 08:52:45 +0900468bool MessageLoop::DeferOrRunPendingTask(const PendingTask& pending_task) {
darin@google.combe165ae2008-09-07 17:08:29 +0900469 if (pending_task.nestable || state_->run_depth == 1) {
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900470 RunTask(pending_task);
darin@google.combe165ae2008-09-07 17:08:29 +0900471 // Show that we ran a task (Note: a new one might arrive as a
472 // consequence!).
473 return true;
474 }
475
476 // We couldn't run the task now because we're in a nested message loop
477 // and the task isn't nestable.
478 deferred_non_nestable_work_queue_.push(pending_task);
479 return false;
initial.commit3f4a7322008-07-27 06:49:38 +0900480}
481
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900482void MessageLoop::AddToDelayedWorkQueue(const PendingTask& pending_task) {
483 // Move to the delayed work queue. Initialize the sequence number
484 // before inserting into the delayed_work_queue_. The sequence number
485 // is used to faciliate FIFO sorting when two tasks have the same
486 // delayed_run_time value.
487 PendingTask new_pending_task(pending_task);
488 new_pending_task.sequence_num = next_sequence_num_++;
489 delayed_work_queue_.push(new_pending_task);
490}
491
initial.commit3f4a7322008-07-27 06:49:38 +0900492void MessageLoop::ReloadWorkQueue() {
493 // We can improve performance of our loading tasks from incoming_queue_ to
darin@google.com981f3552008-08-16 12:09:05 +0900494 // work_queue_ by waiting until the last minute (work_queue_ is empty) to
495 // load. That reduces the number of locks-per-task significantly when our
darin@google.combe165ae2008-09-07 17:08:29 +0900496 // queues get large.
497 if (!work_queue_.empty())
initial.commit3f4a7322008-07-27 06:49:38 +0900498 return; // Wait till we *really* need to lock and load.
499
500 // Acquire all we can from the inter-thread queue with one lock acquisition.
initial.commit3f4a7322008-07-27 06:49:38 +0900501 {
brettw@chromium.orgabe477a2011-01-21 13:55:52 +0900502 base::AutoLock lock(incoming_queue_lock_);
darin@google.combe165ae2008-09-07 17:08:29 +0900503 if (incoming_queue_.empty())
initial.commit3f4a7322008-07-27 06:49:38 +0900504 return;
darin@chromium.orgb80ef1a2009-09-03 05:05:21 +0900505 incoming_queue_.Swap(&work_queue_); // Constant time
darin@google.combe165ae2008-09-07 17:08:29 +0900506 DCHECK(incoming_queue_.empty());
initial.commit3f4a7322008-07-27 06:49:38 +0900507 }
508}
509
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900510bool MessageLoop::DeletePendingTasks() {
511 bool did_work = !work_queue_.empty();
512 while (!work_queue_.empty()) {
513 PendingTask pending_task = work_queue_.front();
514 work_queue_.pop();
515 if (!pending_task.delayed_run_time.is_null()) {
516 // We want to delete delayed tasks in the same order in which they would
517 // normally be deleted in case of any funny dependencies between delayed
518 // tasks.
519 AddToDelayedWorkQueue(pending_task);
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900520 }
initial.commit3f4a7322008-07-27 06:49:38 +0900521 }
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900522 did_work |= !deferred_non_nestable_work_queue_.empty();
523 while (!deferred_non_nestable_work_queue_.empty()) {
jar@chromium.org2fa6b4b2009-03-12 04:53:50 +0900524 deferred_non_nestable_work_queue_.pop();
initial.commit3f4a7322008-07-27 06:49:38 +0900525 }
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900526 did_work |= !delayed_work_queue_.empty();
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900527
528 // Historically, we always delete the task regardless of valgrind status. It's
529 // not completely clear why we want to leak them in the loops above. This
530 // code is replicating legacy behavior, and should not be considered
531 // absolutely "correct" behavior. See TODO above about deleting all tasks
532 // when it's safe.
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900533 while (!delayed_work_queue_.empty()) {
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900534 delayed_work_queue_.pop();
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900535 }
536 return did_work;
initial.commit3f4a7322008-07-27 06:49:38 +0900537}
538
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900539TimeTicks MessageLoop::CalculateDelayedRuntime(int64 delay_ms) {
540 TimeTicks delayed_run_time;
erg@google.com67a25432011-01-08 05:23:43 +0900541 if (delay_ms > 0) {
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900542 delayed_run_time =
erg@google.com67a25432011-01-08 05:23:43 +0900543 TimeTicks::Now() + TimeDelta::FromMilliseconds(delay_ms);
544
545#if defined(OS_WIN)
546 if (high_resolution_timer_expiration_.is_null()) {
547 // Windows timers are granular to 15.6ms. If we only set high-res
548 // timers for those under 15.6ms, then a 18ms timer ticks at ~32ms,
549 // which as a percentage is pretty inaccurate. So enable high
550 // res timers for any timer which is within 2x of the granularity.
551 // This is a tradeoff between accuracy and power management.
552 bool needs_high_res_timers =
553 delay_ms < (2 * base::Time::kMinLowResolutionThresholdMs);
554 if (needs_high_res_timers) {
mbelshe@chromium.orgbee85b32011-05-16 04:20:49 +0900555 if (base::Time::ActivateHighResolutionTimer(true)) {
556 high_resolution_timer_expiration_ = TimeTicks::Now() +
557 TimeDelta::FromMilliseconds(kHighResolutionTimerModeLeaseTimeMs);
558 }
erg@google.com67a25432011-01-08 05:23:43 +0900559 }
560 }
561#endif
562 } else {
563 DCHECK_EQ(delay_ms, 0) << "delay should not be negative";
564 }
565
566#if defined(OS_WIN)
567 if (!high_resolution_timer_expiration_.is_null()) {
568 if (TimeTicks::Now() > high_resolution_timer_expiration_) {
569 base::Time::ActivateHighResolutionTimer(false);
570 high_resolution_timer_expiration_ = TimeTicks();
571 }
572 }
573#endif
574
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900575 return delayed_run_time;
576}
577
578// Possibly called on a background thread!
579void MessageLoop::AddToIncomingQueue(PendingTask* pending_task) {
erg@google.com67a25432011-01-08 05:23:43 +0900580 // Warning: Don't try to short-circuit, and handle this thread's tasks more
581 // directly, as it could starve handling of foreign threads. Put every task
582 // into this queue.
583
584 scoped_refptr<base::MessagePump> pump;
585 {
brettw@chromium.orgabe477a2011-01-21 13:55:52 +0900586 base::AutoLock locked(incoming_queue_lock_);
erg@google.com67a25432011-01-08 05:23:43 +0900587
588 bool was_empty = incoming_queue_.empty();
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900589 incoming_queue_.push(*pending_task);
590 pending_task->task.Reset();
erg@google.com67a25432011-01-08 05:23:43 +0900591 if (!was_empty)
592 return; // Someone else should have started the sub-pump.
593
594 pump = pump_;
595 }
596 // Since the incoming_queue_ may contain a task that destroys this message
597 // loop, we cannot exit incoming_queue_lock_ until we are done with |this|.
598 // We use a stack-based reference to the message pump so that we can call
599 // ScheduleWork outside of incoming_queue_lock_.
600
601 pump->ScheduleWork();
602}
603
604//------------------------------------------------------------------------------
605// Method and data for histogramming events and actions taken by each instance
606// on each thread.
607
608void MessageLoop::StartHistogrammer() {
jar@chromium.org34571142011-04-05 13:48:53 +0900609 if (enable_histogrammer_ && !message_histogram_
erg@google.com67a25432011-01-08 05:23:43 +0900610 && base::StatisticsRecorder::IsActive()) {
611 DCHECK(!thread_name_.empty());
612 message_histogram_ = base::LinearHistogram::FactoryGet(
613 "MsgLoop:" + thread_name_,
614 kLeastNonZeroMessageId, kMaxMessageId,
615 kNumberOfDistinctMessagesDisplayed,
616 message_histogram_->kHexRangePrintingFlag);
617 message_histogram_->SetRangeDescriptions(event_descriptions_);
618 }
619}
620
621void MessageLoop::HistogramEvent(int event) {
jar@chromium.org34571142011-04-05 13:48:53 +0900622 if (message_histogram_)
erg@google.com67a25432011-01-08 05:23:43 +0900623 message_histogram_->Add(event);
624}
625
darin@google.com981f3552008-08-16 12:09:05 +0900626bool MessageLoop::DoWork() {
darin@google.combe165ae2008-09-07 17:08:29 +0900627 if (!nestable_tasks_allowed_) {
628 // Task can't be executed right now.
629 return false;
630 }
631
632 for (;;) {
633 ReloadWorkQueue();
634 if (work_queue_.empty())
635 break;
636
637 // Execute oldest task.
638 do {
639 PendingTask pending_task = work_queue_.front();
640 work_queue_.pop();
641 if (!pending_task.delayed_run_time.is_null()) {
darin@chromium.orge3af17f2008-09-10 09:37:07 +0900642 AddToDelayedWorkQueue(pending_task);
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900643 // If we changed the topmost task, then it is time to reschedule.
644 if (delayed_work_queue_.top().task.Equals(pending_task.task))
darin@google.combe165ae2008-09-07 17:08:29 +0900645 pump_->ScheduleDelayedWork(pending_task.delayed_run_time);
646 } else {
647 if (DeferOrRunPendingTask(pending_task))
648 return true;
649 }
650 } while (!work_queue_.empty());
651 }
652
653 // Nothing happened.
654 return false;
darin@google.com981f3552008-08-16 12:09:05 +0900655}
656
ajwong@chromium.org94d2a582011-04-21 01:02:23 +0900657bool MessageLoop::DoDelayedWork(TimeTicks* next_delayed_work_time) {
jar@chromium.org40355072010-10-21 15:32:33 +0900658 if (!nestable_tasks_allowed_ || delayed_work_queue_.empty()) {
jar@chromium.org9b0fb062010-11-07 07:23:29 +0900659 recent_time_ = *next_delayed_work_time = TimeTicks();
darin@google.combe165ae2008-09-07 17:08:29 +0900660 return false;
661 }
jeremy@chromium.org2ed223c2008-12-09 02:36:06 +0900662
jar@chromium.org9b0fb062010-11-07 07:23:29 +0900663 // When we "fall behind," there will be a lot of tasks in the delayed work
jar@chromium.org94f73832010-11-05 08:23:42 +0900664 // queue that are ready to run. To increase efficiency when we fall behind,
665 // we will only call Time::Now() intermittently, and then process all tasks
666 // that are ready to run before calling it again. As a result, the more we
667 // fall behind (and have a lot of ready-to-run delayed tasks), the more
668 // efficient we'll be at handling the tasks.
jar@chromium.org9b0fb062010-11-07 07:23:29 +0900669
670 TimeTicks next_run_time = delayed_work_queue_.top().delayed_run_time;
jar@chromium.org94f73832010-11-05 08:23:42 +0900671 if (next_run_time > recent_time_) {
jar@chromium.org9b0fb062010-11-07 07:23:29 +0900672 recent_time_ = TimeTicks::Now(); // Get a better view of Now();
jar@chromium.org94f73832010-11-05 08:23:42 +0900673 if (next_run_time > recent_time_) {
674 *next_delayed_work_time = next_run_time;
675 return false;
676 }
darin@google.combe165ae2008-09-07 17:08:29 +0900677 }
darin@google.com981f3552008-08-16 12:09:05 +0900678
jar@chromium.org40355072010-10-21 15:32:33 +0900679 PendingTask pending_task = delayed_work_queue_.top();
680 delayed_work_queue_.pop();
jeremy@chromium.org2ed223c2008-12-09 02:36:06 +0900681
jar@chromium.org40355072010-10-21 15:32:33 +0900682 if (!delayed_work_queue_.empty())
darin@google.combe165ae2008-09-07 17:08:29 +0900683 *next_delayed_work_time = delayed_work_queue_.top().delayed_run_time;
darin@google.com981f3552008-08-16 12:09:05 +0900684
darin@google.combe165ae2008-09-07 17:08:29 +0900685 return DeferOrRunPendingTask(pending_task);
darin@google.com981f3552008-08-16 12:09:05 +0900686}
687
688bool MessageLoop::DoIdleWork() {
689 if (ProcessNextDelayedNonNestableTask())
690 return true;
691
692 if (state_->quit_received)
693 pump_->Quit();
694
695 return false;
696}
697
dcheng@chromium.org36904742011-12-30 13:32:58 +0900698void MessageLoop::DeleteSoonInternal(const tracked_objects::Location& from_here,
699 void(*deleter)(const void*),
700 const void* object) {
701 PostNonNestableTask(from_here, base::Bind(deleter, object));
702}
703
dcheng@chromium.org2116fc92011-12-30 15:46:30 +0900704void MessageLoop::ReleaseSoonInternal(
705 const tracked_objects::Location& from_here,
706 void(*releaser)(const void*),
707 const void* object) {
708 PostNonNestableTask(from_here, base::Bind(releaser, object));
709}
710
darin@google.com981f3552008-08-16 12:09:05 +0900711//------------------------------------------------------------------------------
712// MessageLoop::AutoRunState
713
714MessageLoop::AutoRunState::AutoRunState(MessageLoop* loop) : loop_(loop) {
715 // Make the loop reference us.
716 previous_state_ = loop_->state_;
717 if (previous_state_) {
718 run_depth = previous_state_->run_depth + 1;
darin@google.com6ddeb842008-08-15 16:31:20 +0900719 } else {
darin@google.com981f3552008-08-16 12:09:05 +0900720 run_depth = 1;
darin@google.com6ddeb842008-08-15 16:31:20 +0900721 }
darin@google.com981f3552008-08-16 12:09:05 +0900722 loop_->state_ = this;
723
724 // Initialize the other fields:
725 quit_received = false;
michaelbai@google.com686190b2011-08-03 01:11:16 +0900726#if !defined(OS_MACOSX) && !defined(OS_ANDROID)
darin@google.com981f3552008-08-16 12:09:05 +0900727 dispatcher = NULL;
728#endif
729}
730
731MessageLoop::AutoRunState::~AutoRunState() {
732 loop_->state_ = previous_state_;
darin@google.comee6fa722008-08-13 08:25:43 +0900733}
734
initial.commit3f4a7322008-07-27 06:49:38 +0900735//------------------------------------------------------------------------------
darin@google.comd936b5b2008-08-26 14:53:57 +0900736// MessageLoopForUI
737
738#if defined(OS_WIN)
darin@google.comd936b5b2008-08-26 14:53:57 +0900739void MessageLoopForUI::DidProcessMessage(const MSG& message) {
740 pump_win()->DidProcessMessage(message);
741}
darin@google.comd936b5b2008-08-26 14:53:57 +0900742#endif // defined(OS_WIN)
743
michaelbai@google.com686190b2011-08-03 01:11:16 +0900744#if defined(OS_ANDROID)
745void MessageLoopForUI::Start() {
746 // No Histogram support for UI message loop as it is managed by Java side
747 static_cast<base::MessagePumpForUI*>(pump_.get())->Start(this);
748}
749#endif
750
751#if !defined(OS_MACOSX) && !defined(OS_NACL) && !defined(OS_ANDROID)
jcampan@chromium.org05423582009-08-01 07:53:37 +0900752void MessageLoopForUI::AddObserver(Observer* observer) {
753 pump_ui()->AddObserver(observer);
754}
755
756void MessageLoopForUI::RemoveObserver(Observer* observer) {
757 pump_ui()->RemoveObserver(observer);
758}
759
oshima@google.com08ff65e2011-10-24 16:19:51 +0900760void MessageLoopForUI::RunWithDispatcher(Dispatcher* dispatcher) {
jcampan@chromium.org05423582009-08-01 07:53:37 +0900761 AutoRunState save_state(this);
762 state_->dispatcher = dispatcher;
763 RunHandler();
764}
oshima@google.comc7bc27c2011-10-07 03:19:21 +0900765
766void MessageLoopForUI::RunAllPendingWithDispatcher(Dispatcher* dispatcher) {
767 AutoRunState save_state(this);
768 state_->dispatcher = dispatcher;
769 state_->quit_received = true; // Means run until we would otherwise block.
770 RunHandler();
771}
772
michaelbai@google.com686190b2011-08-03 01:11:16 +0900773#endif // !defined(OS_MACOSX) && !defined(OS_NACL) && !defined(OS_ANDROID)
jcampan@chromium.org05423582009-08-01 07:53:37 +0900774
darin@google.comd936b5b2008-08-26 14:53:57 +0900775//------------------------------------------------------------------------------
776// MessageLoopForIO
777
778#if defined(OS_WIN)
779
rvargas@google.com9e49aa22008-10-10 08:58:43 +0900780void MessageLoopForIO::RegisterIOHandler(HANDLE file, IOHandler* handler) {
781 pump_io()->RegisterIOHandler(file, handler);
782}
783
rvargas@google.com73887542008-11-08 06:52:15 +0900784bool MessageLoopForIO::WaitForIOCompletion(DWORD timeout, IOHandler* filter) {
785 return pump_io()->WaitForIOCompletion(timeout, filter);
rvargas@google.com9e49aa22008-10-10 08:58:43 +0900786}
787
abarth@chromium.org1f1c2172010-12-01 17:45:51 +0900788#elif defined(OS_POSIX) && !defined(OS_NACL)
dkegel@google.com9e044ae2008-09-19 03:46:26 +0900789
jeremy@chromium.orgefc0db02008-12-16 07:02:17 +0900790bool MessageLoopForIO::WatchFileDescriptor(int fd,
791 bool persistent,
792 Mode mode,
793 FileDescriptorWatcher *controller,
794 Watcher *delegate) {
795 return pump_libevent()->WatchFileDescriptor(
796 fd,
797 persistent,
798 static_cast<base::MessagePumpLibevent::Mode>(mode),
799 controller,
800 delegate);
dkegel@google.com9e044ae2008-09-19 03:46:26 +0900801}
802
dkegel@google.com9e044ae2008-09-19 03:46:26 +0900803#endif