目前Windows系统上常见的数据库接口包括:
- ODBC(开放数据库互连):访问数据库得先配置数据源
- MFC(Microsoft基础类)ODBC类
- DAO(数据访问对象)
- RDO(远程数据对象)
- OLE DB(对象链接嵌入数据库)
- ADO(ActiveX数据对象)
ODBC(Open Database Connectivity,开放数据库连接)是由Microsoft定义的一种数据库访问标准,它提供了一种标准的数据库访问方法以访问不同数据库提供商的数据库,其本质上是一组数据库访问API.虽然数据库访问有多种方法,但ODBC以其编程相对简单,在实际编程中被广泛使用。 VC++中提供了一组封装了ODBC API的MFC ODBC类,以减少程序代码编写量。在VC++中使用MFC ODBC类访问数据库时,一般都是先配置或选择已有的数据源,再构造CDatabase类对象,打开数据源,用该数据库类对象和SQL(结构化查询语言)可以对库进行访问,再构造CRecordset类或其继承类对象,用数据集类对象和SQL可以实现对库中的表的操作。在VC++中用MFC ODBC类操作SQL Server数据库基本上也是这个思路。
1.配置数据源
在程序中根据用户选择动态配置数据源而不调用ODBC数据源管理器,对于应用程序开发有时是十分必要的。毕竟ODBC数据源管理器对于对数据库不熟悉的用户显的复杂了,且ODBC数据源管理器的界面风格有可能与整个应用程序的界面风格不一致,对于严谨的应用程序开发者来说,这些都是不能容忍的。
配置SQL Server数据源时,必须有SQL Server服务器名和服务器中的目标数据库名(否则打开该数据源时,就会弹出配置数据源对话框或失败)。这与配置Access等数据库的数据源时指定数据库文件的路径不同。
可以通过ODBC API函数SQLBrowseConnect得到本地所有的SQL Server服务器、服务器中的库、语言信息等。其使用方法如下所示:
①得到服务器名
SQLBrowseConnect(hdbc, "DRIVER={SQL Server};", SQL_NTS, BrowseResult, sizeof(BrowseResult), &BrowseResultLen);
其中hdbc是用SQLAllocHandle函数得到的连结句柄,第二个参数是指定连结属性的输入字符串,第三个参数是输入字符串的长度,第四个参数是输出字符串的指针,我们要得到的信息就存于这个字符串中,第五个参数指定输出字符串的长度,第六个参数是实际返回字符串的长度。BrowseResult所指向的函数返回的字符串中含有形如“SERVER:Server={Server_name1,Server_name2,…}”的字符串,其中Server_name1、Server_name2就是SQL Server服务器名。
②得到库名
当用户选定一个服务器之后,可以进一步利用SQLBrowseConnect函数得到服务器中存在的库或语言信息(如果需要的话)。
SQLBrowseConnect(hdbc,"SERVER=Server_name1;UID=sa;PWD=515578;",SQL_NTS, BrowseResult, sizeof(BrowseResult), &BrowseResultLen);
其中UID和PWD是访问该服务器的用户名和密码。这次BrowseResult所指向的函数返回的字符串中含有形如DATABASE:Database={master,model,…}和LANGUAGE:Language={Arabic, Brazilian, English, …}的字符串,其中master、model为服务器中的数据库名。
利用这些得到信息就可以配置SQL Server数据源了:
SQLConfigDataSource(NULL,ODBC_ADD_DSN,"SQL Server","DSN=myDSN\0 SERVER=xhm\0DATABASE=pubs\0\0" ))
作者有幸在网上找到Santosh Rao编写的CSQLInfoEnumerator类,该类有 EnumerateSQLServers、EnumerateDatabase、EnumerateDatabaseLanguage三个成员函数,其封装了SQLBrowseConnect函数并进行相应的字符处理,大大简化了SQLBrowseConnect函数的使用。
2.与数据源建立连接
如果使用ODBC API函数进行连结,函数SQLConnect、SQLDriverConnect和SQLBrowseConnect都可以实现。其中SQLConnect函数用于给定所有参数直接建立与数据源的连接;SQLDriverConnect用于给定了部分连接参数,并弹出数据源浏览窗口与用户交互,获得足够的参数后建立与数据源的连接;而SQLBrowseConnect是通过迭代获取连结参数再进行连接,其使用如前所述。
MFC为连接数据源提供了一个数据库类CDatabase,通过它我们可以非常方便地与数据源建立连结:
//m_db是CDatabase的对象
//m_szUserId,m_szPassword是CString对象,为访问数据源的用户名和密码
CString str;
str = _T("DSN=xhmtest;UID=")+m_szUserId+_T(";PWD=")+m_szPassword;
if (! m_db.OpenEx(str, CDatabase::noOdbcDialog ) ){
AfxMessageBox("打开数据源失败");
}
另外,如果我们想对数据源进行操作,就可以利用打开的CDatabase对象执行SQL语句实现。如新建一张表:
str = "CREATE TABLE TableDemo (Column1TEXT, Column2 NUMBER)";
m_db.ExecuteSQL(sSql);
3.得到数据库的结构信息
在VC++中可以单独利用ODBC API获取数据库的结构信息,但方法非常复杂,各种参数也不易理解,且返回的结果不易获取。MFC中也没有为应用程序开发者得到数据库结构信息而提供单独的类。但是我们还是可以通过一些已有的方法方便地获得数据库的结构信息。
3.1 得到数据库中的表
利用ODBC API函数SQLTables可以得到数据库中的表信息,但使用不易。
在MSDN的sample中有一个catalog例程,它示范了如果得到一个数据库的表信息和表中的字段信息,该程序中有两个非常实用的类:Ctables和Ccolumns.其中CTables继承CRecordset类,通过非常巧妙的方法封装了SQLTables函数,并将结果集存于CRecordset类,方便获取。
在程序中我们可以这样应用:
//m_db是已经打开的CDatabse对象,
//m_strTableOwner是CComboBox对象
CTables rs(&m_db);
rs.Open(NULL, NULL, NULL, "TABLE");
CString strTableRef;
m_combTable.ResetContent();
while (!rs.IsEOF())
{
strTableRef = _T("[");
if (!rs.m_strTableOwner.IsEmpty())
strTableRef += rs.m_strTableOwner + _T("].[");
strTableRef += rs.m_strTableName + _T("]");
m_combTable.AddString(strTableRef);
rs.MoveNext();
}
rs.Close();
在CTables对象Open方法第四个能数指定“TABLE”是指返回库中的表,当该参数为“SYSTEM TABLE”时返回系统表,当为NULL时,返回所有表。
3.2 得到表中字段结构
得到表中字段结构有三种具体实现方式:
①直接利用ODBC API 函数SQLColumn;其实现也同样复杂。
②利用前面提到的封装了SQLColumns函数的CColumns类;其使用方法与CTables类似,其成员变量m_strColumnName即为字段名
③利用CRecordset类的成员函数。MFC在CRecordset类中提供了获取表结构信息方法,使用非常方便。(但很奇怪为什么CDatabase类没有获取库结构信息的类方法?)
我们以利用CRecodrset为例简单说明怎样得到表结构。假设现在要得到用户在CComboBox对象中所选表的所有字段名,并将它埴入一个CListCtrl对象(其View属性被设为Report)的列名中去:
//m_strTableOwner和上同,为CComboBox对象
//m_listData为ClistCtrl对象
CRecordset rs
CODBCFieldInfo info;
CString strSQL;
m_combTable.GetLBText(m_combTable.GetCurSel(), strSQL);
strSQL = _T("SELECT * FROM ") + strSQL;
rs.Open(Open(CRecordset::snapshot, strSQL, CRecordset::readOnly);
int nColumns = rs.GetODBCFieldCount();
for (int nNum = 0; nNum < nColumns; nNum++)
{
prs->GetODBCFieldInfo(nNum, info);
m_listData.InsertColumn(nNum, info.m_strName, LVCFMT_LEFT, 80)
}
另外,我们可以利用CRecordSet::GetFieldValue函数通过指定列名或列序数得到记录集中游标所指记录的值,通过CRecordset::AddNew、CRecordset::CancelUpdate、CRecordset::Delete、CRecordset::Edit、CRecordset::Update等函数操作CRecordset打开的表。
一、ADO简介
ADO(ActiveX Data Object)是Microsoft数据库应用程序开发的新接口,是建立在OLE DB之上的高层数据库访问技术,请不必为此担心,即使你对OLE DB,COM不了解也能轻松对付ADO,因为它非常简单易用,甚至比你以往所接触的ODBC API、DAO、RDO都要容易使用,并不失灵活性。本文将详细地介绍在VC下如何使用ADO来进行数据库应用程序开发,并给出示例代码。
本文示例代码
二、基本流程
万事开头难,任何一种新技术对于初学者来说最重要的还是“入门”,掌握其要点。让我们来看看ADO数据库开发的基本流程吧!
(1)初始化COM库,引入ADO库定义文件
(2)用Connection对象连接数据库
(3)利用建立好的连接,通过Connection、Command对象执行SQL命令,或利用Recordset对象取得结果记录集进行查询、处理。
(4)使用完毕后关闭连接释放对象。
准备工作:
为了大家都能测试本文提供的例子,我们采用Access数据库,您也可以直接在我们提供的示例代码中找到这个test.mdb。
下面我们将详细介绍上述步骤并给出相关代码。
【1】COM库的初始化
我们可以使用AfxOleInit()来初始化COM库,这项工作通常在CWinApp::InitInstance()的重载函数中完成,请看如下代码:
BOOL CADOTest1App::InitInstance()
{
AfxOleInit();
......
【2】用#import指令引入ADO类型库
我们在stdafx.h中加入如下语句:(stdafx.h这个文件哪里可以找到?你可以在FileView中的Header Files里找到)
#import "c:\program files\common files\system\ado\msado15.dll" no_namespace rename("EOF","adoEOF")
这一语句有何作用呢?其最终作用同我们熟悉的#include类似,编译的时候系统会为我们生成msado15.tlh,ado15.tli两个C++头文件来定义ADO库。
几点说明:
(1) 您的环境中msado15.dll不一定在这个目录下,请按实际情况修改
(2) 在编译的时候肯能会出现如下警告,对此微软在MSDN中作了说明,并建议我们不要理会这个警告。
msado15.tlh(405) : warning C4146: unary minus operator applied to unsigned type, result still unsigned
【3】创建Connection对象并连接数据库
首先我们需要添加一个指向Connection对象的指针:
_ConnectionPtr m_pConnection;
下面的代码演示了如何创建Connection对象实例及如何连接数据库并进行异常捕捉。
BOOL CADOTest1Dlg::OnInitDialog()
{
CDialog::OnInitDialog();
HRESULT hr;
try
{
hr = m_pConnection.CreateInstance("ADODB.Connection");///创建Connection对象
if(SUCCEEDED(hr))
{
hr = m_pConnection->Open("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=test.mdb","","",adModeUnknown);///连接数据库
///上面一句中连接字串中的Provider是针对ACCESS2000环境的,对于ACCESS97,需要改为:Provider=Microsoft.Jet.OLEDB.3.51;
}
}
catch(_com_error e)///捕捉异常
{
CString errormessage;
errormessage.Format("连接数据库失败!\r错误信息:%s",e.ErrorMessage());
AfxMessageBox(errormessage);///显示错误信息
}
在这段代码中我们是通过Connection对象的Open方法来进行连接数据库的,下面是该方法的原型
HRESULT Connection15::Open ( _bstr_t ConnectionString, _bstr_t UserID, _bstr_t Password, long Options )
ConnectionString为连接字串,UserID是用户名, Password是登陆密码,Options是连接选项,用于指定Connection对象对数据的更新许可权,
Options可以是如下几个常量:
adModeUnknown:缺?gt;>5鼻暗男砜扇ㄎ瓷柚?br>adModeRead:只读
adModeWrite:只写
adModeReadWrite:可以读写
adModeShareDenyRead:阻止其它Connection对象以读权限打开连接
adModeShareDenyWrite:阻止其它Connection对象以写权限打开连接
adModeShareExclusive:阻止其它Connection对象以读写权限打开连接
adModeShareDenyNone:阻止其它Connection对象以任何权限打开连接
我们给出一些常用的连接方式供大家参考:
(1)通过JET数据库引擎对ACCESS2000数据库的连接
m_pConnection->Open("Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\\test.mdb","","",adModeUnknown);
(2)通过DSN数据源对任何支持ODBC的数据库进行连接:
m_pConnection->Open("Data Source=adotest;UID=sa;PWD=;","","",adModeUnknown);
(3)不通过DSN对SQL SERVER数据库进行连接:
m_pConnection->Open("driver={SQL Server};Server=127.0.0.1;DATABASE=vckbase;UID=sa;PWD=139","","",adModeUnknown);
其中Server是SQL服务器的名称,DATABASE是库的名称
Connection对象除Open方法外还有许多方法,我们先介绍Connection对象中两个有用的属性ConnectionTimeOut与State
ConnectionTimeOut用来设置连接的超时时间,需要在Open之前调用,例如:
m_pConnection->ConnectionTimeout = 5;///设置超时时间为5秒
m_pConnection->Open("Data Source=adotest;","","",adModeUnknown);
State属性指明当前Connection对象的状态,0表示关闭,1表示已经打开,我们可以通过读取这个属性来作相应的处理,例如:
if(m_pConnection->State)
m_pConnection->Close(); ///如果已经打开了连接则关闭它
【4】执行SQL命令并取得结果记录集
为了取得结果记录集,我们定义一个指向Recordset对象的指针:_RecordsetPtr m_pRecordset;
并为其创建Recordset对象的实例: m_pRecordset.CreateInstance("ADODB.Recordset");
SQL命令的执行可以采用多种形式,下面我们一进行阐述。
(1)利用Connection对象的Execute方法执行SQL命令
Execute方法的原型如下所示:
_RecordsetPtr Connection15::Execute ( _bstr_t CommandText, VARIANT * RecordsAffected, long Options ) 其中CommandText是命令字串,通常是SQL命令。参数RecordsAffected是操作完成后所影响的行数, 参数Options表示CommandText中内容的类型,Options可以取如下值之一:
adCmdText:表明CommandText是文本命令
adCmdTable:表明CommandText是一个表名
adCmdProc:表明CommandText是一个存储过程
adCmdUnknown:未知
Execute执行完后返回一个指向记录集的指针,下面我们给出具体代码并作说明。
_variant_t RecordsAffected;
///执行SQL命令:CREATE TABLE创建表格users,users包含四个字段:整形ID,字符串username,整形old,日期型birthday
m_pConnection->Execute("CREATE TABLE users(ID INTEGER,username TEXT,old INTEGER,birthday DATETIME)",&RecordsAffected,adCmdText);
///往表格里面添加记录
m_pConnection->Execute("INSERT INTO users(ID,username,old,birthday) VALUES (1, 'Washington',25,'1970/1/1')",&RecordsAffected,adCmdText);
///将所有记录old字段的值加一
m_pConnection->Execute("UPDATE users SET old = old+1",&RecordsAffected,adCmdText);
///执行SQL统计命令得到包含记录条数的记录集
m_pRecordset = m_pConnection->Execute("SELECT COUNT(*) FROM users",&RecordsAffected,adCmdText);
_variant_t vIndex = (long)0;
_variant_t vCount = m_pRecordset->GetCollect(vIndex);///取得第一个字段的值放入vCount变量
m_pRecordset->Close();///关闭记录集
CString message;
message.Format("共有%d条记录",vCount.lVal);
AfxMessageBox(message);///显示当前记录条数
(2)利用Command对象来执行SQL命令
_CommandPtr m_pCommand;
m_pCommand.CreateInstance("ADODB.Command");
_variant_t vNULL;
vNULL.vt = VT_ERROR;
vNULL.scode = DISP_E_PARAMNOTFOUND;///定义为无参数
m_pCommand->ActiveConnection = m_pConnection;///非常关键的一句,将建立的连接赋值给它
m_pCommand->CommandText = "SELECT * FROM users";///命令字串
m_pRecordset = m_pCommand->Execute(&vNULL,&vNULL,adCmdText);///执行命令,取得记录集
在这段代码中我们只是用Command对象来执行了SELECT查询语句,Command对象在进行存储过程的调用中能真正体现它的作用。下次我们将详细介绍。
(3)直接用Recordset对象进行查询取得记录集
例如
m_pRecordset->Open("SELECT * FROM users",_variant_t((IDispatch *)m_pConnection,true),adOpenStatic,adLockOptimistic,adCmdText);
Open方法的原型是这样的:
HRESULT Recordset15::Open ( const _variant_t & Source, const _variant_t & ActiveConnection, enum CursorTypeEnum CursorType, enum LockTypeEnum LockType, long Options )
其中:
①Source是数据查询字符串
②ActiveConnection是已经建立好的连接(我们需要用Connection对象指针来构造一个_variant_t对象)
③CursorType光标类型,它可以是以下值之一,请看这个枚举结构:
enum CursorTypeEnum
{
adOpenUnspecified = -1,///不作特别指定
adOpenForwardOnly = 0,///前滚静态光标。这种光标只能向前浏览记录集,比如用MoveNext向前滚动,这种方式可以提高浏览速度。但诸如BookMark,RecordCount,AbsolutePosition,AbsolutePage都不能使用
adOpenKeyset = 1,///采用这种光标的记录集看不到其它用户的新增、删除操作,但对于更新原有记录的操作对你是可见的。
adOpenDynamic = 2,///动态光标。所有数据库的操作都会立即在各用户记录集上反应出来。
adOpenStatic = 3///静态光标。它为你的记录集产生一个静态备份,但其它用户的新增、删除、更新操作对你的记录集来说是不可见的。
};
④LockType锁定类型,它可以是以下值之一,请看如下枚举结构:
enum LockTypeEnum
{
adLockUnspecified = -1,///未指定
adLockReadOnly = 1,///只读记录集
adLockPessimistic = 2,悲观锁定方式。数据在更新时锁定其它所有动作,这是最安全的锁定机制
adLockOptimistic = 3,乐观锁定方式。只有在你调用Update方法时才锁定记录。在此之前仍然可以做数据的更新、插入、删除等动作
adLockBatchOptimistic = 4,乐观分批更新。编辑时记录不会锁定,更改、插入及删除是在批处理模式下完成。
};
⑤Options请参考本文中对Connection对象的Execute方法的介绍
【5】记录集的遍历、更新
根据我们刚才通过执行SQL命令建立好的users表,它包含四个字段:ID,username,old,birthday
以下的代码实现:打开记录集,遍历所有记录,删除第一条记录,添加三条记录,移动光标到第二条记录,更改其年龄,保存到数据库。
_variant_t vUsername,vBirthday,vID,vOld;
_RecordsetPtr m_pRecordset;
m_pRecordset.CreateInstance("ADODB.Recordset");
m_pRecordset->Open("SELECT * FROM users",_variant_t((IDispatch*)m_pConnection,true),adOpenStatic,adLockOptimistic,adCmdText);
while(!m_pRecordset->adoEOF)///这里为什么是adoEOF而不是EOF呢?还记得rename("EOF","adoEOF")这一句吗?
{
vID = m_pRecordset->GetCollect(_variant_t((long)0));///取得第1列的值,从0开始计数,你也可以直接给出列的名称,如下一行
vUsername = m_pRecordset->GetCollect("username");///取得username字段的值
vOld = m_pRecordset->GetCollect("old");
vBirthday = m_pRecordset->GetCollect("birthday");
///在DEBUG方式下的OUTPUT窗口输出记录集中的记录
if(vID.vt != VT_NULL && vUsername.vt != VT_NULL && vOld.vt != VT_NULL && vBirthday.vt != VT_NULL)
TRACE("id:%d,姓名:%s,年龄:%d,生日:%s\r",vID.lVal,(LPCTSTR)(_bstr_t)vUsername,vOld.lVal,(LPCTSTR)(_bstr_t)vBirthday);
m_pRecordset->MoveNext();///移到下一条记录
}
m_pRecordset->MoveFirst();///移到首条记录
m_pRecordset->Delete(adAffectCurrent);///删除当前记录
///添加三条新记录并赋值
for(int i=0;i<3;i++)
{
m_pRecordset->AddNew();///添加新记录
m_pRecordset->PutCollect("ID",_variant_t((long)(i+10)));
m_pRecordset->PutCollect("username",_variant_t("叶利钦"));
m_pRecordset->PutCollect("old",_variant_t((long)71));
m_pRecordset->PutCollect("birthday",_variant_t("1930-3-15"));
}
m_pRecordset->Move(1,_variant_t((long)adBookmarkFirst));///从第一条记录往下移动一条记录,即移动到第二条记录处
m_pRecordset->PutCollect(_variant_t("old"),_variant_t((long)45));///修改其年龄
m_pRecordset->Update();///保存到库中
【6】关闭记录集与连接
记录集或连接都可以用Close方法来关闭
m_pRecordset->Close();///关闭记录集
m_pConnection->Close();///关闭连接