generic-library/poco
1
0
Fork 0
mirror of https://github.com/pocoproject/poco.git synced 2025-10-28 19:51:58 +01:00
Code Issues Projects Releases Wiki Activity

feat(ServerApplication): termination callback #4643 (#4733)

Browse Source 
* feat(ServerApplication): termination callback #4643

* chore(ServerApplication): spelling fix #4643

* chore(ServerApplication): correct documentation #4643
This commit is contained in:
Aleksandar Fabijanic
2024-10-15 10:49:28 -05:00
committed by GitHub
parent 71a085c1dc
commit f0a29487b6
2 changed files with 49 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

24
Util/include/Poco/Util/ServerApplication.h
View File

@@ -24,6 +24,7 @@
#if defined(POCO_OS_FAMILY_WINDOWS)
#include "Poco/NamedEvent.h"
#endif
#include <functional>
namespace Poco {
@@ -122,8 +123,20 @@ class Util_API ServerApplication: public Application
/// --pidfile=/var/run/sample.pid) may be useful to record the process ID of
/// the daemon in a file. The PID file will be removed when the daemon process
/// terminates (but not, if it crashes).
///
/// An application can register a callback to be called at termination time.
/// An example of the termination callback registration at some point
/// during the ServerApplication initialization time:
///
/// auto tCB = [](const std::string& message)
/// {
/// std::cout << message << std::endl;
/// };
/// ServerApplication::registerTerminateCallback(tCB, "custom termination message"s);
{
public:
using TerminateCallback = std::function<void(const std::string&)>;
ServerApplication();
/// Creates the ServerApplication.
@@ -158,6 +171,12 @@ public:
/// waitForTerminationRequest(), this method will return
/// and the application can shut down.
static void registerTerminateCallback(TerminateCallback tCB,
const std::string& message = _terminateMessage);
/// Registers a termination callback.
/// Used to register a function to be executed when the system
/// shutdown starts.
protected:
int run();
void waitForTerminationRequest();
@@ -207,6 +226,11 @@ private:
static SERVICE_STATUS_HANDLE _serviceStatusHandle;
static Poco::NamedEvent _terminate;
#endif
static void terminateCallback();
inline static std::atomic<bool> _terminationGuard = false;
inline static TerminateCallback _terminateCallback = nullptr;
inline static std::string _terminateMessage = "System terminating now!";
};