ActiveSynchroRefBaseEx.h

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

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

#ifndef CNTM_ACTIVESYNCHROREFBASEEX_H
#define CNTM_ACTIVESYNCHROREFBASEEX_H
#include <Cntm/Synchro/SynchroRefBaseEx.h>
#include <Cntm/ActiveObjects/ActiveObject.h>

namespace Cntm
{

        /**
         * Базовый класс для активных объектов. Объединяет средства работы с потоками, предоставляемые классом Cntm::ActiveObject, синхронизации и расширенного подсчета ссылок, предоставляемые классом Cntm::SynchroRefBase. См. описания базовых классов, а также класса Cntm::SynchroSpace.
         * 
         * Данный класс обеспечивает многопоточность.
         * @author Овсеевич Р.
         * \ingroup ActiveObjects
         */
        class ActiveSynchroRefBaseEx: public SynchroRefBaseEx, public ActiveObject
        {
        protected:
                        
                /**
                 * Конструктор используется, когда операция создания синхрообъекта уже выполняется внутри пространства, к которому будет принадлежать новый объект. Если синхропространство не указано, то будет использовано главное синхропространство (т.о. если в программе используется только главное синхропространство, то нет необходимости указывать его явно).
                 * 
                 * @param Space - (опционально) используется для задания синхропространства, к которому будет принадлежать создаваемый объект.
                 * 
                 * Исключение Cntm::IllegalStateException - если синхропространство явно не указано, а главное синхропространство отсутствует
                 */
                ActiveSynchroRefBaseEx(const SynchroSpace::Ptr& Space = Cntm::SynchroSpace::Ptr()):
                        SynchroRefBaseEx(Space) {}
                
                /**
                 * Конструктор используется, когда объект создается в новом или просто другом синхропространстве. В этом случае конструктор синхрообъекта пытается извлечь синхропространство из ConstructSync и если ConstructSync был проинициализирован, то использует извлеченное синхропространство. Если был указан пустой ConstructSync, то первым делом конструктор синхрообъекта создает дополнительное синхропространство (класс Cntm::ExtraSynchroSpace) и присваивает его ConstructSync (который передан по ссылке). Т.о. работа конструктора SynchroObject и конструкторов производных классов всегда будет осуществляться внутри синхпространства данного объекта.
                 * 
                 * @param ConstructSync - ссылка на синхросекцию, которая обеспечивает нахождение в синхропространстве при создании объекта.
                 */
                ActiveSynchroRefBaseEx(Sync& ConstructSync):
                        SynchroRefBaseEx(ConstructSync) {}
                
                /**
                 * Конструктор используется, когда объект создается в новом или просто другом синхропространстве. В этом случае конструктор синхрообъекта пытается извлечь синхропространство из ConstructSync и если ConstructSync был проинициализирован, то использует извлеченное синхропространство. Если был указан пустой ConstructSync, то первым делом конструктор синхрообъекта создает дополнительное синхропространство (класс Cntm::ExtraSynchroSpace) и присваивает его ConstructSync (который передан по ссылке). Т.о. работа конструктора SynchroObject и конструкторов производных классов всегда будет осуществляться внутри синхпространства данного объекта.
                 * 
                 * @param ConstructSync - ссылка на реентерабельную синхросекцию, которая обеспечивает нахождение в синхропространстве при создании объекта.
                 */
                ActiveSynchroRefBaseEx(ReentrantSync& ConstructSync):
                        SynchroRefBaseEx(ConstructSync) {}

        /**
         * Реализация IRefObject::DeleteInstance. Является служебным методом. Уничтожает объект.
         */
                void DeleteInstance() { TerminateAllThreads(); }
                
        private:
        
                /**
                 * Виртуальный метод. Вызывается когда все потоки завершились. В свою очередь вызывает метод DeleteInstance() базового класса. 
                 */
                void AllThreadsFinished() { SynchroRefBaseEx::DeleteInstance(); }
        };

}

#endif //CNTM_ACTIVESYNCHROREFBASEEX_H

---