RWTraceEventClientImp Class Reference
[Execution Tracing]

A body class for trace event client implementations. More...

#include <rw/trace/RWTraceEventClientImp.h>

Inheritance diagram for RWTraceEventClientImp:

List of all members.

Public Member Functions
virtual	~RWTraceEventClientImp (void)
void	connectToManager (void)
void	connect (RWTraceEventFilter &filter)
void	disconnect (void)
void	trace (const RWTraceEvent &ev)
void	addReference (void)
unsigned	removeReference (void)
Protected Member Functions
	RWTraceEventClientImp (void)
virtual void	doTrace (const RWTraceEvent &ev)=0
RWMutex &	getMutex (void)

---

Detailed Description

RWTraceEventClientImp is a body class for trace event clients. This class provides the interface for clients.

See also:

RWTraceEventClient, RWTraceEventFilter, RWTraceManagerImp

---

Constructor & Destructor Documentation

virtual RWTraceEventClientImp::~RWTraceEventClientImp

(

void

)

[virtual]

Destructor.

RWTraceEventClientImp::RWTraceEventClientImp

(

void

)

[protected]

Default constructor.

---

Member Function Documentation

void RWTraceEventClientImp::addReference

(

void

)

[inline]

Increments reference count.

void RWTraceEventClientImp::connect

(

RWTraceEventFilter &

filter

)

Connects the client with the filter passed as an argument. If the client is already connected, throws the exception RWTraceClientAlreadyConnected.

void RWTraceEventClientImp::connectToManager

(

void

)

Connects the client with the global singleton trace event manager. If the client is already connected, throws the exception RWTraceClientAlreadyConnected. If the manager already has a client connected (there can be only one), it throws the exception RWTraceClientAlreadyAdded.

void RWTraceEventClientImp::disconnect

(

void

)

Disconnects the client from the filter to which it is currently attached. If the client is not connected, throws the exception RWTraceClientNotConnected.

virtual void RWTraceEventClientImp::doTrace

(

const RWTraceEvent &

ev

)

[protected, pure virtual]

Processes a trace event. This method must be overridden by derived clients in order to handle the trace event, perhaps printing it to the standard output or storing it in a file. See the discussion about the TraceEventClient in Section 6.7.2 in the Threads Module User's Guide.

Implemented in RWTraceLevelFilterImp, RWTraceMultiClientFilterImp, RWTraceOstreamClientImp, and RWTraceSingleClientFilterImp.

RWMutex & RWTraceEventClientImp::getMutex

(

void

)

[inline, protected]

Returns the mutex used for thread-safety. The mutex can be used by derived clients.

unsigned RWTraceEventClientImp::removeReference

(

void

)

[inline]

Decrements the reference count.

void RWTraceEventClientImp::trace

(

const RWTraceEvent &

ev

)

Forwards trace information to the doTrace() member.