一个好用的ODBC数据库类CMYODBC

一、引言

感觉MFC的CRecordset类不是很好用，因为我们要想使用的话必须为每个查询从CRecordset类派生出一个新类，或者进行动态数据交换。在VC知识库第六期上面有一篇介绍"单独使用CRecordset"文章，可是上面的CRecordset打开方式只能使用CRecordset::forwardOnly，游标只能向前滚动，而且用这种方式，你根本无法从打开的记录集中获得本次查询得到了有多少列。有一次在应用的时候，我只好通过捕获CRecordset::GetFieldValue（）的异常来得到查询的结果有多少列。为了使用的方便，我自己写了一个数据库类CMYODBC，它是用ODBC API写的，它支持各种sql语句，支持事务处理。它最好的地方在于，对于查询的记录集实现了动态绑定，这是通过类CODBCSet来实现的。要说明的是，这两个类可以说比较简单，两个类的代码量很少，所以建议感兴趣的朋友看一下它的代码，下图是本代码运行效果图：

二、原理

其实无论是使用ODBC API还是使用ORACLE的OCI（对于ORACLE的OCI感兴趣的朋友，欢迎一起探讨，OCI的功能很强大，支持动态绑定，支持pl/sql，它的类的封装和CMYODBC很相似，用它来代替ODBC编程，可以解决ODBC的效率问题）其过程都很相似，一般分为以下几个过程：

1 初始化工作环境

2 连接数据源

3 操作数据源

4 检索结果集

5 更新结果集

6 事务处理

7 断开连接，释放各种句柄

大家都知道在使用CDatabase时候，如果要执行的是select语句的话，那么要通过CRecordset来检索结果集，而CRecordset类要我们先选择表等来先进行绑定，这样我们使用的时候很不方便，其实我们根本不需要这样做，而且我们也不需要知道这次执行的是关于那个数据库那张表的sql语句，因为在执行完SQLExecDirect()后，可以通过调用SQLNumResultCols() 、SQLColAttribute()等函数来获得执行的结果的很多属性，如这次执行的结果集是多少列、每列的字段名、列的类型等，然后根据类型可以动态分配内存，然后在用这些内存去绑定，最后能过SQLFetch()来得到结果集。在CMYODBC这个类里是通过CODBCSet类应用上面的原理来实现自动绑定的。

下面介绍一下类CMYODBC的使用方法：

源代码下载

1 　通过调用ConnectDB(const char *cpServerName, const char *cpUserName, const char *cpPassword)函数来联接数据库。其中的参数意义如下：

cpServerName-----ODBC数据源名

cpUserName-------用户名

cpPassword-----口令

2 　通过调用ExeSqlDirect(const char *cpSqlStmt)函数可以执行一些操作数据源的语句，如修改、删除语句等。其中的参数意义如下： cpSqlStmt------你要执行的sql语句，如delete from emp where deptno < 20

3 　如果要执行事务的话，调用ExecTrans(CStringList &strSqlList)函数，其中的参数 strSqlList表示你要执行的一系列sql语句。

4　如果要执行select语句的话，通过下面的步骤：

I 声明一个CODBCSet　对象，如 CODBCSet rSet;

II然后调用函数PrepareSql(const char *cpSql, CODBCSet &rset)，其中的参数的意义如下：

cpSql----代表要执行的select语句

rset-----表示一个CODBCSet的引用，你要把上面声明的对象传递进去。

III调用FetchData（）函数来取得结果集。

5 通过调用函数DisConnect（）断开和数据源的连接。

三、实例练习

下面就通过上面的例子一起来看一下这个类到底怎么样，为了方便，我建了一个简单的access数据库test.mdb,在这个数据库中也只有一张表emp，它有三个字段。在下面的工程的InitInstance ()中，通过代码为它自动建立了一个叫做"daliu"的ODBC数据源。

步骤一：

新建一个基于对话框的工程，命名为demo1,打开stdafx.h文件，加入#include 从例子中把MyODBC.h,MyODBC.cpp, ODBCSet.h, ODBCSet.cpp复制到这个工程的目录下，并且加入到工程中，方法是菜单project->add to project->files，选择这四个文件就可以了。复制test.mdb文件，把它加入到这个工程的debug目录下。也可以是其它的目录，只要和你的执行程序在同一个目录就可以了。

步骤二：

参照上面的对话框，在上面加入按钮和一个ClistCtrl控件，在classwizard上面关联控件的变量ClistCtrl关联m_list控件，为三个EDIT分别关联CString类型的m_strID，m_strName，m_strJob.

步骤三：

在CDemo1App::InitInstance()的最上面，加入下面的代码，实现自动ODBC数据源的增加。

