SQL Class Reference

#include <SQLCore.h>

Classes
class	Connection
struct	Date
struct	DRIVER_MODULE
class	Field
struct	Interval
class	Param
class	Query
struct	Time
struct	TimeStamp

Public Types
enum	Error {   eNoError = 0 , eServerError , eBadAddress , eOutOfMemory ,   eNotSupportMethod , eNotSupportStatement , eInvalidConnectionString , eConnected ,   eNotConnected , eInTransaction , eNotInTransaction , eHaveChildQuery ,   eNoChildQuery , eNotAvailable , eNotPrepared , eNotExecuted ,   eNotFetched , eInvalidIndex , eValueIsNull , eNotSupportDataType ,   eInvalidDataType , eInvalidBufferSize , eOutOfRange , eBytesTruncated ,   eInvalidData , eInvalidDataSize }
enum	DataType {   typeUnknown = 0 , typeInteger , typeUInteger , typeFloat ,   typeNumeric , typeDate , typeTime , typeTimeTz ,   typeTimeStamp , typeTimeStampTz , typeInterval , typeIntervalYm ,   typeIntervalDs , typeText , typeBinary , typeLongText ,   typeLongBinary , typeClob , typeBlob , typeInputStream ,   typeOutputStream }

Static Public Member Functions
static bool	getErrorMessage (wchar_t *_buf, size_t *_buflen, Error _errorCode)
static const wchar_t *	dataTypeName (DataType _dataType)

Detailed Description

Definition at line 14 of file SQLCore.h.

Member Enumeration Documentation

DataType

enum SQL::DataType

Enumerator
typeUnknown
typeInteger
typeUInteger
typeFloat
typeNumeric
typeDate
typeTime
typeTimeTz
typeTimeStamp
typeTimeStampTz
typeInterval
typeIntervalYm
typeIntervalDs
typeText
typeBinary
typeLongText
typeLongBinary
typeClob
typeBlob
typeInputStream
typeOutputStream

Definition at line 58 of file SQLCore.h.

{
    typeUnknown  = 0,        // C-DataType           SQL-Type
    typeInteger,         // int32_t, int64_t     TINYINT, SMALLINT, INTEGER, BIGINT
    typeUInteger,           // uint32_t, uint64_t   BIT, UTINYINT, USMALLINT, UINTEGER, UBIGINT
    typeFloat,             // float, double        REAL, DOUBLE, FLOAT
    typeNumeric,         // INTx, UINTx, float, double, char*    NUMBER, DECIMAL
    typeDate,               // SQL::Date            DATE
    typeTime,               // SQL::Time            TIME
    typeTimeTz,               // SQL::Time            TIME WITH TIME ZONE
    typeTimeStamp,         // SQL::TimeStamp       TIMESTAMP
    typeTimeStampTz,     // SQL::TimeStamp       TIMESTAMP WITH TIME ZONE
    typeInterval,           // SQL::Interval
    typeIntervalYm,           // SQL::Interval        INTERVAL YEAR TO SECOND
    typeIntervalDs,           // SQL::Interval        INTERVAL DAY TO SECOND
    typeText,               // char*                CHAR, VARCHAR,
    typeBinary,               // byte_t*              BINARY, RAW
    typeLongText,           // char*                LONG
    typeLongBinary,           // byte_t*              LONG RAW
    typeClob,               // Clob                 direct accessible CLOB
    typeBlob,               // Blob                 direct accessible BLOB
 
    // buffer type
    typeInputStream,     // InputStream
    typeOutputStream        // OutputStream
};

Error

enum SQL::Error

Enumerator
eNoError
eServerError
eBadAddress
eOutOfMemory
eNotSupportMethod
eNotSupportStatement
eInvalidConnectionString
eConnected
eNotConnected
eInTransaction
eNotInTransaction
eHaveChildQuery
eNoChildQuery
eNotAvailable
eNotPrepared
eNotExecuted
eNotFetched
eInvalidIndex
eValueIsNull
eNotSupportDataType
eInvalidDataType
eInvalidBufferSize
eOutOfRange
eBytesTruncated
eInvalidData
eInvalidDataSize

Definition at line 18 of file SQLCore.h.

