RefHandle.h

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

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

#ifndef CNTM_REFHANDLE_H
#define CNTM_REFHANDLE_H
#include <Cntm/RefUtils/Internal/RefHandleRefImplementation.h>
#include <Cntm/RefUtils/Internal/BasicRefHandle.h>

namespace Cntm
{
        
        /**
         * Механизм хэндлов предназначен для автоматизации вызова определенного метода объекта при уничтожении последнего хэндла, связанного с объектом.
         * 
         * Данный класс является шаблоном, первым параметром которого является тип объекта, а вторым - указатель на метод объекта, который следует вызвать. Метод должен иметь сигнатуру void(void), т.е. ничего не принимать и не возвращать.
         * 
         * Указанный в шаблоне метод может вызываться многократно. Это происходит, если после уничтожения всех хэндлов, связанных с объектом и вызова указанного метода, вновь будут созданы хэндлы, связанные с объектом.
         * 
         * Пример использования приведен в SynchroRefBase.
         * 
         * Класс обеспечивает многопоточность.
         * \ingroup RefUtils
         * @author Овсеевич Р. 
         */
        template < typename T, void (T::*FinalizeP)()>
        class RefHandle: public SpecUtils::BasicRefHandle < T, SpecUtils::RefHandleRefImplementation >
        {
        public:
        
                /**
                 * Конструктор по умолчанию. Создает хэндл, не связанный ни с каким объектом. 
                 */
                RefHandle(): 
                        SpecUtils::BasicRefHandle<T, SpecUtils::RefHandleRefImplementation>(RefPtr<T>::Null(), &RefHandle::Finalize) {}
                
                /**
                 * Конструктор. Создает хэндл, связанный с указанным объектом. 
                 */
                RefHandle(RefPtr<T> Object): 
                        SpecUtils::BasicRefHandle<T, SpecUtils::RefHandleRefImplementation>(Object, &RefHandle::Finalize) {}
                
                /**
                 * Связывает хэндл с новым объектом. 
                 */
                RefHandle < T, FinalizeP > & operator = (RefPtr<T> Object)
                {
                        Assign(Object);
                        return *this;
                }
                
                /**
                 * Связывает хэндл с новым объектом. 
                 */
                void Assign(RefPtr<T> Object)
                {
                        SpecUtils::BasicRefHandle<T, SpecUtils::RefHandleRefImplementation>::
				Assign(Object, &RefHandle::Finalize);
                }
        
                /**
                 * Делает хэндл не связанным. 
                 */
                void Unassign()
                {
                        Assign(RefPtr<T>::Null());
                }
                
        private:
        
                /**
                 * Вызывает указанный метод объекта. 
                 */
                static void Finalize(RefPtr<T> HandledObject) { (HandledObject.Pointer()->*FinalizeP)(); }
        };

}

#endif //CNTM_REFHANDLE_H

---