AggregatedBase.h

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

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

#ifndef CNTM_AGGREGATEDBASE_H
#define CNTM_AGGREGATEDBASE_H
#include <Cntm/Exceptions/NullArgException.h>
#include <Cntm/RefCount/IRefObject.h>

namespace Cntm
{

        /**
         * Базовый класс для объектов, являющихся составными частями агрегата (агрегированных объектов). Время жизни агрегированных объектов в точности совпадает с временем жизни агрегата, т.к. агрегат непосредственно обеспечивает создание и уничтожение агрегированных объектов.
         * 
         * Основная задача класса: при создании ссылки на агрегированный объект косвенно увеличивать кол-во ссылок на агрегата, а при потере - уменьшать. Т.о. агрегат будет существовать, пока есть ссылки на него или на его агрегированные объекты.
         * 
         * Аггрегированные объекты могут быть полями класса-агрегата или создаваться в динамической памяти. В последнем случае для доступа к агрегированному объекту следует использовать обычный указатель, т.к. использование ссылочного приведет к созданию косвенной ссылки на себя.
         * 
         * Данный класс обеспечивает многопоточность.
         * @author Овсеевич Р.
         * \ingroup RefCount
         */
        class AggregatedBase : virtual public IRefObject
        {
        protected:

                /**
                 * Конструктор.
                 * 
                 * Исключение: NullArgException если аргумент Aggregate равен NULL.
                 */
                AggregatedBase(IRefObject* Aggregate);

                /**
                 * Виртуальный деструктор.
                 */
                virtual ~AggregatedBase() {}
                
        private:

                /**
                 * Указатель на агрегат.
                 */
                IRefObject* aggregate;

                /**
                 * Реализация IRefObject::IncRefCount.
                 * 
                 * Увеличить кол-во ссылок. Возвращает true, если объект не находится в удаляемом состоянии и кол-во ссылок увеличено, иначе возвращается false.
                 * 
                 * Вызывает соответствующий метод агрегата.
                 */
                bool IncRefCount();
                
                /**
                 * Реализация IRefObject::DecRefCount.
                 * 
                 * Уменьшить кол-во ссылок. Если счетчик ссылок достиг 0, то возвращается true, иначе возвращается false.
                 * 
                 * Вызывает соответствующий метод агрегата.
                 */
                bool DecRefCount();

                /**
                 * Реализация IRefObject::IncRefCount.
                 * 
                 * Уничтожает объект.
                 * 
                 * Вызывает соответствующий метод агрегата. 
                 */
                void DeleteInstance();
        };

}

#endif //CNTM_AGGREGATEDBASE_H

---