1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
|
#ifndef _sys_Poller_h
#define _sys_Poller_h
/*
*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*
*/
#include "Time.h"
#include "Runnable.h"
#include "qpid/CommonImportExport.h"
#include <boost/shared_ptr.hpp>
namespace qpid {
namespace sys {
/**
* Poller: abstract class to encapsulate a file descriptor poll to be used
* by a reactor.
*
* @see DispatchHandler for more details of normal use.
*/
class PollerHandle;
class PollerPrivate;
class Poller : public Runnable {
PollerPrivate* const impl;
public:
typedef boost::shared_ptr<Poller> shared_ptr;
enum Direction {
NONE = 0,
INPUT,
OUTPUT,
INOUT
};
enum EventType {
INVALID = 0,
READABLE,
WRITABLE,
READ_WRITABLE,
DISCONNECTED,
SHUTDOWN,
TIMEOUT,
INTERRUPTED
};
struct Event {
PollerHandle* handle;
EventType type;
Event(PollerHandle* handle0, EventType type0) :
handle(handle0),
type(type0) {
}
void process();
};
QPID_COMMON_EXTERN Poller();
QPID_COMMON_EXTERN ~Poller();
/** Note: this function is async-signal safe */
QPID_COMMON_EXTERN void shutdown();
// Interrupt waiting for a specific poller handle
// returns true if we could interrupt the handle
// - in this case on return the handle is no longer being monitored,
// but we will receive an event from some invocation of poller::wait
// with the handle and the INTERRUPTED event type
// if it returns false then the handle is not being monitored by the poller
// - This can either be because it has just received an event which has been
// reported and has not been reenabled since.
// - Because it was removed from the monitoring set
// - Or because it is already being interrupted
QPID_COMMON_EXTERN bool interrupt(PollerHandle& handle);
// Poller run loop
QPID_COMMON_EXTERN void run();
QPID_COMMON_EXTERN void addFd(PollerHandle& handle, Direction dir);
QPID_COMMON_EXTERN void delFd(PollerHandle& handle);
QPID_COMMON_EXTERN void modFd(PollerHandle& handle, Direction dir);
QPID_COMMON_EXTERN void rearmFd(PollerHandle& handle);
QPID_COMMON_EXTERN Event wait(Duration timeout = TIME_INFINITE);
};
/**
* Handle class to use for polling
*/
class IOHandle;
class PollerHandlePrivate;
class PollerHandle {
friend class Poller;
friend struct Poller::Event;
PollerHandlePrivate* const impl;
QPID_COMMON_EXTERN virtual void processEvent(Poller::EventType) {};
public:
QPID_COMMON_EXTERN PollerHandle(const IOHandle& h);
QPID_COMMON_EXTERN virtual ~PollerHandle();
};
inline void Poller::Event::process() {
handle->processEvent(type);
}
}}
#endif // _sys_Poller_h
|