IBConnection Class Reference

#include <IBConnection.h>

Inheritance diagram for IBConnection:

Public Member Functions
void	setErrorStatus (SQL::Error _error, const wchar_t *_filename, int _line)
void	setErrorStatus (const ByteString &_message, const wchar_t *_filename, int _line)
isc_db_handle *	dbHandlePtr ()
isc_tr_handle *	trHandlePtr ()
short	dialect () const
ISC_STATUS *	statusVector ()
	IBConnection (const wchar_t *_serverTitle)
virtual void	destroy ()
virtual	~IBConnection ()
virtual bool	__open (const char *_connString, size_t _connlen)
virtual bool	__close ()
virtual bool	__execute (const char *_sql, size_t _sqllen)
virtual bool	__startTrans ()
virtual bool	__commitTrans ()
virtual bool	__rollbackTrans ()
virtual bool	__createQueryInstance (SQL::Query **_queryHandleOut)
virtual bool	__getErrorMessage (char *_buf, size_t *_buflen)
virtual bool	__getServerInfo (char *_buf, size_t *_buflen)
Public Member Functions inherited from SQL::Connection
long	refCount () const
long	addRef ()
long	release ()
bool	open (const char *_connString, size_t _connlen)
bool	close ()
bool	execute (const char *_sql, size_t _sqllen)
bool	startTrans ()
bool	commitTrans ()
bool	rollbackTrans ()
bool	getErrorMessage (char *_pbuf, size_t *_pn)
bool	getServerInfo (char *_pbuf, size_t *_pn)
bool	createQueryInstance (Query **_queryHandleOut)
bool	destroyQueryInstance (Query *_queryHandle)
Error	errorCode () const
bool	canTransact () const
const wchar_t *	serverTitle () const
bool	inState (unsigned int uState) const
Public Member Functions inherited from Object
virtual String	toString () const
String	className () const
bool	isInstanceOf (const std::type_info &typeinfo) const
virtual const std::type_info &	typeInfo () const

