RWTraceEventClient Class Reference
[Execution Tracing]

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

#include <rw/trace/RWTraceEventClient.h>

Inheritance diagram for RWTraceEventClient:

List of all members.

Public Member Functions
	RWTraceEventClient (RWTraceEventClientImp *bodyP=0)
	RWTraceEventClient (RWStaticCtor)
	RWTraceEventClient (const RWTraceEventClient &second)
virtual	~RWTraceEventClient (void)
RWTraceEventClient &	operator= (const RWTraceEventClient &second)
RWTraceEventClient &	operator= (RWTraceEventClientImp *ptr)
void	validate (void) const
bool	isValid (void) const
bool	operator== (const RWTraceEventClient &second) const
bool	operator!= (const RWTraceEventClient &second) const
void	orphan (void)
void	connectToManager (void)
void	connect (RWTraceEventFilter &filter)
void	disconnect (void)
void	trace (const RWTraceEvent &ev)
Protected Member Functions
void	transfer (RWTraceEventClientImp *bodyP=0)
RWTraceEventClientImp *	getBody (void) const

---

Detailed Description

RWTraceEventClient is the handle for trace event client implementations, forwarding messages to its body for processing. A client must be connected to a filter (or the global trace manager) to receive trace messages. The filter calls the trace() method each time a trace event is generated.

See also:

RWTraceEventFilter, RWTraceEventClientImp

---

Constructor & Destructor Documentation

RWTraceEventClient::RWTraceEventClient

(

RWTraceEventClientImp *

bodyP = 0

)

Attaches to and increments the reference count on bodyP.

RWTraceEventClient::RWTraceEventClient

(

RWStaticCtor

)

Constructs a global static handle instance (that may be used before being constructed).

RWTraceEventClient::RWTraceEventClient

(

const RWTraceEventClient &

second

)

Attaches to and increments the reference count on the body of second.

virtual RWTraceEventClient::~RWTraceEventClient

(

void

)

[virtual]

Destructor.

---

Member Function Documentation

void RWTraceEventClient::connect

(

RWTraceEventFilter &

filter

)

Connects the client with the filter.

If the client is already connected, throws the exception RWTraceClientAlreadyConnected.

void RWTraceEventClient::connectToManager

(

void

)

Connects the client with the global singleton trace event manager. The manager allows a single client connection at a time.

If the client is already connected, throws the exception RWTraceClientAlreadyConnected. If the manager already has a client connected, throws the exception RWTraceClientAlreadyAdded.

void RWTraceEventClient::disconnect

(

void

)

Disconnects the client from the filter it is currently attached to.

If the client is not connected, throws the exception RWTraceClientNotConnected.

RWTraceEventClientImp* RWTraceEventClient::getBody

(

void

)

const [protected]

Returns a pointer to the associated body.

If the pointer is not associated with a body, throws RWTraceInvalidPointer.

bool RWTraceEventClient::isValid

(

void

)

const

Returns true if this handle is connected to a body, otherwise false.

bool RWTraceEventClient::operator!=

(

const RWTraceEventClient &

second

)

const

Returns true if this instance points to a body other than the second instance.

RWTraceEventClient& RWTraceEventClient::operator=

(

RWTraceEventClientImp *

ptr

)

Detaches from the current body (if any), decrements its reference count, deletes it if there are no other references, and then attaches to the body ptr and increments its reference count.

RWTraceEventClient& RWTraceEventClient::operator=

(

const RWTraceEventClient &

second

)

Detaches from the current body (if any), decrements its reference count, deletes it if there are no other references, and then attaches to the body of second and increments its reference count.

bool RWTraceEventClient::operator==

(

const RWTraceEventClient &

second

)

const

Returns true if this instance points to the same body as the second instance.

void RWTraceEventClient::orphan

(

void

)

Detaches from the current body (if any), decrements its reference count, and deletes it if there are no other references.

void RWTraceEventClient::trace

(

const RWTraceEvent &

ev

)

Accepts a trace event.

void RWTraceEventClient::transfer

(

RWTraceEventClientImp *

bodyP = 0

)

[protected]

Associates this handle with the body pointed to by bodyP and increments its reference count.

If this handle is already associated with a body, detaches from that body, decrements its reference count, and deletes it if there are no other references.

void RWTraceEventClient::validate

(

void

)

const

Tests that this handle is associated with a body. If not, throws RWTraceInvalidPointer.