96 lines
4.2 KiB
C++
96 lines
4.2 KiB
C++
//! \~\file pisingleapplication.h
|
|
//! \~\ingroup Application
|
|
//! \~\brief
|
|
//! \~english Single-instance application control
|
|
//! \~russian Контроль одного экземпляра приложения
|
|
/*
|
|
PIP - Platform Independent Primitives
|
|
Single application
|
|
Ivan Pelipenko peri4ko@yandex.ru
|
|
|
|
This program is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU Lesser General Public License as published by
|
|
the Free Software Foundation, either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU Lesser General Public License for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public License
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef PISINGLEAPPLICATION_H
|
|
#define PISINGLEAPPLICATION_H
|
|
|
|
#include "pithread.h"
|
|
|
|
class PISharedMemory;
|
|
|
|
//! \~\ingroup Application
|
|
//! \~\brief
|
|
//! \~english Single-instance application control.
|
|
//! \~russian Контроль одного экземпляра приложения.
|
|
//! \~\details
|
|
//! \~english The PISingleApplication class provides single-instance application control. It allows detecting if the current application
|
|
//! instance is the first one launched and enables inter-process communication between multiple instances. Multiple instances with the same
|
|
//! "app_name" can detect each other and communicate. The first instance becomes the server, receiving messages from subsequent instances.
|
|
//! \~russian Класс PISingleApplication предоставляет контроль одного экземпляра приложения. Он позволяет определить, является ли текущий
|
|
//! экземпляр первым запущенным, и обеспечивает межпроцессное взаимодействие между несколькими экземплярами. Несколько экземпляров с
|
|
//! одинаковым "app_name" могут обнаруживать друг друга и обмениваться сообщениями. Первый экземпляр становится сервером, принимающим
|
|
//! сообщения от последующих экземпляров.
|
|
|
|
class PIP_EXPORT PISingleApplication: public PIThread {
|
|
PIOBJECT_SUBCLASS(PISingleApplication, PIThread);
|
|
|
|
public:
|
|
//! \~english Constructs %PISingleApplication for application name "app_name".
|
|
//! \~russian Создает %PISingleApplication для имени приложения "app_name".
|
|
PISingleApplication(const PIString & app_name = PIString());
|
|
|
|
//! \~english Stops instance monitoring and releases shared resources.
|
|
//! \~russian Останавливает мониторинг экземпляра и освобождает общие ресурсы.
|
|
~PISingleApplication();
|
|
|
|
|
|
//! \~english Returns whether this process is the first launched instance.
|
|
//! \~russian Возвращает, является ли этот процесс первым запущенным экземпляром.
|
|
bool isFirst() const;
|
|
|
|
//! \handlers
|
|
//! \{
|
|
|
|
//! \fn void sendMessage(const PIByteArray & m)
|
|
//! \brief
|
|
//! \~english Sends message "m" to the first launched application instance
|
|
//! \~russian Посылает сообщение "m" первому запущенному экземпляру приложения
|
|
EVENT_HANDLER1(void, sendMessage, const PIByteArray &, m);
|
|
|
|
//! \}
|
|
//! \events
|
|
//! \{
|
|
|
|
//! \fn void messageReceived(PIByteArray m)
|
|
//! \brief
|
|
//! \~english Emitted by the first launched application when receiving a message from another instance
|
|
//! \~russian Вызывается первым запущенным приложением при получении сообщения от другого экземпляра
|
|
EVENT1(messageReceived, PIByteArray, m);
|
|
|
|
//! \}
|
|
|
|
private:
|
|
void begin() override;
|
|
void run() override;
|
|
void waitFirst() const;
|
|
|
|
PISharedMemory * shm;
|
|
PITimeMeasurer ftm;
|
|
PIByteArray readed;
|
|
bool first, started;
|
|
int sacnt;
|
|
};
|
|
|
|
#endif // PISINGLEAPPLICATION_H
|