---

ACE_Dev_Poll_Handler_Guard Class Reference

Class used to make event handler reference count manipulation exception-safe. More...

#include <Dev_Poll_Reactor.h>

Collaboration diagram for ACE_Dev_Poll_Handler_Guard:

[legend]List of all members.

Public Methods
	ACE_Dev_Poll_Handler_Guard (ACE_Dev_Poll_Reactor_Handler_Repository &repository, ACE_HANDLE handle)
	Constructor. More...
	~ACE_Dev_Poll_Handler_Guard (void)
	Destructor. More...
Private Attributes
ACE_Dev_Poll_Reactor_Handler_Repository &	repository_
	Reference to the handler repository containing the event handler used during the upcall. More...
ACE_HANDLE	handle_
	Handle corresponding to the event being dispatched. More...

---

Detailed Description

Class used to make event handler reference count manipulation exception-safe.

This class makes the reference count manipulation that occurs during an upcall exception-safe. Prior to dispatching the event handler, the reference count is increased. Once the upcall for the given event handler is complete, its reference count will be decreased.

Definition at line 1135 of file Dev_Poll_Reactor.h.

---

Constructor & Destructor Documentation

ACE_INLINE ACE_Dev_Poll_Handler_Guard::ACE_Dev_Poll_Handler_Guard (  ACE_Dev_Poll_Reactor_Handler_Repository &    repository, ACE_HANDLE    handle )

Constructor. The constructor increments the reference count on the event handler corresponding to the given handle. Definition at line 136 of file Dev_Poll_Reactor.inl. References ACE_Dev_Poll_Reactor_Handler_Repository::add_ref. : repository_ (repository), handle_ (handle) { // Caller must provide synchronization. (void) repository.add_ref (handle); /** * @todo Suspend the handler so that other threads will not cause * an event that is already in an upcall from being dispatched * again. * * @note The naive approach would be to simply call * suspend_handler_i() on the reactor. However, that would * cause a system call (write()) to occur. Obviously this * can potentially have an adverse affect on performance. * Ideally, the handler would only be marked as "suspended" in * the handler repository. If an event arrives for a * suspended handler that event can be "queued" in a * "handle readiness queue." "Queued" is quoted since a real * queue need not be used since duplicate events can be * coalesced, thus avoiding unbounded queue growth. Event * coalescing is already done by Linux's event poll driver * (/dev/epoll) so Solaris' poll driver (/dev/poll) is the * main concern here. The largest the queue can be is the * same size as the number of handlers stored in the handler * repository. */ }

ACE_INLINE ACE_Dev_Poll_Handler_Guard::~ACE_Dev_Poll_Handler_Guard (  void    )

Destructor. The destructor decrements the reference count on the event handler corresponding to the given handle. Definition at line 170 of file Dev_Poll_Reactor.inl. References ACE_Dev_Poll_Reactor_Handler_Repository::remove_ref, and repository_. { // Caller must provide synchronization. (void) this->repository_.remove_ref (this->handle_); /** * @todo Resume the handler so that other threads will be allowed to * dispatch the handler. */ }

---

Member Data Documentation

ACE_HANDLE ACE_Dev_Poll_Handler_Guard::handle_ [private]

Handle corresponding to the event being dispatched. Definition at line 1162 of file Dev_Poll_Reactor.h.

ACE_Dev_Poll_Reactor_Handler_Repository& ACE_Dev_Poll_Handler_Guard::repository_ [private]

Reference to the handler repository containing the event handler used during the upcall. Definition at line 1159 of file Dev_Poll_Reactor.h. Referenced by ~ACE_Dev_Poll_Handler_Guard.

---

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

• Dev_Poll_Reactor.h
• Dev_Poll_Reactor.inl

---