poco/Foundation/include/Poco/TaskNotification.h

173 lines
3.2 KiB
C
Raw Normal View History

2012-04-29 20:52:25 +02:00
//
// TaskNotification.h
//
// $Id: //poco/1.4/Foundation/include/Poco/TaskNotification.h#1 $
//
// Library: Foundation
// Package: Tasks
// Module: Tasks
//
// Definition of the TaskNotification class.
//
// Copyright (c) 2004-2006, Applied Informatics Software Engineering GmbH.
// and Contributors.
//
// SPDX-License-Identifier: BSL-1.0
2012-04-29 20:52:25 +02:00
//
#ifndef Foundation_TaskNotification_INCLUDED
#define Foundation_TaskNotification_INCLUDED
#include "Poco/Foundation.h"
#include "Poco/Notification.h"
#include "Poco/Task.h"
namespace Poco {
class Foundation_API TaskNotification: public Notification
/// Base class for TaskManager notifications.
{
public:
TaskNotification(Task* pTask);
/// Creates the TaskNotification.
Task* task() const;
/// Returns the subject of the notification.
protected:
virtual ~TaskNotification();
/// Destroys the TaskNotification.
private:
Task* _pTask;
};
class Foundation_API TaskStartedNotification: public TaskNotification
/// This notification is posted by the TaskManager for
/// every task that has been started.
{
public:
TaskStartedNotification(Task* pTask);
protected:
~TaskStartedNotification();
};
class Foundation_API TaskCancelledNotification: public TaskNotification
/// This notification is posted by the TaskManager for
/// every task that has been cancelled.
{
public:
TaskCancelledNotification(Task* pTask);
protected:
~TaskCancelledNotification();
};
class Foundation_API TaskFinishedNotification: public TaskNotification
/// This notification is posted by the TaskManager for
/// every task that has finished.
{
public:
TaskFinishedNotification(Task* pTask);
protected:
~TaskFinishedNotification();
};
class Foundation_API TaskFailedNotification: public TaskNotification
/// This notification is posted by the TaskManager for
/// every task that has failed with an exception.
{
public:
TaskFailedNotification(Task* pTask, const Exception& exc);
const Exception& reason() const;
protected:
~TaskFailedNotification();
private:
Exception* _pException;
};
class Foundation_API TaskProgressNotification: public TaskNotification
/// This notification is posted by the TaskManager for
/// every task that has failed with an exception.
{
public:
TaskProgressNotification(Task* pTask, float progress);
float progress() const;
protected:
~TaskProgressNotification();
private:
float _progress;
};
template <class C>
class TaskCustomNotification: public TaskNotification
/// This is a template for "custom" notification.
/// Unlike other notifications, this notification
/// is instantiated and posted by the task itself.
2015-04-10 12:31:12 +02:00
/// The purpose is to provide generic notification
2012-04-29 20:52:25 +02:00
/// mechanism between the task and its observer(s).
{
public:
TaskCustomNotification(Task* pTask, const C& rCustom):
2012-04-29 20:52:25 +02:00
TaskNotification(pTask),
_custom(rCustom)
2012-04-29 20:52:25 +02:00
{
}
const C& custom() const
{
return _custom;
}
protected:
~TaskCustomNotification(){};
private:
C _custom;
};
//
// inlines
//
inline Task* TaskNotification::task() const
{
return _pTask;
}
inline const Exception& TaskFailedNotification::reason() const
{
return *_pException;
}
inline float TaskProgressNotification::progress() const
{
return _progress;
}
} // namespace Poco
#endif // Foundation_TaskNotification_INCLUDED