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
|
// **********************************************************************
//
// Copyright (c) 2003
// ZeroC, Inc.
// Billerica, MA, USA
//
// All Rights Reserved.
//
// Ice is free software; you can redistribute it and/or modify it under
// the terms of the GNU General Public License version 2 as published by
// the Free Software Foundation.
//
// **********************************************************************
#ifndef ICE_APPLICATION_H
#define ICE_APPLICATION_H
#include <Ice/Ice.h>
namespace Ice
{
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 limitation 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 Ctrl+C Handler callback.
//
static void destroyOnInterrupt();
static void shutdownOnInterrupt();
static void ignoreInterrupt();
//
// 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
// destroyOnInterrupt(), shutdownOnInterrupt() or
// ignoreInterrupt().
//
static void holdInterrupt();
static void releaseInterrupt();
//
// This method returns true if a signal handler was triggered,
// false otherwise. This can be used once
// Communicator::waitForShutdown() returns to test whether the
// shutdown was due to an interrupt (interrupted() returns true in
// that case) or because Communicator::shutdown() was called
// (interrupted() returns false in that case).
//
static bool interrupted();
#if defined(__SUNPRO_CC)
//
// Sun C++ 5.x does not like classes with no data members
//
private:
char _dummy;
#endif
};
}
#endif
|
