TAO_CEC_TypedProxyPushConsumer_Guard Class Reference

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

#include <CEC_TypedProxyPushConsumer.h>

Collaboration diagram for TAO_CEC_TypedProxyPushConsumer_Guard:

[legend]List of all members.

Public Member Functions
	TAO_CEC_TypedProxyPushConsumer_Guard (ACE_Lock *lock, CORBA::ULong &refcount, TAO_CEC_TypedEventChannel *ec, TAO_CEC_TypedProxyPushConsumer *proxy)
	Constructor.
	~TAO_CEC_TypedProxyPushConsumer_Guard (void)
	Destructor.
int	locked (void) const
	Returns 1 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_TypedEventChannel *	typed_event_channel_
	The event channel used to destroy the proxy.
TAO_CEC_TypedProxyPushConsumer *	proxy_
	The proxy whose lifetime is controlled by the reference count.
int	locked_

---

Detailed Description

A Guard for the TypedProxyPushConsumer reference count.

This is a helper class used in the implementation of TypedProxyPushConumer. 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 153 of file CEC_TypedProxyPushConsumer.h.

---

Constructor & Destructor Documentation

TAO_CEC_TypedProxyPushConsumer_Guard::TAO_CEC_TypedProxyPushConsumer_Guard	(	ACE_Lock *	lock,
		CORBA::ULong &	refcount,
		TAO_CEC_TypedEventChannel *	ec,
		TAO_CEC_TypedProxyPushConsumer *	proxy
	)

Constructor.

Definition at line 361 of file CEC_TypedProxyPushConsumer.cpp.

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

 :   lock_ (lock),
     refcount_ (refcount),
     typed_event_channel_ (ec),
     proxy_ (proxy),
     locked_ (0)
{
  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 () == 0)
    return;

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

TAO_CEC_TypedProxyPushConsumer_Guard::~TAO_CEC_TypedProxyPushConsumer_Guard

(

void

)

Destructor.

Definition at line 387 of file CEC_TypedProxyPushConsumer.cpp.

References TAO_CEC_TypedEventChannel::destroy_proxy(), refcount_, and typed_event_channel_.

{
  // 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->typed_event_channel_->destroy_proxy (this->proxy_);
}

---

Member Function Documentation

ACE_INLINE int TAO_CEC_TypedProxyPushConsumer_Guard::locked

(

void

)

const

Returns 1 if the reference count successfully acquired.

Definition at line 16 of file CEC_TypedProxyPushConsumer.inl.

References locked_.

Referenced by TAO_CEC_TypedProxyPushConsumer::invoke().

{
  return this->locked_;
}

---

Member Data Documentation

ACE_Lock* TAO_CEC_TypedProxyPushConsumer_Guard::lock_ [private]

The lock used to protect the reference count.

Definition at line 172 of file CEC_TypedProxyPushConsumer.h.

int TAO_CEC_TypedProxyPushConsumer_Guard::locked_ [private]

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

Definition at line 185 of file CEC_TypedProxyPushConsumer.h.

Referenced by locked(), and TAO_CEC_TypedProxyPushConsumer_Guard().

TAO_CEC_TypedProxyPushConsumer* TAO_CEC_TypedProxyPushConsumer_Guard::proxy_ [private]

The proxy whose lifetime is controlled by the reference count.

Definition at line 181 of file CEC_TypedProxyPushConsumer.h.

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

The reference count.

Definition at line 175 of file CEC_TypedProxyPushConsumer.h.

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

TAO_CEC_TypedEventChannel* TAO_CEC_TypedProxyPushConsumer_Guard::typed_event_channel_ [private]

The event channel used to destroy the proxy.

Definition at line 178 of file CEC_TypedProxyPushConsumer.h.

Referenced by ~TAO_CEC_TypedProxyPushConsumer_Guard().

---

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

• CEC_TypedProxyPushConsumer.h
• CEC_TypedProxyPushConsumer.cpp
• CEC_TypedProxyPushConsumer.inl

---