C语言访问INFORMIX数据库 — 接口实现

一、简要概述

INFORMIX数据库是IBM旗下的一款关系数据库，目前在金融行业占有不可替代的地位。使用C语言访问INFORMIX数据库的唯一方式是通过ESQL，其过程中有很多细节内容需要注意，但为了能够快速的理解各接口的流程，在此只给出各接口的基本框架。（注：ESQL语法在IBM帮助系统http://publib.boulder.ibm.com/infocenter/idshelp/v10/index.jsp?中有详尽的描述）

二、结构定义

/* 数据源配置信息 */
typedef struct
{
	char svrname[DB_SVR_NAME_MAX_LEN];   /* 服务名 */
	char usrname[DB_USR_NAME_MAX_LEN];   /* 用户名 */
	char passwd[DB_PWD_MAX_LEN];         /* 密码 */
}db_source_struct_t;

/* 数据库连接上下文信息 */
typedef struct
{
	char svrname[DB_SVR_NAME_MAX_LEN];         /* 服务名 */
	char cnname[DB_CONN_NAME_MAX_LEN];         /* 连接名 */

	/* 查询结果集 */
	ifx_sqlda_t *result;                       /* FETCH结果集 */
	int req_rows;                              /* 每次申请取的行数 */
	int rows;                                  /* 结果集中实际的行数 */
	int isalloced;                             /* 结果集空间是否被分配 0:未分配 1：已分配 */
	
	/* 结果转换 */
	char *convert;                             /* 结果转换空间 */
	size_t convert_size;                       /* 结果转换空间的大小 */

	int msglen;                                /* 存放查询数据的所有列的长度和 */
	size_t row_size;                           /* 存放了在C程序中的所有列（一行）的长度和 */
}db_ifx_cntx_t;

三、接口实现

3.1 连接数据库

/* 连接至INFORMIX数据库 */
int db_ifx_open(db_sourct_t *source, db_ifx_cntx_t **context)
{
    /* 连接数据库 */
    EXEC SQL CONNECT TO :svrname AS :cnname USER :usrname USING :passwd;

    /* 激活指定连接 */
    EXEC SQL SET CONNECTION :cnname;

    /* 开始事务 */
    EXEC SQL BEGIN WORK;
}

说明：
1. 以上函数中的宿主变量svrname（服务名）、usrname（用户名）、passwd（登录密码）、cnname（连接名），这些变量的定义可参考：http://blog.csdn.net/royalapex/article/details/8201699
2. 一个进程中可以有多个数据库连接，各数据库连接是通过连接名进行识别（区别、区分）的

3.2 断开连接

/* 断开与INFORMIX数据库的连接 */
int db_ifx_close(db_ifx_cntx_t *context)
{
    EXEC SQL COMMIT WORK;
    EXEC SQL DISCONNECT :cnname;
}

说明：
1. 在连接数据库时，开启了事务，在断开连接时，应该关闭事务

3.3 提交事务

/* 提交事务 */
int db_ifx_commit(db_ifx_cntx_t *context)
{
    /* 提交事务 */
    EXEC SQL COMMIT WORK;

    /* 开始事务 */
    EXEC SQL BEGIN WORK;
}

说明：
1. 断开连接时，关闭事务；故：提交事务后，需开启新的事务

3.4 回滚事务

/* 回滚事务 */
int db_ifx_rollback(void *context)
{
    /* 回滚事务 */
    EXEC SQL ROLLBACK WORK;

    /* 开始事务 */
    EXEC SQL BEGIN WORK;
}

说明：
1. 断开连接时，关闭事务；故：回滚事务后，需开启新的事务

3.5 动态SQL：非查找语句

/* 执行非查询的动态SQL语句 */
int db_ifx_nquery(const char *sql, db_ifx_cntx_t *context)
{
EXEC SQL BEGIN DECLARE SECTION;
    char sql_stmt[SQL_STMT_MAX_LEN] = {0};
EXEC SQL END DECLARE SECTION;

    snprintf(sql_stmt, sizeof(sql_stmt), "%s", sql);

    /* 准备动态SQL语句 */
    EXEC SQL PREPARE NQUERY_SQLSTMT_ID FROM :sql_stmt;

    /* 执行：非查找SQL */
    EXEC SQL EXECUTE NQUERY_SQLSTMT_ID
}