{
    eNoError = 0,       
    eServerError,           // 서버 혹은 서버 API 호출 에러이다.
 
    eBadAddress,         // 버퍼 혹은 파라메터의 주소가 잘못되었다.
    eOutOfMemory,           // 메모리 할당이 불가능 하다.
    eNotSupportMethod,     // 서버 혹은 드라이버에서 지원하지 않는 메소드 입니다.
 
    // Connection, Query
    eNotSupportStatement,
 
    // Connection Errors
    eInvalidConnectionString,   
    eConnected,               // Connection이 이미 연결되었다.
    eNotConnected,         // 먼저 Connection::open을 호출해야 한다.
    eInTransaction,           // 이미 트랜잭션이 시작되었다.
    eNotInTransaction,     // 트랜잭션 상태가 아니다.
    eHaveChildQuery,     // 이 연결을 사용하는 Query가 있다.
    eNoChildQuery,         // 파괴하려는 Query는 다른곳에서 생성되었다.
    eNotAvailable,         // 값을 얻을 수 없다. for geServerInfo
 
    // Query Errors
    eNotPrepared,           // 먼저 Query::prepare 를 호출해야 한다.
    eNotExecuted,           // 먼저 Query::execute 를 호출해야 한다.
    eNotFetched,         // 먼저 Query::fetch 를 호출해야 한다.
    eInvalidIndex,         // Field나 Param을 참조하는 잘못된 Index값이다.
 
    // Field, Param
    eValueIsNull,           // 값이 null 이다
    eNotSupportDataType, // 서버 혹은 드라이버에서 지원하지 않는 데이터타입이다.
    eInvalidDataType,       // 필드값을 얻거나 파라메터 값을 설정하기 위한 데이터타입이 잘못되었다.
    eInvalidBufferSize,       // 필드 혹은 아웃바인드의 값을 읽고자 하는 버퍼의 크기가 유효하지 않다.
                            // Field::getValue *_size에 필요한 버퍼의 크기를 리턴
    eOutOfRange,         // typeNumeric에서 버퍼의 데이터타입과 사이즈에 적용하는데 범위를 초과했다.
    eBytesTruncated,     // 문자열 또는 바이트 데이터가 크거나, 버퍼의 크기가 작다.
    eInvalidData,           // 수신된 데이터가 잘못되었거나, 서버에 적용하는데 실패하였다.
    eInvalidDataSize        // 데이터타입에 해당하는 데이터의 사이즈가 유효하지 않다.
};

Member Function Documentation

dataTypeName()

const wchar_t * SQL::dataTypeName ( DataType _dataType )

static

Definition at line 105 of file SQLCore.cpp.

{
    switch(_dataType) {
        DATA_TYPE_NAME(typeUnknown);
        DATA_TYPE_NAME(typeInteger);
        DATA_TYPE_NAME(typeUInteger);
        DATA_TYPE_NAME(typeFloat);
        DATA_TYPE_NAME(typeNumeric);
        DATA_TYPE_NAME(typeDate);
        DATA_TYPE_NAME(typeTime);
        DATA_TYPE_NAME(typeTimeTz);
        DATA_TYPE_NAME(typeTimeStamp);
        DATA_TYPE_NAME(typeTimeStampTz);
        DATA_TYPE_NAME(typeInterval);
        DATA_TYPE_NAME(typeIntervalYm);
        DATA_TYPE_NAME(typeIntervalDs);
        DATA_TYPE_NAME(typeText);
        DATA_TYPE_NAME(typeBinary);
        DATA_TYPE_NAME(typeLongText);
        DATA_TYPE_NAME(typeLongBinary);
        DATA_TYPE_NAME(typeClob);
        DATA_TYPE_NAME(typeBlob);
 
        // additional buffer type
        DATA_TYPE_NAME(typeInputStream);
        DATA_TYPE_NAME(typeOutputStream);
    };
 
    __DCL_ASSERT(false);
    return __T("");
}

getErrorMessage()

bool SQL::getErrorMessage ( wchar_t * _buf, size_t * _buflen, Error _errorCode )

static

Definition at line 38 of file SQLCore.cpp.

