一个好用的ODBC数据库类CMYODBC

 

一个好用的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数据源的增加。

01.char path[MAX_PATH] = {''\0''};

02.GetModuleFileName(NULL,path,MAX_PATH);//得到执行文件名

03.m_strExePath.Format("%s", path);

04.int iPosition;

05.iPosition = m_strExePath.ReverseFind(''\\'');

06.m_strExePath = m_strExePath.Left(iPosition + 1);

07.CString strAccessPath = m_strExePath + "test.mdb";//得到这个数据库文件的路径

08.int iLen = strAccessPath.GetLength();

09.char cpConfig[MAX_PATH];

10.//由于在这个联结串中有靠\0来分开数据源每个配置信息项的，所以只好用下面的笨方法了。

11.strcpy(cpConfig, "DSN=daliu\0");

12.strcpy(cpConfig + 10, "DBQ=");

13.strcpy(cpConfig + 14, strAccessPath);

14.strcpy(cpConfig + 14 + iLen, "\0");

15.strcpy(cpConfig + 15 + iLen, "DEFAULTDIR=");

16.strcpy(cpConfig + 15 + iLen + 11, m_strExePath);

17.strcpy(cpConfig + 25 + iLen + m_strExePath.GetLength(), "\0\0");

18. 

19.if(!SQLConfigDataSource(NULL,ODBC_ADD_SYS_DSN,

20."Microsoft Access Driver (*.mdb)\0",cpConfig))//设置odbc数据源

步骤四：

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

01.ImageList.Create(16,16,ILC_COLOR8,0,5);

02.ImageList.Add(AfxGetApp()->LoadIcon(IDI_ICON1));

03.DWORD dwStyle=GetWindowLong(m_list.GetSafeHwnd(),GWL_STYLE);

04.dwStyle |= LVS_REPORT;

05.SetWindowLongA(m_list.GetSafeHwnd(),GWL_STYLE,dwStyle);

06.m_list.SetExtendedStyle(LVS_EX_HEADERDRAGDROP|LVS_EX_FULLROWSELECT|LVS_EX_TRACKSELECT);

07.m_list.SetImageList(&ImageList, LVSIL_SMALL);

08. 

09.ShowData()//这个函数是用来向列表框中插入数据的。

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

01.BOOL CDemo1Dlg::ShowData()

02.{

03.int i = 0, iCount;

04.m_list.DeleteAllItems();

05.//首先清空listview

06.iCount = m_list.GetHeaderCtrl()->GetItemCount();

07.for(i = 0; i < iCount; i++)

08.{

09.m_list.DeleteColumn(0);

10.}

11.for(i = 0; i < iCount; i++)

12.{

13.m_list.GetHeaderCtrl()->DeleteItem(0);

14.}

15./*上面的代码用于清空ClistCtrl控件中项，上面的两个循环并不能合成一个，你可以试一下*/

16.CString strSql;

17.strSql = "select * from emp";

18.//sql查询语句

19.CMyODBC db;

20.//声明CMyODBC类的实例

21.CODBCSet set;

22.//声明CODBCSet类的实例

23./*联接数据库，由于access数据库没有设定用户和口//令，所以它们两个就用空的字符串代替*/

24.db.ConnectDB("daliu","", "");

25./*准备sql语句，你可以跟踪一下，在这个函数中完成动态的绑定，得到共有几列，每列的名称等*/

26.db.PrepareSql(strSql, set);

27. 

28.for(i = 0; i < set.GetCols(); i++)

29./*set.GetCols()得到本次查询得到了几列。*/

30.{

31.m_list.InsertColumn(i, set.m_coldatafmt[i].name,LVCFMT_CENTER,80);

32.}

33./*上面的循环用于插入列, m_coldatafmt是一个COL_DATAFMT_ODBC的结构，

34.在我们调用db.PrepareSql（）后，它就含有了每个列的名称，字段数据类型，字段数据长度信息。*/

35. 

36./*下面的循环用于向列表框中插入数据， set.m_coldata是一个COL_DATA_ODBC的结构，

37.当含有当前行的数据值，数据值的长度信息，这样就实现了从记录集中取数据的功能。*/

38.int iRow = 0;

39.while(db.FetchData())

40./*每次取回一条记录。*/

41.{

42.for(i = 0; i < set.GetCols(); i++)

43.{

44.if(i == 0)

45.{

46.m_list.InsertItem(iRow, set.m_coldata[0].value);

47.}

48.else

49.{

50.m_list.SetItemText(iRow, i, set.m_coldata[i].value);

51.}

52.}

53.iRow++;

54.}

55.set.Empty();

56./*清空记录集*/

57.db.DisConnect();

58./*断开连接*/

59.return TRUE;   

60.}

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

01.void CDemo1Dlg::OnBtnadd()

02.{

03.UpdateData(TRUE);

04.CString strSql;

05.strSql.Format("insert into emp values(%d,''%s'',''%s'')",atoi(m_strID), m_strName, m_strJob);

06.CMyODBC db;

07.db.ConnectDB("daliu","", "");

08.//连接数据库

09.db.ExeSqlDirect(strSql);

10.//执行sql语句

11.db.DisConnect();

12.//断开连接

13.this->ShowData();

14.//刷新数据

15.}

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

四、总结

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