一个好用的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来操作查询,这样开发的效率会高一些,而且是在本地,速度完全可以满足。 |