SynchroRefBaseEx.h

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

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

#ifndef CNTM_SYNCHROREFBASEEX_H
#define CNTM_SYNCHROREFBASEEX_H
#include <Cntm/RefCount/RefBaseEx.h>
#include <Cntm/Synchro/SynchroObject.h>
#include <Cntm/Synchro/SyncScopes/Sync.h>
#include <Cntm/Synchro/SyncScopes/ReentrantSync.h>

namespace Cntm
{

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

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

}

#endif //CNTM_SYNCHROREFBASEEX_H

---