说明：
1. 执行动态非查询SQL的过程是：PREPARE动态语句， 再执行非查询SQL

3.6 动态SQL：查找语句

/* 执行一个动态查询sql(多行查询) */
int db_ifx_mquery(const char *sql, db_ifx_cntx_t *context)
{
EXEC SQL BEGIN DECLARE SECTION; 
	char sql_stmt[SQL_STMT_MAX_LEN];
EXEC SQL END DECLARE SECTION; 

	int ret = -1;
	ifx_sqlda_t *sqlda = NULL;
	
	snprintf(sql_stmt, sizeof(sql_stmt), "%s", sql);

	/* Step 1: PREPARE查询语句 */
 	EXEC SQL PREPARE QUERY_SQLSTMT_ID FROM :sql_stmt;
	
	/* Step 2: 使用describe函数完成两个功能：
		1. 为sqlda分配空间， 
		2. 获取语句信息，并存放在ifx_sqlda_t结构中 */
 	EXEC SQL DESCRIBE QUERY_SQLSTMT_ID INTO sqlda;

	do
	{
		/* Step 3: 初始化结果集 */
		ret = db_ifx_init_result(context, sqlda);
			
		/* Step 4: 声明和打开游标 */
	 	ret = db_ifx_declare(context);

	 	ret = db_ifx_copen(context);
		
		return sqlda->sqld;
	}while(0);

	db_ifx_free_sqlda(sqlda), sqlda = NULL;

	return -1;
}

说明：
1.DESCRIBE： 为SQLDA分配空间，并获取语句信息，并存放在SQLDA结构中，信息包括：
1. 列数 2. 为struct sqlvar_struct结构分配sqld个空间，但未该结构体中的指针分配空间 3. 数据类型 4. 列长度等已初始化
2. 关于db_ifx_sqlda_t的结构，可参考：http://blog.csdn.net/royalapex/article/details/8205654
3. 关于db_ifx_sqlda_t的使用，可参考：http://blog.csdn.net/royalapex/article/details/8210965
4. QUERY_SQLSTMT_ID：语句ID

3.7 定义游标

/* 声明游标 */
int db_ifx_declare(db_ifx_cntx_t *context)
{
 	EXEC SQL DECLARE QUERY_CURSOR_ID CURSOR FOR QUERY_SQLSTMT_ID;
}

说明：
1.QUERY_CURSOR_ID：游标ID
2. QUERY_SQLSTMT_ID：语句ID

3.8 打开游标

/* 打开游标 */
int db_ifx_copen(db_ifx_cntx_t *context)
{
 	EXEC SQL OPEN QUERY_CURSOR_ID;	
}

说明：
1.QUERY_CURSOR_ID：游标ID

3.9 获取数据（FETCH）

/* 取出一个动态查询sql游标的一条记录  （返回值：0：未取到数据 1：取到一条 -1：失败） */
int db_ifx_fetch(db_ifx_cntx_t *context)
{
	ifx_sqlda_t *sqlda = (ifx_sqlda_t *)context->result;

	/* 1: 执行fetch操作，将数据存放在sqlda结构中 */
	EXEC SQL FETCH QUERY_CURSOR_ID USING DESCRIPTOR sqlda;
	if(SQLNOTFOUND == sqlca.sqlcode)
	{
		return 0;
	}
	else if(0 != sqlca.sqlcode)
	{
		return -1;
	}
	
	return 1;
}

说明：
1.QUERY_CURSOR_ID：游标ID

4.10 关闭游标

/* 释放游标 */
int db_ifx_cclose(db_ifx_cntx_t *context) 
{ 
	/* 关闭游标 */
	EXEC SQL CLOSE QUERY_CURSOR_ID;

	EXEC SQL FREE QUERY_CURSOR_ID;
}

说明：
1.QUERY_CURSOR_ID：游标ID