OLD | NEW |
1 // Copyright (c) 2006-2008 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2006-2008 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_MESSAGE_PUMP_LIBEVENT_H_ | 5 #ifndef BASE_MESSAGE_PUMP_LIBEVENT_H_ |
6 #define BASE_MESSAGE_PUMP_LIBEVENT_H_ | 6 #define BASE_MESSAGE_PUMP_LIBEVENT_H_ |
7 | 7 |
| 8 #include "base/basictypes.h" |
8 #include "base/message_pump.h" | 9 #include "base/message_pump.h" |
| 10 #include "base/observer_list.h" |
9 #include "base/time.h" | 11 #include "base/time.h" |
10 | 12 |
11 // Declare structs we need from libevent.h rather than including it | 13 // Declare structs we need from libevent.h rather than including it |
12 struct event_base; | 14 struct event_base; |
13 struct event; | 15 struct event; |
14 | 16 |
15 namespace base { | 17 namespace base { |
16 | 18 |
17 // Class to monitor sockets and issue callbacks when sockets are ready for I/O | 19 // Class to monitor sockets and issue callbacks when sockets are ready for I/O |
18 // TODO(dkegel): add support for background file IO somehow | 20 // TODO(dkegel): add support for background file IO somehow |
19 class MessagePumpLibevent : public MessagePump { | 21 class MessagePumpLibevent : public MessagePump { |
20 public: | 22 public: |
| 23 class IOObserver { |
| 24 public: |
| 25 IOObserver() {} |
21 | 26 |
22 // Object returned by WatchFileDescriptor to manage further watching. | 27 // An IOObserver is an object that receives IO notifications from the |
23 class FileDescriptorWatcher { | 28 // MessagePump. |
24 public: | 29 // |
25 FileDescriptorWatcher(); | 30 // NOTE: An IOObserver implementation should be extremely fast! |
26 ~FileDescriptorWatcher(); // Implicitly calls StopWatchingFileDescriptor. | 31 virtual void WillProcessIOEvent() = 0; |
| 32 virtual void DidProcessIOEvent() = 0; |
27 | 33 |
28 // NOTE: These methods aren't called StartWatching()/StopWatching() to | 34 protected: |
29 // avoid confusion with the win32 ObjectWatcher class. | 35 virtual ~IOObserver() {} |
30 | |
31 // Stop watching the FD, always safe to call. No-op if there's nothing | |
32 // to do. | |
33 bool StopWatchingFileDescriptor(); | |
34 | |
35 private: | |
36 // Called by MessagePumpLibevent, ownership of |e| is transferred to this | |
37 // object. | |
38 void Init(event* e, bool is_persistent); | |
39 | |
40 // Used by MessagePumpLibevent to take ownership of event_. | |
41 event *ReleaseEvent(); | |
42 friend class MessagePumpLibevent; | |
43 | |
44 private: | |
45 bool is_persistent_; // false if this event is one-shot. | |
46 event* event_; | |
47 DISALLOW_COPY_AND_ASSIGN(FileDescriptorWatcher); | |
48 }; | 36 }; |
49 | 37 |
50 // Used with WatchFileDescptor to asynchronously monitor the I/O readiness of | 38 // Used with WatchFileDescptor to asynchronously monitor the I/O readiness of |
51 // a File Descriptor. | 39 // a File Descriptor. |
52 class Watcher { | 40 class Watcher { |
53 public: | 41 public: |
54 virtual ~Watcher() {} | 42 virtual ~Watcher() {} |
55 // Called from MessageLoop::Run when an FD can be read from/written to | 43 // Called from MessageLoop::Run when an FD can be read from/written to |
56 // without blocking | 44 // without blocking |
57 virtual void OnFileCanReadWithoutBlocking(int fd) = 0; | 45 virtual void OnFileCanReadWithoutBlocking(int fd) = 0; |
58 virtual void OnFileCanWriteWithoutBlocking(int fd) = 0; | 46 virtual void OnFileCanWriteWithoutBlocking(int fd) = 0; |
59 }; | 47 }; |
60 | 48 |
| 49 // Object returned by WatchFileDescriptor to manage further watching. |
| 50 class FileDescriptorWatcher { |
| 51 public: |
| 52 FileDescriptorWatcher(); |
| 53 ~FileDescriptorWatcher(); // Implicitly calls StopWatchingFileDescriptor. |
| 54 |
| 55 // NOTE: These methods aren't called StartWatching()/StopWatching() to |
| 56 // avoid confusion with the win32 ObjectWatcher class. |
| 57 |
| 58 // Stop watching the FD, always safe to call. No-op if there's nothing |
| 59 // to do. |
| 60 bool StopWatchingFileDescriptor(); |
| 61 |
| 62 private: |
| 63 friend class MessagePumpLibevent; |
| 64 |
| 65 // Called by MessagePumpLibevent, ownership of |e| is transferred to this |
| 66 // object. |
| 67 void Init(event* e, bool is_persistent); |
| 68 |
| 69 // Used by MessagePumpLibevent to take ownership of event_. |
| 70 event *ReleaseEvent(); |
| 71 |
| 72 void set_pump(MessagePumpLibevent* pump) { pump_ = pump; } |
| 73 MessagePumpLibevent* pump() { return pump_; } |
| 74 |
| 75 void set_watcher(Watcher* watcher) { watcher_ = watcher; } |
| 76 |
| 77 void OnFileCanReadWithoutBlocking(int fd, MessagePumpLibevent* pump); |
| 78 void OnFileCanWriteWithoutBlocking(int fd, MessagePumpLibevent* pump); |
| 79 |
| 80 bool is_persistent_; // false if this event is one-shot. |
| 81 event* event_; |
| 82 MessagePumpLibevent* pump_; |
| 83 Watcher* watcher_; |
| 84 |
| 85 DISALLOW_COPY_AND_ASSIGN(FileDescriptorWatcher); |
| 86 }; |
| 87 |
61 MessagePumpLibevent(); | 88 MessagePumpLibevent(); |
62 virtual ~MessagePumpLibevent(); | 89 virtual ~MessagePumpLibevent(); |
63 | 90 |
64 enum Mode { | 91 enum Mode { |
65 WATCH_READ = 1 << 0, | 92 WATCH_READ = 1 << 0, |
66 WATCH_WRITE = 1 << 1, | 93 WATCH_WRITE = 1 << 1, |
67 WATCH_READ_WRITE = WATCH_READ | WATCH_WRITE | 94 WATCH_READ_WRITE = WATCH_READ | WATCH_WRITE |
68 }; | 95 }; |
69 | 96 |
70 // Have the current thread's message loop watch for a a situation in which | 97 // Have the current thread's message loop watch for a a situation in which |
71 // reading/writing to the FD can be performed without blocking. | 98 // reading/writing to the FD can be performed without blocking. |
72 // Callers must provide a preallocated FileDescriptorWatcher object which | 99 // Callers must provide a preallocated FileDescriptorWatcher object which |
73 // can later be used to manage the lifetime of this event. | 100 // can later be used to manage the lifetime of this event. |
74 // If a FileDescriptorWatcher is passed in which is already attached to | 101 // If a FileDescriptorWatcher is passed in which is already attached to |
75 // an event, then the effect is cumulative i.e. after the call |controller| | 102 // an event, then the effect is cumulative i.e. after the call |controller| |
76 // will watch both the previous event and the new one. | 103 // will watch both the previous event and the new one. |
77 // If an error occurs while calling this method in a cumulative fashion, the | 104 // If an error occurs while calling this method in a cumulative fashion, the |
78 // event previously attached to |controller| is aborted. | 105 // event previously attached to |controller| is aborted. |
79 // Returns true on success. | 106 // Returns true on success. |
80 // TODO(dkegel): switch to edge-triggered readiness notification | 107 // TODO(dkegel): switch to edge-triggered readiness notification |
81 bool WatchFileDescriptor(int fd, | 108 bool WatchFileDescriptor(int fd, |
82 bool persistent, | 109 bool persistent, |
83 Mode mode, | 110 Mode mode, |
84 FileDescriptorWatcher *controller, | 111 FileDescriptorWatcher *controller, |
85 Watcher *delegate); | 112 Watcher *delegate); |
86 | 113 |
| 114 void AddIOObserver(IOObserver* obs); |
| 115 void RemoveIOObserver(IOObserver* obs); |
| 116 |
87 // MessagePump methods: | 117 // MessagePump methods: |
88 virtual void Run(Delegate* delegate); | 118 virtual void Run(Delegate* delegate); |
89 virtual void Quit(); | 119 virtual void Quit(); |
90 virtual void ScheduleWork(); | 120 virtual void ScheduleWork(); |
91 virtual void ScheduleDelayedWork(const Time& delayed_work_time); | 121 virtual void ScheduleDelayedWork(const Time& delayed_work_time); |
92 | 122 |
93 private: | 123 private: |
| 124 void WillProcessIOEvent(); |
| 125 void DidProcessIOEvent(); |
94 | 126 |
95 // Risky part of constructor. Returns true on success. | 127 // Risky part of constructor. Returns true on success. |
96 bool Init(); | 128 bool Init(); |
97 | 129 |
98 // This flag is set to false when Run should return. | 130 // This flag is set to false when Run should return. |
99 bool keep_running_; | 131 bool keep_running_; |
100 | 132 |
101 // This flag is set when inside Run. | 133 // This flag is set when inside Run. |
102 bool in_run_; | 134 bool in_run_; |
103 | 135 |
(...skipping 11 matching lines...) Expand all Loading... |
115 // Unix pipe used to implement ScheduleWork() | 147 // Unix pipe used to implement ScheduleWork() |
116 // ... callback; called by libevent inside Run() when pipe is ready to read | 148 // ... callback; called by libevent inside Run() when pipe is ready to read |
117 static void OnWakeup(int socket, short flags, void* context); | 149 static void OnWakeup(int socket, short flags, void* context); |
118 // ... write end; ScheduleWork() writes a single byte to it | 150 // ... write end; ScheduleWork() writes a single byte to it |
119 int wakeup_pipe_in_; | 151 int wakeup_pipe_in_; |
120 // ... read end; OnWakeup reads it and then breaks Run() out of its sleep | 152 // ... read end; OnWakeup reads it and then breaks Run() out of its sleep |
121 int wakeup_pipe_out_; | 153 int wakeup_pipe_out_; |
122 // ... libevent wrapper for read end | 154 // ... libevent wrapper for read end |
123 event* wakeup_event_; | 155 event* wakeup_event_; |
124 | 156 |
| 157 ObserverList<IOObserver> io_observers_; |
| 158 |
125 DISALLOW_COPY_AND_ASSIGN(MessagePumpLibevent); | 159 DISALLOW_COPY_AND_ASSIGN(MessagePumpLibevent); |
126 }; | 160 }; |
127 | 161 |
128 } // namespace base | 162 } // namespace base |
129 | 163 |
130 #endif // BASE_MESSAGE_PUMP_LIBEVENT_H_ | 164 #endif // BASE_MESSAGE_PUMP_LIBEVENT_H_ |
OLD | NEW |