simple_thread.h revision 2a99a7e74a7f215066514fe81d2bfa6639d9eddd 
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 PPAPI_UTILITY_THREADING_SIMPLE_THREAD_H_
6#define PPAPI_UTILITY_THREADING_SIMPLE_THREAD_H_
7
8#ifdef WIN32
9#include <windows.h>
10#else
11#include <pthread.h>
12#endif
13
14#include "ppapi/cpp/instance_handle.h"
15#include "ppapi/cpp/message_loop.h"
16
17namespace pp {
18
19// This class is a simple wrapper around a pthread/Windows thread that creates
20// and runs a PPAPI message loop on that thread.
21class SimpleThread {
22 public:
23#ifdef WIN32
24  typedef HANDLE ThreadHandle;
25#else
26  typedef pthread_t ThreadHandle;
27#endif
28
29  typedef void (*ThreadFunc)(MessageLoop&, void* user_data);
30
31  explicit SimpleThread(const InstanceHandle& instance);
32  explicit SimpleThread(const InstanceHandle& instance, size_t stacksize);
33  ~SimpleThread();
34
35  // Starts a thread and runs a message loop in it. If you need control over
36  // how the message loop is run, use StartWithFunction. Returns true on
37  // success, false if the thread is already running or couldn't be started.
38  bool Start();
39
40  // Posts a quit message to the message loop and blocks until the thread
41  // exits. Returns true on success. If the thread is not running, returns
42  // false.
43  bool Join();
44
45  // Normally you can just use Start() to start a thread, and then post work to
46  // it. In some cases you will want control over the message. If ThreadFunc
47  // is NULL, this acts the same as Start().
48  bool StartWithFunction(ThreadFunc func, void* user_data);
49
50  MessageLoop& message_loop() { return message_loop_; }
51  ThreadHandle thread() const { return thread_; }
52
53 private:
54  InstanceHandle instance_;
55  MessageLoop message_loop_;
56  const size_t stacksize_;
57  ThreadHandle thread_;
58
59  // Disallow (not implemented).
60  SimpleThread(const SimpleThread&);
61  SimpleThread(const SimpleThread&, size_t stacksize);
62  SimpleThread& operator=(const SimpleThread&);
63};
64
65}  // namespace pp
66
67#endif  // PPAPI_UTILITY_THREADING_SIMPLE_THREAD_H_
68
69