一个好用的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来操作查询，这样开发的效率会高一些，而且是在本地，速度完全可以满足。
【推广】 免费学中医，健康全家人
原文地址：https://www.cnblogs.com/Dageking/p/2957151.html