SQLDriver Class Reference

#include <SQLDriver.h>

Inheritance diagram for SQLDriver:

Public Member Functions
long	refCount () const
long	addRef ()
long	release ()
	SQLDriver (const String &_name) __DCL_THROWS1(SQLDriverException *)
virtual	~SQLDriver ()
void	open (const String &_name) __DCL_THROWS1(SQLDriverException *)
void	close () __DCL_THROWS1(SQLDriverException *)
const String &	driverName () const
String	getDriverSummary () const
SQL::Connection *	createConnection ()
void	destroyConnection (SQL::Connection *pConnection)
Public Member Functions inherited from Object
virtual String	toString () const
virtual void	destroy ()
String	className () const
bool	isInstanceOf (const std::type_info &typeinfo) const
virtual const std::type_info &	typeInfo () const

Static Public Member Functions
static SQLDriver *	getDriver (const String &_name) __DCL_THROWS1(SQLDriverException *)
static void	closeDriver (SQLDriver *_pSQLDriver) __DCL_THROWS1(SQLDriverException *)

Protected Attributes
SQL::DRIVER_MODULE *	__pModuleEntryPoint
String	__driverName
Protected Attributes inherited from Dll
void *	__handle
String	__filename

Additional Inherited Members
Protected Member Functions inherited from Object
virtual	~Object ()
	Object ()

Detailed Description

Definition at line 44 of file SQLDriver.h.

Constructor & Destructor Documentation

SQLDriver()

SQLDriver::SQLDriver

(

const String &

_name

)

Definition at line 101 of file SQLDriver.cpp.

{
    __refCount = 0;
    __pModuleEntryPoint = NULL;
    open(_name);
}

~SQLDriver()

SQLDriver::~SQLDriver ( )

virtual

Definition at line 109 of file SQLDriver.cpp.

{
    if (__pModuleEntryPoint) {
        try {
            close();
        }
        catch (SQLDriverException* e) {
            __DCL_TRACE1(L"Warning SQLDriver::close fail! %ls\n",
                e->toString().data());
            e->destroy();
        }
    }
}

Member Function Documentation

addRef()

long SQLDriver::addRef

(

)

close()

void SQLDriver::close

(

)

Definition at line 216 of file SQLDriver.cpp.

{
    Exception* e = NULL;
    try {
        __DCL_ASSERT(refCount() == 0);
        __DCL_ASSERT(__pModuleEntryPoint != NULL);
 
        SQL::DRIVER_MODULE* pEntryPoint = __pModuleEntryPoint;
        __pModuleEntryPoint = NULL;
 
        if (!pEntryPoint->pfnCleanup()) {
            throw new SQLDriverException(__driverName,
                SQLDriverException::eCleanupFail,
                getDriverSummary()
            );
        }
    }
    catch (Exception* _e) {
        e = _e;
    }
 
    try {
        Dll::close();
    }
    catch (Exception* _e) {
        if (e != NULL) {
            __DCL_TRACE1(L"%ls", _e->toString().data());
            throw e;
        }
        else {
            throw new SQLDriverException(__driverName, _e);
        }
    }
}

closeDriver()

void SQLDriver::closeDriver ( SQLDriver * _pSQLDriver )

static

Definition at line 469 of file SQLDriver.cpp.

{
    __DCL_ASSERT(_pSQLDriver);
    __DCL_ASSERT(_pSQLDriver->refCount() == 0);
    __DCL_ASSERT(__pDriverPool != NULL);
 
    Exception* e = NULL;
 
    __pLibState->lockSQLDriverPool.lock();
    try {
        __pDriverPool->clear(_pSQLDriver);
    }
    catch (Exception* _e) {
        e = _e;
    }
    __pLibState->lockSQLDriverPool.unlock();
 
    if (e != NULL) {
        throw e;
    }
}

createConnection()

SQL::Connection * SQLDriver::createConnection

(

)

Definition at line 252 of file SQLDriver.cpp.

{
    __DCL_ASSERT(__pModuleEntryPoint != NULL);
    SQL::Connection* pNewConnection = 
        __pModuleEntryPoint->pfnCreateConnectionInstance();
    addRef();
    return pNewConnection;
}

destroyConnection()

void SQLDriver::destroyConnection

(

SQL::Connection *

pConnection

)

Definition at line 261 of file SQLDriver.cpp.

{
    pConnection->destroy();
    release();
}

driverName()

const String & SQLDriver::driverName ( ) const

inline

Definition at line 67 of file SQLDriver.h.

{ return __driverName; };

getDriver()

SQLDriver * SQLDriver::getDriver ( const String & _name )

static

Definition at line 441 of file SQLDriver.cpp.

{
    SQLDriver* r = NULL;
    Exception* e = NULL;
 
    __pLibState->lockSQLDriverPool.lock();
    try {
        if (__pDriverPool == NULL) {
            __pDriverPool = new SQLDriverPool();
            __pLibState->pfnSQLCleanup = cleanupDriverContext;
        }
        __DCL_ASSERT(__pDriverPool != NULL);
    
        r = __pDriverPool->getDriver(_name);
    }
    catch (Exception* _e) {
        e = _e;
    }   
    __pLibState->lockSQLDriverPool.unlock();
 
    if (e != NULL) {
        throw e;
    }
 
    return r;
}

getDriverSummary()

String SQLDriver::getDriverSummary

(

)

const

