#include <Refcountable.h>
Public Types | |
typedef TAO_Notify_Refcountable_Guard_T < TAO_Notify_Refcountable > | Ptr |
Public Member Functions | |
TAO_Notify_Refcountable (void) | |
Constructor. | |
virtual | ~TAO_Notify_Refcountable () |
CORBA::ULong | _incr_refcnt (void) |
CORBA::ULong | _decr_refcnt (void) |
Private Member Functions | |
virtual void | release (void)=0 |
The release method is called when the refcount reaches 0. | |
Private Attributes | |
ACE_Atomic_Op< TAO_SYNCH_MUTEX, CORBA::Long > | refcount_ |
The refcount is initialized to 0. When an instance of a derived class becomes owned by a managed pointer (Refcountable_Guard_T) the reference count becomes non-zero.
Instances declared on the stack should always have a refcount of zero.
A method that creates or simply returns an instance of Refcountable should not increment the reference count. It is the responsibility of the client to increment the reference count (take ownership or guard against deletion). The client cannot know if the method will or will not incr the refcount on its behalf.
Use Refcountable_Guard_T or similar service to guarantee the exception safe direct pairing of increments and decrements. Avoid calling _incr_refcnt and _decr_refcnt.
Reimplemented in TAO_Notify_ConsumerAdmin, TAO_Notify_Event, TAO_Notify_Event_Manager, TAO_Notify_EventChannel, TAO_Notify_EventChannelFactory, TAO_Notify_Proxy, TAO_Notify_ProxyConsumer, TAO_Notify_ProxySupplier, TAO_Notify_SupplierAdmin, TAO_Notify_Timer, TAO_Notify_Timer_Queue, TAO_Notify_Timer_Reactor, and TAO_Notify_Worker_Task.
TAO_Notify_Refcountable::TAO_Notify_Refcountable | ( | void | ) |
Constructor.
TAO_Notify_Refcountable::~TAO_Notify_Refcountable | ( | ) | [virtual] |
Destructor public for stack allocated instances
CORBA::ULong TAO_Notify_Refcountable::_incr_refcnt | ( | void | ) |
This method sigantures deliberately match the RefCounting methods required for ESF Proxy Public for bridge implementations and various guard classes
CORBA::ULong TAO_Notify_Refcountable::_decr_refcnt | ( | void | ) |
virtual void TAO_Notify_Refcountable::release | ( | void | ) | [private, pure virtual] |
The release method is called when the refcount reaches 0.
Implemented in TAO_Notify_ConsumerAdmin, TAO_Notify_Event, TAO_Notify_Event_Manager, TAO_Notify_EventChannel, TAO_Notify_EventChannelFactory, TAO_Notify_EventTypeSeq, TAO_Notify_FilterAdmin, TAO_Notify_Reactive_Task, TAO_Notify::Reconnection_Registry, TAO_Notify_SupplierAdmin, TAO_Notify_ThreadPool_Task, TAO_Notify_Timer_Queue, TAO_Notify_Timer_Reactor, TAO_Notify_CosEC_ProxyPushConsumer, TAO_Notify_CosEC_ProxyPushSupplier, TAO_Notify_ProxyPushConsumer, TAO_Notify_ProxyPushSupplier, TAO_Notify_SequenceProxyPushConsumer, TAO_Notify_SequenceProxyPushSupplier, TAO_Notify_StructuredProxyPushConsumer, and TAO_Notify_StructuredProxyPushSupplier.
ACE_Atomic_Op<TAO_SYNCH_MUTEX, CORBA::Long> TAO_Notify_Refcountable::refcount_ [private] |