char path[MAX_PATH] = {''\0''};
GetModuleFileName(NULL,path,MAX_PATH);//得到执行文件名
m_strExePath.Format("%s", path);
int iPosition;
iPosition = m_strExePath.ReverseFind(''\\'');
m_strExePath = m_strExePath.Left(iPosition + 1);
CString strAccessPath = m_strExePath + "test.mdb";//得到这个数据库文件的路径
int iLen = strAccessPath.GetLength();
char cpConfig[MAX_PATH];
//由于在这个联结串中有靠\0来分开数据源每个配置信息项的，所以只好用下面的笨方法了。
strcpy(cpConfig, "DSN=daliu\0");
strcpy(cpConfig + 10, "DBQ=");
strcpy(cpConfig + 14, strAccessPath);
strcpy(cpConfig + 14 + iLen, "\0");
strcpy(cpConfig + 15 + iLen, "DEFAULTDIR=");
strcpy(cpConfig + 15 + iLen + 11, m_strExePath);
strcpy(cpConfig + 25 + iLen + m_strExePath.GetLength(), "\0\0");
 
if(!SQLConfigDataSource(NULL,ODBC_ADD_SYS_DSN,
"Microsoft Access Driver (*.mdb)\0",cpConfig))//设置odbc数据源

步骤四：

设置Clistctrl控件的风格，为他加入图象资源。首先要在CDemo1Dlg中加入#include"ODBCSet.h"#include"MyODBC.h"，然后在CDemo1Dlg中添加成员变量CimageList ImageList;添加成员函数BOOL ShowData() 在CDemo1Dlg::OnInitDialog()中加入下面的代码：

ImageList.Create(16,16,ILC_COLOR8,0,5);
ImageList.Add(AfxGetApp()->LoadIcon(IDI_ICON1));
DWORD dwStyle=GetWindowLong(m_list.GetSafeHwnd(),GWL_STYLE);
dwStyle |= LVS_REPORT;
SetWindowLongA(m_list.GetSafeHwnd(),GWL_STYLE,dwStyle);
m_list.SetExtendedStyle(LVS_EX_HEADERDRAGDROP|LVS_EX_FULLROWSELECT|LVS_EX_TRACKSELECT);
m_list.SetImageList(&ImageList, LVSIL_SMALL);
 
ShowData()//这个函数是用来向列表框中插入数据的。

下面我们来分析一下ShowData()函数，它是使用CMYODBC的关键。

BOOL CDemo1Dlg::ShowData()
{
int i = 0, iCount;
m_list.DeleteAllItems();
//首先清空listview
iCount = m_list.GetHeaderCtrl()->GetItemCount();
for(i = 0; i < iCount; i++)
{
m_list.DeleteColumn(0);
}
for(i = 0; i < iCount; i++)
{
m_list.GetHeaderCtrl()->DeleteItem(0);
}
/*上面的代码用于清空ClistCtrl控件中项，上面的两个循环并不能合成一个，你可以试一下*/
CString strSql;
strSql = "select * from emp";
//sql查询语句
CMyODBC db;
//声明CMyODBC类的实例
CODBCSet set;
//声明CODBCSet类的实例
/*联接数据库，由于access数据库没有设定用户和口//令，所以它们两个就用空的字符串代替*/
db.ConnectDB("daliu","", "");
/*准备sql语句，你可以跟踪一下，在这个函数中完成动态的绑定，得到共有几列，每列的名称等*/
db.PrepareSql(strSql, set);
 
for(i = 0; i < set.GetCols(); i++)
/*set.GetCols()得到本次查询得到了几列。*/
{
m_list.InsertColumn(i, set.m_coldatafmt[i].name,LVCFMT_CENTER,80);
}
/*上面的循环用于插入列, m_coldatafmt是一个COL_DATAFMT_ODBC的结构，
在我们调用db.PrepareSql（）后，它就含有了每个列的名称，字段数据类型，字段数据长度信息。*/
 
/*下面的循环用于向列表框中插入数据， set.m_coldata是一个COL_DATA_ODBC的结构，
当含有当前行的数据值，数据值的长度信息，这样就实现了从记录集中取数据的功能。*/
int iRow = 0;
while(db.FetchData())
/*每次取回一条记录。*/
{
for(i = 0; i < set.GetCols(); i++)
{
if(i == 0)
{
m_list.InsertItem(iRow, set.m_coldata[0].value);
}
else
{
m_list.SetItemText(iRow, i, set.m_coldata[i].value);
}
}
iRow++;
}
set.Empty();
/*清空记录集*/
db.DisConnect();
/*断开连接*/
return TRUE;   
}

下面我们再来看一个如何插入一条记录：

void CDemo1Dlg::OnBtnadd()
{
UpdateData(TRUE);
CString strSql;
strSql.Format("insert into emp values(%d,''%s'',''%s'')",atoi(m_strID), m_strName, m_strJob);
CMyODBC db;
db.ConnectDB("daliu","", "");
//连接数据库
db.ExeSqlDirect(strSql);
//执行sql语句
db.DisConnect();
//断开连接
this->ShowData();
//刷新数据
}

响应其它的按钮的函数就不一一写了，和上面的都差不多，希望通过它能给我们用VC的开发数据库工程带来一些方便。

四、总结

ODBC有很多用处，例如我们可以把很多信息按照一定的格式保存在文本中（因为在商业上用别人的数据库都是要买的），然后通过ODBC把这些文本文件映射成表，这些文件的目录就成为一个数据库，这些我们就可以很方便的对这些文件的内容通过sql来操作查询，这样开发的效率会高一些，而且是在本地，速度完全可以满足。