base/message_loop_proxy.h

   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
   3 // found in the LICENSE file.
   4
   5 #ifndef BASE_MESSAGE_LOOP_PROXY_H_
   6 #define BASE_MESSAGE_LOOP_PROXY_H_
   7 #pragma once
   8
   9 #include "base/base_export.h"
  10 #include "base/compiler_specific.h"
  11 #include "base/memory/ref_counted.h"
  12 #include "base/single_thread_task_runner.h"
  13
  14 namespace base {
  15
  16 // This class provides a thread-safe refcounted interface to the Post* methods
  17 // of a message loop. This class can outlive the target message loop.
  18 // MessageLoopProxy objects are constructed automatically for all MessageLoops.
  19 // So, to access them, you can use any of the following:
  20 //   Thread::message_loop_proxy()
  21 //   MessageLoop::current()->message_loop_proxy()
  22 //   MessageLoopProxy::current()
  23 //
  24 // TODO(akalin): Now that we have the *TaskRunner interfaces, we can
  25 // merge this with MessageLoopProxyImpl.
  26 class BASE_EXPORT MessageLoopProxy : public SingleThreadTaskRunner {
  27  public:
  28   // Gets the MessageLoopProxy for the current message loop, creating one if
  29   // needed.
  30   static scoped_refptr<MessageLoopProxy> current();
  31
  32  protected:
  33   MessageLoopProxy();
  34   virtual ~MessageLoopProxy();
  35 };
  36
  37 }  // namespace base
  38
  39 #endif  // BASE_MESSAGE_LOOP_PROXY_H_