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
|
// **********************************************************************
//
// Copyright (c) 2001
// Mutable Realms, Inc.
// Huntsville, AL, USA
//
// All Rights Reserved
//
// **********************************************************************
#ifndef ICE_APPLICATION_H
#define ICE_APPLICATION_H
#include <Ice/Ice.h>
#ifndef _WIN32
#include <csignal>
#endif
namespace Ice
{
#ifdef _WIN32
BOOL WINAPI interruptHandler(DWORD);
#else
void interruptHandler(int);
#endif
class ICE_API Application : public IceUtil::noncopyable
{
public:
Application();
virtual ~Application();
//
// This main() must be called by the global main(). main()
// initializes the Communicator, calls run() as a template method,
// and destroys the Communicator upon return from run(). It
// thereby handles all exceptions properly, i.e., error messages
// are printed if exceptions propagate to main(), and the
// Communicator is always destroyed, regardless of exceptions.
//
int main(int, char*[], const char* = 0);
virtual int run(int, char*[]) = 0;
//
// Return the application name, i.e., argv[0].
//
static const char* appName();
//
// One limitation of this class is that there can only be one
// Application instance, with one global Communicator, accessible
// with this communicator() operation. This limitiation is due to
// how the signal handling functions below operate. If you require
// multiple Communicators, then you cannot use this Application
// framework class.
//
static CommunicatorPtr communicator();
//
// These methods can be used to set a signal handler that calls
// communicator()->shutdown() upon interrupt (to make
// communicator()->waitForShutdown() return), to ignore
// interrupts, or to set interrupts back to default behavior.
//
static void shutdownOnInterrupt();
static void ignoreInterrupt();
static void defaultInterrupt();
//
// These methods can be used to temporarily block a signal and
// arrange for delivery of a pending signal later. Any signal
// that is received after holdInterrupt() was called is remember
// and delivered when releaseInterupt() is called. That signal
// is then handled according to the signal disposition established
// with shutdownOnInterrupt(), ignoreInterrupt(), or defaultInterrupt().
//
static void holdInterrupt();
static void releaseInterrupt();
private:
static const char* _appName;
static CommunicatorPtr _communicator;
#ifdef _WIN32
friend BOOL WINAPI interruptHandler(DWORD);
#else
friend void interruptHandler(int);
static const int signals[];
static sigset_t signalSet;
#endif
};
};
#endif
|
