RWDBConnCallback Class Reference

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

#include <rw/db/conncb.h>

Public Member Functions
	RWDBConnCallback ()
	RWDBConnCallback (const RWDBConnCallback &conncb)
RWDBDatabaseCallback	databaseCallback () const
RWDBConnCallbackImp *	operator() () const
RWDBConnCallback &	operator= (const RWDBConnCallback &conncb)
RWDBStatus	status () const

Related Functions
(Note that these are not member functions.)
#define	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

#define 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 class and parameter values. 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.