Additional Inherited Members
Public Types inherited from SQL::Connection
enum	State { stClosed = 0x0001 , stOpenned = 0x0002 , stInTransaction = 0x0004 }
Static Public Member Functions inherited from SQL::Connection
static size_t	splitConnectionString (const char *_connString, size_t _strlen, ListedByteStringToByteStringMap &_map)
Public Attributes inherited from SQL::Connection
__PROTECTED	: void setErrorStatus(Error _errorCode
__PROTECTED const wchar_t *	_filename
__PROTECTED const wchar_t int	_line
Protected Member Functions inherited from SQL::Connection
	Connection (const wchar_t *_serverTitle)
virtual	~Connection ()
Protected Member Functions inherited from Object
virtual	~Object ()
	Object ()
Protected Attributes inherited from SQL::Connection
bool	__canTransact
const wchar_t *	__serverTitle
Error	__errorCode
const wchar_t *	__errorFileName
int	__errorLine
unsigned int	__states

Detailed Description

Definition at line 14 of file IBConnection.h.

Constructor & Destructor Documentation

IBConnection()

IBConnection::IBConnection

(

const wchar_t *

_serverTitle

)

~IBConnection()

IBConnection::~IBConnection ( )

virtual

Definition at line 39 of file IBConnection.cpp.

{
}

Member Function Documentation

__close()

bool IBConnection::__close ( )

virtual

Implements SQL::Connection.

Definition at line 182 of file IBConnection.cpp.

{
    __DCL_ASSERT(__dbHandle != NULL);
    __DCL_ASSERT(__trHandle == NULL);
 
    if (isc_detach_database(
            __status,
            &__dbHandle)
            ) {
//      __DCL_ASSERT(STATUS_FAILED(__status));
        __SET_ERROR(SQL::eServerError);
        return false;
    }
    __dbHandle = NULL;
    return true;
}

__commitTrans()

bool IBConnection::__commitTrans ( )

virtual

Implements SQL::Connection.

Definition at line 280 of file IBConnection.cpp.

{
    __DCL_ASSERT(__trHandle != NULL);
    if(isc_commit_transaction(
            __status, 
            &__trHandle)
            ) {
//      __DCL_ASSERT(STATUS_FAILED(__status));
        __SET_ERROR(SQL::eServerError);
        return false;
    }
    __trHandle = NULL;
 
    return true;
}

__createQueryInstance()

bool IBConnection::__createQueryInstance ( SQL::Query ** _queryHandleOut )

virtual

Implements SQL::Connection.

Definition at line 312 of file IBConnection.cpp.

{
    __DCL_ASSERT(_queryHandleOut != NULL);
 
    SQL::Query* pNewQuery = new IBQuery(this);
    if (!pNewQuery) {
        __SET_ERROR(SQL::eOutOfMemory);
        return false;
    }
    
    *_queryHandleOut = pNewQuery;
    return true;
}

__execute()

bool IBConnection::__execute ( const char * _sql, size_t _sqllen )

virtual

Implements SQL::Connection.

Definition at line 227 of file IBConnection.cpp.

{
    __DCL_ASSERT(n <= UINT16_MAX);
    __DCL_ASSERT(__dbHandle != NULL);
    if(isc_dsql_execute_immediate(
            __status,
            &__dbHandle,
            &__trHandle,
            (unsigned short int)n,
            (_CONST char*)_sql,
            __dialect,
            NULL)
            ) {
//      __DCL_ASSERT(STATUS_FAILED(__status));
        __SET_ERROR(SQL::eServerError);
        return false;
    }
 
    switch (__GetStmtType(_sql)) {
    case StmtTransBegin :
        __SET_STATE(stInTransaction);
        __DCL_ASSERT(__trHandle != NULL);
        break;
    case StmtTransEnd :
        __UNSET_STATE(stInTransaction);
        __trHandle = NULL;
        break;
    default :
        ;
    }
 
    return true;
}

__getErrorMessage()

bool IBConnection::__getErrorMessage ( char * _buf, size_t * _buflen )

virtual

Implements SQL::Connection.

Definition at line 326 of file IBConnection.cpp.

{
    ByteStringBuilder sb;
    if (!__lastErrorMessage.isEmpty())
        sb = __lastErrorMessage;
    else {
        char buf[512];
        ISC_STATUS* status = __status;
        long len = 0;
#ifdef FIREBIRD_IBASE_H
#define isc_interprete(buf, pp) fb_interpret(buf, sizeof(buf), (const ISC_STATUS**) pp)
#endif
        for(size_t i = 0; (len = isc_interprete(buf, &status))
                && (i < ISC_STATUS_VECTOR_LENGTH); i++) {
            if (i > 0)
                sb += ", ";
            sb.append(buf, 0, len);
        }
    }
 
    if (sb.length() < *_buflen)
        *_buflen = sb.length();
 
    strncpy(_buf, sb.data(), *_buflen);
 
    return true;
}

__getServerInfo()

bool IBConnection::__getServerInfo ( char * _buf, size_t * _buflen )

virtual

Implements SQL::Connection.

Definition at line 360 of file IBConnection.cpp.

{
    char buffer[512];
    if (isc_database_info (
            __status,
            &__dbHandle,
            sizeof(database_info_items),
            database_info_items,
            sizeof(buffer),
            buffer)) {
        __SET_ERROR(SQL::eServerError);
        return false;
    }
 
    ByteString strVersion;
    ByteString strDb;
    ByteString strSite;
 
    char* p = buffer;
    char item;
    unsigned short length;
    __DCL_ASSERT(sizeof(unsigned short) == 2);
    while(*p != isc_info_end) {
        item = *p++;
        length = (unsigned short)isc_vax_integer(p, 2);
        p += 2;
        if (item == isc_info_version) {
        //  __DCL_ASSERT(p[0] == 1);
            //__DCL_TRACE1(L"[%d]\n", p[0]);
            strVersion.assign(p, 2, p[1]);
        }
        else if (item == isc_info_db_id) {
            char* t = p;
            //__DCL_TRACE1(L"[%d]\n", *t);
            //__DCL_ASSERT(*t == 2);
            t++;
            unsigned short nStrLen = *t++;
            strDb.assign(t, nStrLen);
            t += nStrLen;
            nStrLen = *t++;
            strSite.assign(t, nStrLen);
        }
        else {
            __SET_ERROR(SQL::eNotAvailable);
            return false;
        }
        p += length;
    }
 
    ByteString strInfo = "InterBase " + strVersion + " \"" + strSite + ':' + strDb + "\"";
    if (strInfo.length() < *_buflen)
        *_buflen = strInfo.length();
 
    strncpy(_buf, strInfo.data(), *_buflen);
    return true;
}

__open()

bool IBConnection::__open ( const char * _connString, size_t _connlen )

virtual

Implements SQL::Connection.

Definition at line 62 of file IBConnection.cpp.

{
    try  {
        if (Regex::test(__createDatabasePattern__, _connString, true)) {
            // CREATE DATABASE
            if(isc_dsql_execute_immediate(
                    __status,
                    &__dbHandle,
                    &__trHandle,
                    0,
                    (_CONST char*)_connString,
                    __dialect,
                    NULL)) {
                __SET_ERROR(SQL::eServerError);
                return false;
            }
            return true;
        }
    }
    catch(RegexException* e) {
        e->destroy();
    }
 
    ListedByteStringToByteStringMap map;
    Connection::splitConnectionString(_connString, _connlen, map);
 
    ByteString strServer = map["SERVER"];
    ByteString strDatabase = map["DATABASE"];
    ByteString strUser = map["USER"];
    ByteString strPassword = map["PASSWORD"];
    ByteString strSqlDialect = map["SQL_DIALECT"];
 
    if (!strSqlDialect.isEmpty()) {
        int nDialect = SQL_DIALECT_CURRENT;
        char* endptr;
        long n = strtol(strSqlDialect, &endptr, 10);
        if (n == LONG_MAX || n == LONG_MIN
                || n < INT_MIN || INT_MAX < n
                ) {
            __SET_ERROR_MSG("연결 문자열이 잘못되었습니다. SQL_DIALECT="
                + strSqlDialect);
            return false;
        }
        
        nDialect = (int)n;
 
        if (!(nDialect == SQL_DIALECT_V5
                || nDialect == SQL_DIALECT_V6_TRANSITION
                || nDialect == SQL_DIALECT_V6)) {
            __SET_ERROR_MSG("\"SQL_DIALECT\"- invalid value");
            return false;
        }
 
        __dialect = nDialect;
    }
 
    if ((strUser.length() > 127) || (strPassword.length() > 127)) {
        // USER NAME 과 PASSWORD 의 길이는 127을 넘을 수 없다.
        __SET_ERROR(SQL::eInvalidConnectionString);
        return false;
    }
 
    ByteString strDatabaseEnv;
    if (!strServer.isEmpty())
        strDatabaseEnv = strServer + ":";
 
    if (!strDatabase.isEmpty())
        strDatabaseEnv = strDatabaseEnv + strDatabase;
 
    if (strDatabaseEnv.isEmpty()) {
        __SET_ERROR(SQL::eInvalidConnectionString);
        return false;
    }
 
    // database parameter block
    ByteStringBuilder dpb;
    dpb = (char)isc_dpb_version1;
    dpb += (char)isc_dpb_user_name;
    dpb += (char)strUser.length();
    dpb += strUser;
    dpb += (char)isc_dpb_password;
    dpb += (char)strPassword.length();
    dpb += strPassword;
 
    static const char __UTF8__[] = "UTF8";
    dpb += (char)isc_dpb_lc_ctype;
    dpb += (char)(sizeof(__UTF8__) - 1);
    dpb += __UTF8__;
 
#if defined(FIREBIRD_IBASE_H) && FB_API_VER >= 40
    static const char __SET_BIND__[] =
        "DECFLOAT TO VARCHAR;"      // 20
        "INT128 TO VARCHAR;"        // 18
        "TIME ZONE TO EXTENDED";    // 21
    dpb += (char)isc_dpb_set_bind;
    dpb += (char)(sizeof(__SET_BIND__) - 1);
    dpb += __SET_BIND__;
#endif
 
#ifdef FIREBIRD_IBASE_H
    #undef _CONST
    #define _CONST const
#endif
 
    if (isc_attach_database(
            __status,
            (short) strDatabaseEnv.length(),
            (_CONST char*) strDatabaseEnv.data(),
            &__dbHandle,
            (short) dpb.length(),
            (_CONST char*) dpb.data())
            ) {
//      __DCL_ASSERT(STATUS_FAILED(__status));
        __SET_ERROR(SQL::eServerError);
        __dbHandle = NULL;
        return false;
    }
    return true;
}

__rollbackTrans()

bool IBConnection::__rollbackTrans ( )

virtual

Implements SQL::Connection.

Definition at line 296 of file IBConnection.cpp.

{
    __DCL_ASSERT(__trHandle != NULL);
    if(isc_rollback_transaction(
            __status, 
            &__trHandle)
            ) {
//      __DCL_ASSERT(STATUS_FAILED(__status));
        __SET_ERROR(SQL::eServerError);
        return false;
    }
    __trHandle = NULL;
 
    return true;
}

__startTrans()

bool IBConnection::__startTrans ( )

virtual

Implements SQL::Connection.

Definition at line 261 of file IBConnection.cpp.

{
    __DCL_ASSERT(__trHandle == NULL);
    if (isc_start_transaction(
            __status, 
            &__trHandle, 
            1, 
            &__dbHandle, 
            0, 
            NULL)
            ) {
//      __DCL_ASSERT(STATUS_FAILED(__status));
        __SET_ERROR(SQL::eServerError);
        return false;
    }
 
    return true;
}

dbHandlePtr()

isc_db_handle * IBConnection::dbHandlePtr ( )

inline

Definition at line 30 of file IBConnection.h.

{ return &__dbHandle; }

destroy()

void IBConnection::destroy ( )

virtual

파생클래스에서 new 연산자를 override했거나, 추가적인 행위가 필요하다면 이것도 override하라

Implements SQL::Connection.

Definition at line 43 of file IBConnection.cpp.

{
//  cerr << "IBConnection::destory\n";
    delete this;
}

dialect()

short IBConnection::dialect ( ) const

inline

Definition at line 32 of file IBConnection.h.

{ return __dialect; }

setErrorStatus() [1/2]

void IBConnection::setErrorStatus ( const ByteString & _message, const wchar_t * _filename, int _line )

inline

Definition at line 59 of file IBConnection.h.

{
    Connection::setErrorStatus(SQL::eServerError, _filename, _line);
    __lastErrorMessage = _message;
}

setErrorStatus() [2/2]

void IBConnection::setErrorStatus ( SQL::Error _error, const wchar_t * _filename, int _line )

inline

Definition at line 52 of file IBConnection.h.

{
    Connection::setErrorStatus(_error, _filename, _line);
    __lastErrorMessage.clear();
}

statusVector()

ISC_STATUS * IBConnection::statusVector ( )

inline

Definition at line 33 of file IBConnection.h.

{ return __status; }

trHandlePtr()

isc_tr_handle * IBConnection::trHandlePtr ( )

inline

Definition at line 31 of file IBConnection.h.

{ return &__trHandle; }

---

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

• IBConnection.h
• IBConnection.cpp