Definition at line 267 of file SQLDriver.cpp.

{
    __DCL_ASSERT(__pModuleEntryPoint != NULL);
 
    StringBuilder r = __T("DriverName:") + __driverName;
    r += __T(", FileName:") + Dll::__filename;
 
    r += __T(", DCLVersion:"); 
    r.format(L"%u.%u", 
                    DCL_MAJOR_VERSION(__pModuleEntryPoint->uDCLVersion),
                    DCL_MINOR_VERSION(__pModuleEntryPoint->uDCLVersion)
                    );
 
    r += __T(", InterfaceVersion:");
    r.format(L"%u.%u",
                    DCL_MAJOR_VERSION(__pModuleEntryPoint->uVersion),
                    DCL_MINOR_VERSION(__pModuleEntryPoint->uVersion)
                    );
 
    r += L", Build:";
    r += __pModuleEntryPoint->uBuildFlag ? L"Debug" : L"Release";
    if (__pModuleEntryPoint->pszBuildTimeStamp) {
        r += L" ";
        r += __pModuleEntryPoint->pszBuildTimeStamp;
    }
 
    if (__pModuleEntryPoint->pfnInitialize == NULL)
        r += L", pfnInitialize: (null)";
    if (__pModuleEntryPoint->pfnInitialize == NULL)
        r += L", pfnCleanup: (null)";
    if (__pModuleEntryPoint->pfnCreateConnectionInstance == NULL)
        r += L", pfnCreateConnectionInstance: (null)";
 
    if (__pModuleEntryPoint->pszFileVersion) {
        r += L", FileVersion:";
        r += __pModuleEntryPoint->pszFileVersion;
    }
 
    if (__pModuleEntryPoint->pszServerTitle) {
        r += L", ServerTitle:";
        r += __pModuleEntryPoint->pszServerTitle;
    }
 
    if (__pModuleEntryPoint->pszDescription) {
        r += L", Desc:";
        r += __pModuleEntryPoint->pszDescription;
    }
    return r;
}

open()

void SQLDriver::open

(

const String &

_name

)

Definition at line 123 of file SQLDriver.cpp.

{
    __DCL_ASSERT(__pModuleEntryPoint == NULL);
 
    StringBuilder filename = _name
#ifdef __DCL_DEBUG
        + __T("d")
#elif defined(_DEBUG)
        + __T("dd")
#endif
        ;
        
    filename +=
#if __DCL_WINDOWS
        __T(".dll")
#else
        __T(".so")
#endif
        ;
 
    int flags = Dll::DEFAULT
 #ifdef RTLD_LAZY
        | RTLD_LAZY
 #endif
        ;
 
    try {
        Dll::open(filename.toString(), flags);
    }
    catch (Exception* cause) {
        throw new SQLDriverException(_name, cause);
    }
 
    try {
        SQL::DRIVER_MODULE* pEntryPoint = NULL;
        try {
            pEntryPoint = (SQL::DRIVER_MODULE*)getAddress(
                DCL_DSO_ENTRY_POINT_STRING);
        }
        catch (Exception* cause) {
            throw new SQLDriverException(_name, cause);
        }
 
        if (pEntryPoint->uSize != sizeof(SQL::DRIVER_MODULE)) {
            throw new SQLDriverException(_name,
                SQLDriverException::eInvalidDriverModule);
        }
 
        if (pEntryPoint->uDCLVersion != DCL_VERSION
            || pEntryPoint->uBuildFlag != DCL_BUILD_FLAG) {
            throw new SQLDriverException(_name,
                SQLDriverException::eInvalidDriverModule);
        }
 
        if (pEntryPoint->uVersion != DCL_SQL_VERSION) {
            throw new SQLDriverException(_name,
                SQLDriverException::eInvalidVersion);
        }
 
        if (pEntryPoint->pfnInitialize == NULL
            || pEntryPoint->pfnCleanup == NULL
            || pEntryPoint->pfnCreateConnectionInstance == NULL) {
            throw new SQLDriverException(_name,
                SQLDriverException::eInvalidDriverModule);
        }
 
        if (!pEntryPoint->pfnInitialize()) {
            throw new SQLDriverException(_name,
                SQLDriverException::eInitializeFail
            );
        }
 
        __pModuleEntryPoint = pEntryPoint;
        __driverName = _name;
 
        __DCL_TRACE3(__T("Open SQLDriver: %ls (%ls, %ls)\n"),
            _name.data(),
            filename.data(),
            getDriverSummary().data()
        );
    }
    catch (Exception* e) {
        try {
            Dll::close();
        }
        catch (Exception* _nt) {
            _nt->destroy();
        }
        throw e;
    }
}

refCount()

long SQLDriver::refCount ( ) const

inline

Definition at line 51 of file SQLDriver.h.

{ return __refCount; }

release()

long SQLDriver::release

(

)

Definition at line 94 of file SQLDriver.cpp.

{
    __DCL_ASSERT(__refCount > 0);   // __DCL_ASSERT_VALID(this);
    long n = Thread::decrementAndGet(__refCount);
    return n;
}

Member Data Documentation

__driverName

String SQLDriver::__driverName

protected

Definition at line 75 of file SQLDriver.h.

__pModuleEntryPoint

SQL::DRIVER_MODULE* SQLDriver::__pModuleEntryPoint

protected

Definition at line 74 of file SQLDriver.h.

---

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

• SQLDriver.h
• SQLDriver.cpp