OLD | NEW |
| (Empty) |
1 // Copyright 2013 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 MOJO_COMMON_HANDLE_WATCHER_H_ | |
6 #define MOJO_COMMON_HANDLE_WATCHER_H_ | |
7 | |
8 #include "base/basictypes.h" | |
9 #include "base/callback_forward.h" | |
10 #include "base/memory/scoped_ptr.h" | |
11 #include "base/run_loop.h" | |
12 #include "mojo/common/mojo_common_export.h" | |
13 #include "third_party/mojo/src/mojo/public/cpp/system/core.h" | |
14 | |
15 namespace base { | |
16 class Thread; | |
17 } | |
18 | |
19 namespace mojo { | |
20 namespace common { | |
21 namespace test { | |
22 class HandleWatcherTest; | |
23 } | |
24 | |
25 // HandleWatcher is used to asynchronously wait on a handle and notify a Closure | |
26 // when the handle is ready, or the deadline has expired. | |
27 class MOJO_COMMON_EXPORT HandleWatcher { | |
28 public: | |
29 HandleWatcher(); | |
30 | |
31 // The destructor implicitly stops listening. See Stop() for details. | |
32 ~HandleWatcher(); | |
33 | |
34 // Starts listening for |handle|. This implicitly invokes Stop(). In other | |
35 // words, Start() performs one asynchronous watch at a time. It is ok to call | |
36 // Start() multiple times, but it cancels any existing watches. |callback| is | |
37 // notified when the handle is ready, invalid or deadline has passed and is | |
38 // notified on the thread Start() was invoked on. If the current thread exits | |
39 // before the handle is ready, then |callback| is invoked with a result of | |
40 // MOJO_RESULT_ABORTED. | |
41 void Start(const Handle& handle, | |
42 MojoHandleSignals handle_signals, | |
43 MojoDeadline deadline, | |
44 const base::Callback<void(MojoResult)>& callback); | |
45 | |
46 // Stops listening. Does nothing if not in the process of listening. Blocks | |
47 // until no longer listening on the handle. | |
48 void Stop(); | |
49 | |
50 private: | |
51 class StateBase; | |
52 class SameThreadWatchingState; | |
53 class SecondaryThreadWatchingState; | |
54 | |
55 // If non-NULL Start() has been invoked. | |
56 scoped_ptr<StateBase> state_; | |
57 | |
58 DISALLOW_COPY_AND_ASSIGN(HandleWatcher); | |
59 }; | |
60 | |
61 } // namespace common | |
62 } // namespace mojo | |
63 | |
64 #endif // MOJO_COMMON_HANDLE_WATCHER_H_ | |
OLD | NEW |