RWDBConnCallback Class Reference
[Callbacks]

Handle class for connection callbacks that encapsulate a reference-counted pointer to the RWDBConnCallbackImp body class. More...

#include <rw/db/conncb.h>

List of all members.

Public Member Functions
	RWDBConnCallback ()
	RWDBConnCallback (const RWDBConnCallback &conncb)
RWDBConnCallback &	operator= (const RWDBConnCallback &conncb)
RWDBConnCallbackImp *	operator() () const
RWDBDatabaseCallback	databaseCallback () const
RWDBStatus	status () const
Related Functions
(Note that these are not member functions.)
	RWDBCONNCALLBACK(CALLBACK)

---

Detailed Description

RWDBConnCallback is the interface handle class for connection callbacks that encapsulate a reference-counted pointer to the RWDBConnCallbackImp body class. Please refer to the RWDBConnCallbackImp class for implementing connection callbacks.

Synopsis

 #include <rw/db/conncb.h>

 RWDBConnection connection = myDbase.connection(RWDBCONNCALLBACK(MyConnCallbackImp) );

---

Constructor & Destructor Documentation

RWDBConnCallback::RWDBConnCallback

(

)

[inline]

The default constructor creates an uninitialized connection callback with all callback methods as no-ops. The status of the RWDBConnCallback will be RWDBStatus::notInitialized. This constructor is provided for convenience; usable RWDBConnCallback objects must be obtained by using the macro RWDBCONNCALLBACK(CALLBACK).

RWDBConnCallback::RWDBConnCallback

(

const RWDBConnCallback &

conncb

)

[inline]

Copy constructor. The object created shares an implementation with conncb.

---

Member Function Documentation

RWDBDatabaseCallback RWDBConnCallback::databaseCallback

(

)

const

Returns the RWDBDatabaseCallback associated with the RWDBDatabase object that produced the RWDBConnection object associated with self.

RWDBConnCallbackImp * RWDBConnCallback::operator()

(

)

const [inline]

Returns a pointer to the connection callback implementation encapsulated by self.

RWDBConnCallback & RWDBConnCallback::operator=

(

const RWDBConnCallback &

conncb

)

[inline]

Assignment operator. Self shares an implementation with conncb. Returns a reference to self.

RWDBStatus RWDBConnCallback::status

(

)

const [inline]

Returns the current status of self.

---

Friends And Related Function Documentation

RWDBCONNCALLBACK

(

CALLBACK

)

[related]

This macro takes as a parameter the name of an implemented connection callback implementation class, which must derive from RWDBConnCallbackImp. To create an instance with the default constructor, just provide the name of the class. To use a different constructor, pass the parameter values along with it. For example:

 RWDBCONNCALLBACK(MyConnCallbackImp("abc", 1248))

This macro must be used while supplying an instance of the connection callback implementation class in the method RWDBDatabase::connection() or while producing new connection callbacks in the method redefined from RWDBDatabaseCallbackImp::produceConnCallback(). This macro ensures that a new instance of the connection callback implementation class is produced.