TAO_CEC_ProxyPushConsumer_Guard Class Reference

A Guard for the ProxyPushConsumer reference count. More...

#include <CEC_ProxyPushConsumer.h>

Collaboration diagram for TAO_CEC_ProxyPushConsumer_Guard:

[legend]List of all members.

Public Member Functions
	TAO_CEC_ProxyPushConsumer_Guard (ACE_Lock *lock, CORBA::ULong &refcount, TAO_CEC_EventChannel *ec, TAO_CEC_ProxyPushConsumer *proxy)
	Constructor.
	~TAO_CEC_ProxyPushConsumer_Guard (void)
	Destructor.
bool	locked (void) const
	Returns true if the reference count successfully acquired.
Private Attributes
ACE_Lock *	lock_
	The lock used to protect the reference count.
CORBA::ULong &	refcount_
	The reference count.
TAO_CEC_EventChannel *	event_channel_
	The event channel used to destroy the proxy.
TAO_CEC_ProxyPushConsumer *	proxy_
	The proxy whose lifetime is controlled by the reference count.
bool	locked_

---

Detailed Description

A Guard for the ProxyPushConsumer reference count.

This is a helper class used in the implementation of ProxyPushConumer. It provides a Guard mechanism to increment the reference count on the proxy, eliminating the need to hold mutexes during long operations.

Definition at line 159 of file CEC_ProxyPushConsumer.h.

---

Constructor & Destructor Documentation

TAO_CEC_ProxyPushConsumer_Guard::TAO_CEC_ProxyPushConsumer_Guard	(	ACE_Lock *	lock,
		CORBA::ULong &	refcount,
		TAO_CEC_EventChannel *	ec,
		TAO_CEC_ProxyPushConsumer *	proxy
	)

Constructor.

Definition at line 317 of file CEC_ProxyPushConsumer.cpp.

References TAO_CEC_ProxyPushConsumer::is_connected_i(), locked_, and refcount_.

 :   lock_ (lock),
     refcount_ (refcount),
     event_channel_ (ec),
     proxy_ (proxy),
     locked_ (false)
{
  ACE_Guard<ACE_Lock> ace_mon (*this->lock_);
  // If the guard fails there is not much we can do, raising an
  // exception is wrong, the client has *no* way to handle that kind
  // of error.  Even worse, there is no exception to raise in that
  // case.
  // @@ Returning something won't work either, the error should be
  // logged though!

  if (!proxy->is_connected_i ())
    return;

  this->locked_ = true;
  ++this->refcount_;
}

TAO_CEC_ProxyPushConsumer_Guard::~TAO_CEC_ProxyPushConsumer_Guard

(

void

)

Destructor.

Definition at line 343 of file CEC_ProxyPushConsumer.cpp.

References TAO_CEC_EventChannel::destroy_proxy(), event_channel_, and refcount_.

{
  // This access is safe because guard objects are created on the
  // stack, only one thread has access to them
  if (!this->locked_)
    return;

  {
    ACE_Guard<ACE_Lock> ace_mon (*this->lock_);
    // If the guard fails there is not much we can do, raising an
    // exception is wrong, the client has *no* way to handle that kind
    // of error.  Even worse, there is no exception to raise in that
    // case.
    // @@ Returning something won't work either, the error should be
    // logged though!

    --this->refcount_;
    if (this->refcount_ != 0)
      return;
  }
  this->event_channel_->destroy_proxy (this->proxy_);
}

---

Member Function Documentation

ACE_INLINE bool TAO_CEC_ProxyPushConsumer_Guard::locked

(

void

)

const

Returns true if the reference count successfully acquired.

Definition at line 45 of file CEC_ProxyPushConsumer.inl.

References locked_.

Referenced by TAO_CEC_ProxyPushConsumer::push().

{
  return this->locked_;
}

---

Member Data Documentation

TAO_CEC_EventChannel* TAO_CEC_ProxyPushConsumer_Guard::event_channel_ [private]

The event channel used to destroy the proxy.

Definition at line 182 of file CEC_ProxyPushConsumer.h.

Referenced by ~TAO_CEC_ProxyPushConsumer_Guard().

ACE_Lock* TAO_CEC_ProxyPushConsumer_Guard::lock_ [private]

The lock used to protect the reference count.

Definition at line 176 of file CEC_ProxyPushConsumer.h.

bool TAO_CEC_ProxyPushConsumer_Guard::locked_ [private]

This flag is set to true if the reference count was successfully acquired.

Definition at line 189 of file CEC_ProxyPushConsumer.h.

Referenced by locked(), and TAO_CEC_ProxyPushConsumer_Guard().

TAO_CEC_ProxyPushConsumer* TAO_CEC_ProxyPushConsumer_Guard::proxy_ [private]

The proxy whose lifetime is controlled by the reference count.

Definition at line 185 of file CEC_ProxyPushConsumer.h.

CORBA::ULong& TAO_CEC_ProxyPushConsumer_Guard::refcount_ [private]

The reference count.

Definition at line 179 of file CEC_ProxyPushConsumer.h.

Referenced by TAO_CEC_ProxyPushConsumer_Guard(), and ~TAO_CEC_ProxyPushConsumer_Guard().

---

The documentation for this class was generated from the following files:

• CEC_ProxyPushConsumer.h
• CEC_ProxyPushConsumer.cpp
• CEC_ProxyPushConsumer.inl

---