ExtraSynchroSpace.h

См. документацию.

/*
 * CntmLib - Подсчет ссылок, потоки, синхронизация, асинхронные процедуры, события
 * Copyright (c) 2005, Овсеевич Роман, CntmLib@mail.ru
 * _______________________________________________________________________________
 * Разрешено свободное использование, копирование, распространение, изменение
 * (изменение сведений об авторских правах запрещено). Запрещена продажа и 
 * включение всей библиотеки или ее частей в другие библиотеки. В сведениях об
 * авторских правах на программу (или сведениях о программе, об авторах, 
 * использованных средствах разработки и т.д.) должна быть указана информация
 * о библиотеке CntmLib, ее авторе и, возможно, сайте или email'е.
 * Библиотека поставляется "как есть", без каких-либо гарантий со стороны автора.
 */ 

#ifndef CNTM_EXTRASYNCHROSPACE_H
#define CNTM_EXTRASYNCHROSPACE_H
#include <Cntm/Synchro/SynchroSpace.h>
#include <Cntm/SystemUtils/SysCriticalSection.h>
#include <Cntm/SystemUtils/SysThread.h>

namespace Cntm
{

        /**
         * Класс дополнительного синхропространства. Описание понятия синхропространства приведено в SynchroSpace.
         * 
         * Для обработки синхронных задач используются потоки выполнения, отличные от главного потока.
         * 
         * Замечание по реентерабельности. Поскольку реентерабельный вход в данный тип синхропространства невозможен (т.к. отстутствует команда на немедленный запуск выполнения синхронных заданий), то разница между реентерабельным и не реентерабельным режимами отсутствует.
         * @author Овсеевич Р. 
         * \ingroup Synchro
         */
        class ExtraSynchroSpace: public SynchroSpace
        {
        public:
        
                typedef RefPtr<ExtraSynchroSpace> Ptr;

                /**
                 * Конструктор по умолчанию.
                 */
                ExtraSynchroSpace(): SynchroSpace(), mainSpace(Main()) {}
                
                /**
                 * Добавить новую задачу в конец очереди. Объект задачи д.б. создан в динамической памяти. После выполнения задача автоматически будет удалена. Класс объекта задачи д.б. унаследован от Cntm:: SynchroSpace:: TaskBase.
                 * 
                 * Подробнее о синхрозадачах см. описание класса SynchroSpace и SynchroSpace::TaskBase.
                 * 
                 * Система гарантирует, что задача будет выполнена в контексте главного потока синхронно с прочими событиями библиотеки QT.
                 * 
                 * \throw NullArgException если не указана задача.
                 */
                void AddSynchroTask(TaskBase* Task);
        
        protected:

                /**
                 * Выполнить вход в критическую секцию, связанную с синхропространством. Вызывает QApplication::lock(). 
                 */
                void DoEnter() { critSection.Enter(); }

                /**
                 * Выполнить вход в критическую секцию, связанную с синхропространством. Вызывает QApplication::tryLock().
                 */
                bool DoTryEnter() { return critSection.TryEnter(); }

                /**
                 * Выполнить вход в критическую секцию, связанную с синхропространством. Вызывает QApplication::unlock().
                 */
                void DoLeave() { critSection.Leave(); }
        
        private:

                /**
                 * Критическая секция данного синхропространства.
                 */
                SpecUtils::SysCriticalSection critSection;
                
                /**
                 * Указатель на себя, чтобы хранить ссылку на время работы потока, который обрабатывает синхронные задачи.
                 */
                Ptr holdInstance;
                
                /**
                 * Очередь синхронных задач.
                 */
                TaskQueue taskQueue;

                /**
                 * Ссылка на главное синхропространство. Хранится, что бы главное синхропространство умерло последним, что гарантирует незавершение программы, пока хотя бы одно дополнитнльное синхропространство живо.
                 */
                SynchroSpace::Ptr mainSpace;
                
                /**
                 * Поток обработки задач.
                 */
                static SpecUtils::SysThread::ResultType CNTM_SYSTHREAD_PROC_DECL TaskThread(void* Arg);
        };

}

#endif //CNTM_EXTRASYNCHROSPACE_H

---