{
    static const SQL_ERROR errors[] = {
    // Core Error
    __SQLERROR_MSG(eNoError,          "No Error"),
    __SQLERROR_MSG(eServerError,      "서버 혹은 서버 API 호출중에 에러가 발생했습니다."),
    __SQLERROR_MSG(eBadAddress,            "버퍼 혹은 파라메터의 주소가 잘못되었습니다."),
    __SQLERROR_MSG(eOutOfMemory,      "메모리 할당을 할 수 없습니다."),
    __SQLERROR_MSG(eNotSupportMethod,    "서버 혹은 드라이버에서 지원하지 않는 메소드 입니다."),
 
    // SQL::Connection::execute, SQL::Query::prepare, execute
    __SQLERROR_MSG(eNotSupportStatement, "이 인터페이스를 통해 실행할 수 없는 SQL 입니다"),
 
    // SQL::Connection Errors
    __SQLERROR_MSG(eInvalidConnectionString, "서버 연결을위한 연결문자열의 값이 잘못되었습니다."),
    __SQLERROR_MSG(eConnected,          "서버와 연결되어 있는 상태입니다. 다시 연결할 수 없습니다."),
    __SQLERROR_MSG(eNotConnected,        "서버에 연결되어 있지 않습니다. 연결을 끊을 수 없습니다."),
    __SQLERROR_MSG(eInTransaction,      "트랜잭션 중 입니다. 트랜잭션을 시작할 수 없습니다."),
    __SQLERROR_MSG(eNotInTransaction,    "트랜잭션 상태가 아닙니다. 트랜잭션을 종료할 수 없습니다."),
    __SQLERROR_MSG(eHaveChildQuery,        "이 연결을 사용하는 쿼리 인터페이스가 있습니다."),
    __SQLERROR_MSG(eNoChildQuery,        "이 연결을 사용하는 쿼리 인터페이스가 아닙니다."),
    __SQLERROR_MSG(eNotAvailable,        "서버의 정보를 얻을 수 없습니다."),
 
    // SQL::Query Errors
    __SQLERROR_MSG(eNotPrepared,      "쿼리가 준비되지 있지 않습니다."),
    __SQLERROR_MSG(eNotExecuted,      "쿼리가 실행되어 있지 않습니다."),
    __SQLERROR_MSG(eNotFetched,            "쿼리가 fetch되어 있지 않습니다."),
    __SQLERROR_MSG(eInvalidIndex,        "필드나 파라메터를 참조하는 인덱스가 잘못되었습니다."),
 
    // SQL::Field Errors, SQL::Param Errors
    __SQLERROR_MSG(eValueIsNull,      "값이 null 입니다."),
    __SQLERROR_MSG(eNotSupportDataType,    "서버 혹은 드라이버에서 지원하지 않는 데이터 형식입니다."),
    __SQLERROR_MSG(eInvalidDataType,  "필드값을 얻거나 파라미터 값을 설정하기 위한 데이터 형식이 잘못되었습니다."),
    __SQLERROR_MSG(eInvalidBufferSize,  "필드 혹은 아웃바인드의 값을 읽고자 하는 버퍼의 크기가 잘못되었습니다."),
    __SQLERROR_MSG(eOutOfRange,            "Numeric 데이터의 범위를 벗어났습니다."),
    __SQLERROR_MSG(eBytesTruncated,        "문자열 또는 바이트 데이터가 크거나, 버퍼의 크기가 작아서 잘립니다."),
    __SQLERROR_MSG(eInvalidData,      "수신된 데이터가 잘못되었거나, 서버에 적용할수 없습니다."),
    __SQLERROR_MSG(eInvalidDataSize,  "데이터타입에 적절한 데이터 크기가 아닙니다."),
    };
 
    __DCL_ASSERT(_buf != NULL && _buflen != NULL);
 
    const wchar_t* psz = L"Unknown error code";
    for(size_t i = 0; i < __countof(errors, SQL_ERROR); i++) {
        if (_errorCode == errors[i].error) {
            psz = errors[i].message;
            break;
        }
    }
 
    size_t len = wcslen(psz);
    if (*_buflen >= len) {
        wcsncpy(_buf, psz, len);
        *_buflen = len;
        return true;
    }
 
    *_buflen = len;
    return false;
}

---

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

• SQLCore.h
• SQLCore.cpp