Шаблон класса Cntm::SynchroRefHandleFn< T, FinalizeP >
[Cntm.RefUtils]

Граф наследования:Cntm::SynchroRefHandleFn< T, FinalizeP >:

Подробное описание

template<typename T, void(*)(RefPtr< T >) FinalizeP>
class Cntm::SynchroRefHandleFn< T, FinalizeP >

Механизм хэндлов предназначен для автоматизации вызова определенного метода объекта при уничтожении последнего хэндла, связанного с объектом.

Отличием данного класса от SynchroRefHandle является то, что задается не метод, а функция, принимающая ссылочный указатель на класс в качестве параметра.

Данный класс является шаблоном, первым параметром которого является тип объекта, а вторым - указатель на функцию, которую следует вызвать. Функция должна иметь сигнатуру void(RefPtr<T>). При вызове данной функции гарантируется, что переданный указатель никогда не будет содержать NULL значения.

Указанный в шаблоне метод может вызываться многократно. Это происходит, если после уничтожения всех хэндлов, связанных с объектом и вызова указанного метода, вновь будут созданы хэндлы, связанные с объектом.

Отличием данного класса от RefHandleFn является то, что гарантируется синхронизированный отложенный вызов указанного в шаблоне метода. Это приводит к тому, что объект, с которым связан хэндл, может быть только синхрообъектом.

Особенность вызова указанной в шаблоне функции. Если после того, как будет уничтожен последний хэндл, связанный с объектом, но до выполнения функции (она вызывается отложенно) создать новый хэндл, связанный с объектом, внутри синхропространства, к которому принадлежит объект, то гарантируется, что вызов функции будет отменен.

Пример:

 class Class1: public SynchroRefBase
 {
 private:
        static void AutoClose(RefPtr<Class1> p) {...}
 public:
        typedef RefPtr<Class1> Ptr;
        typedef SynchroRefHandleFn<Class1, &Class1::AutoClose> Handle;
 };
 
 int main(int argc, char **argv)
 {
        Cntm::QTMainSynchroSpace::Application a(argc, argv);
 
        mw = new Form1();
        mw->setCaption( "Form1" );
        mw->show();
        a.connect( &a, SIGNAL(lastWindowClosed()), &a, SLOT(quit()) );
        
        Class1::Ptr p(new Class1);
 
        if (Какое-то условие)
        {
                Class1::Handle h1 = p;
                Какието-действия с объектом p.
        } // Гарантируется вызов метода Close() для объекта p после уничтожения хэндла, связанного с ним.
        a.exec();
 }

Класс обеспечивает многопоточность.

Автор:: Овсеевич Р.

См. определение в файле SynchroRefHandleFn.h строка 72


Открытые члены
	SynchroRefHandleFn ()
	Конструктор по умолчанию.
	SynchroRefHandleFn (RefPtr< T > Object)
	Конструктор.
SynchroRefHandleFn < T, FinalizeP > &	operator= (RefPtr< T > Object)
	Связывает хэндл с новым объектом.
void	Assign (RefPtr< T > Object)
	Связывает хэндл с новым объектом.
void	Unassign ()
	Делает хэндл не связанным.