读书笔记——数据库的ADO开发总结

基本上是对 ADO+开发指南.pdf 的摘抄和总结，以及个人心得。

文章末尾有《ADO+开发指南.pdf》的资源下载，附带个人批注。

------------------------------------------------------------------------------------

ADO(ActiveX Data Object)是Microsoft数据库应用程序开发的新接口，是建立在OLE DB之上的高层数据库访问技术。（话说已经不是新的了？）

ADO数据库开发的基本流程：

(1)初始化COM库，引入ADO库定义文件

(2)用Connection对象连接数据库

(3)利用建立好的连接，通过Connection、Command对象执行SQL命令，或利用Recordset对象取得结果记录集进行查询、处理。

(4)使用完毕后关闭连接释放对象。

1 初始化

AfxOleInit();

2 引入ADO类型库（路径是具体情况而定）

#import "c:\program files\common files\system\ado\msado15.dll"

no_namespace rename("EOF","adoEOF")

3 创建Connection对象并连接数据库

_ConnectionPtr m_pConnection;

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);///连接数据库
    }
}
catch(_com_error e)///捕捉异常
{
    CString errormessage;
    errormessage.Format("连接数据库失败!\r\n错误信息:%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:缺省。当前的许可权未设置

adModeRead:只读

adModeWrite:只写

adModeReadWrite:可以读写

adModeShareDenyRead:阻止其它Connection对象以读权限打开连接

adModeShareDenyWrite:阻止其它Connection对象以写权限打开连接

adModeShareExclusive:阻止其它Connection对象以读写权限打开连接

adModeShareDenyNone:阻止其它Connection对象以任何权限打开连接

这里要注意的是连接字串是可以用udl文件来生成。这个文中没有说，而是列举了许多连接串的例子，很是误导人。

Connection对象中两个有用的属性ConnectionTimeOut与State。

//设置连接的超时时间在Open之前调用
m_pConnection->ConnectionTimeout = 5;///设置超时时间为5秒
m_pConnection->Open("Data Source=adotest;","","",adModeUnknown);

//指明当前Connection对象的状态，0表示关闭，1表示已经打开
if(m_pConnection->State)
m_pConnection->Close(); ///如果已经打开了连接则关闭它

4 执行SQL命令并取得结果记录集

定义一个指向Recordset对象的指针，并为其创建Recordset对象的实例:

_RecordsetPtr m_pRecordset;
m_pRecordset.CreateInstance("ADODB.Recordset");

SQL命令的执行可以采用多种形式

(1)利用Connection对象的Execute方法

原型如下

_RecordsetPtr Connection15::Execute ( _bstr_t CommandText, VARIANT * RecordsAffected, long Options )

其中返回值是一个指向记录集的指针，CommandText是命令字串，通常是SQL命令。参数RecordsAffected是操作完成后所影响的行数, 参数Options表示CommandText中内容的类型，Options可以取如下值之一：

adCmdText:表明CommandText是文本命令

adCmdTable:表明CommandText是一个表名

adCmdProc:表明CommandText是一个存储过程

adCmdUnknown:未知

_variant_t RecordsAffected;
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);
m_pConnection->Execute("UPDATE users SET old = old+1",&RecordsAffected,adCmdText);

_variant_t RecordsAffected;
m_pRecordset = m_pConnection->Execute("SELECT COUNT(*) FROM users",&RecordsAffected,adCmdText);
_variant_t vIndex = (long)0;
_variant_t vCount = m_pRecordset->GetCollect(vIndex);
m_pRecordset->Close();///关闭记录集
CString message;
message.Format("共有%d条记录",vCount.lVal);
AfxMessageBox(message);///显示当前记录条数

(2)利用Command对象来执行SQL命令

Command对象在进行存储过程的调用中能真正体现它的作用。

_CommandPtr m_pCommand;
m_pCommand.CreateInstance("ADODB.Command");
_variant_t vNULL;
vNULL.vt = VT_ERROR;
vNULL.scode = DISP_E_PARAMNOTFOUND;///定义为无参数
<span style="color:#FF0000;">m_pCommand->ActiveConnection = m_pConnection;</span>///非常关键的一句，将建立的连接赋值给它
m_pCommand->CommandText = "SELECT * FROM users";///命令字串
m_pRecordset = m_pCommand->Execute(&vNULL,&vNULL,adCmdText);///执行命令，取得记录集

(3)直接用Recordset对象进行查询取得记录集

原型如下

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是光标类型，LockType是锁定类型，Options是连接选项。请看下面的枚举结构

enum CursorTypeEnum
{
adOpenUnspecified = -1,///不作特别指定
adOpenForwardOnly = 0,///前滚静态光标。这种光标只能向前浏览记录集，比如用MoveNext向前滚动,这种方式可以提高浏览速度。但诸如BookMark,RecordCount,AbsolutePosition,AbsolutePage都不能使用
adOpenKeyset = 1,///采用这种光标的记录集看不到其它用户的新增、删除操作，但对于更新原有记录的操作对你是可见的。
adOpenDynamic = 2,///动态光标。所有数据库的操作都会立即在各用户记录集上反应出来。
adOpenStatic = 3///静态光标。它为你的记录集产生一个静态备份，但其它用户的新增、删除、更新操作对你的记录集来说是不可见的。
};
enum LockTypeEnum
{
adLockUnspecified = -1,///未指定
adLockReadOnly = 1,///只读记录集
adLockPessimistic = 2,悲观锁定方式。数据在更新时锁定其它所有动作，这是最安全的锁定机制
adLockOptimistic = 3,乐观锁定方式。只有在你调用Update方法时才锁定记录。在此之前仍然可以做数据的更新、插入、删除等动作
adLockBatchOptimistic = 4，乐观分批更新。编辑时记录不会锁定，更改、插入及删除是在批处理模式下完成。
};

adCmdText:表明CommandText是文本命令

adCmdTable:表明CommandText是一个表名

adCmdProc:表明CommandText是一个存储过程

adCmdUnknown:未知

<span style="color:#FF0000;">m_pRecordset->Open("SELECT * FROM users",_variant_t((IDispatch *)m_pConnection,true),adOpenStatic,adLockOptimistic,adCmdText);</span>

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\n",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();///关闭连接

---------------------------------------------------------------------------------------------------------------------------------------------

---------------------------------------------------------------------------------------------------------------------------------------------

较大的二进制数据对象，比如：图像、音频文件、或其它二进制数据，这些数据我们称之为二进制大对象BLOB(Binary Large Object),其存取的方式与普通数据有所区别。

BLOB类型的数据无法用普通的方式进行存储，我们需要使用AppendChunk函数。关键的问题是我们需把二进制数据赋值给VARIANT类型的变量。

AppendChunk包含在Field对象中，原型如下：

HRESULT AppendChunk (const _variant_t & Data );

(1)保存

char *pBuf = m_pBMPBuffer;///假设m_pBMPBuffer指针指向一块长度为m_nFileLen的二进制数据,并且已经成功打开了记录集对象m_pRecordset
VARIANT varBLOB;
SAFEARRAY *psa;
SAFEARRAYBOUND rgsabound[1];

m_pRecordset->AddNew(); ///添加新记录
m_pRecordset->PutCollect("username",_variant_t("小李")); ///为新记录填充username字段
m_pRecordset->PutCollect("old",_variant_t((long)28); ///填充old字段

if(pBuf)
{
    rgsabound[0].lLbound = 0;
    rgsabound[0].cElements = m_nFileLen;
    psa = SafeArrayCreate(VT_UI1, 1, rgsabound); ///创建SAFEARRAY对象

    for (long i = 0; i < (long)m_nFileLen; i++)
        SafeArrayPutElement (psa, &i, pBuf++); ///将pBuf指向的二进制数据保存到SAFEARRAY对象psa中

    varBLOB.vt = VT_ARRAY | VT_UI1; ///将varBLOB的类型设置为BYTE类型的数组
    varBLOB.parray = psa; ///为varBLOB变量赋值

    m_pRecordset->GetFields()->GetItem("photo")->AppendChunk(varBLOB);///加入BLOB类型的数据
}
m_pRecordset->Update();

(2)读取

GetChunk的原型如下:

_variant_t GetChunk (long Length );

给出数据的长度后GetChunk将返回包含数据的VARIANT类型变量,然后我们可以利用SafeArrayAccessData函数得到VARIANT变量中指向数据的char *类型的指针,以方便我们的处理。

long lDataSize = m_pRecordset->GetFields()->GetItem("photo")->ActualSize;///得到数据的长度
if(lDataSize > 0)
{
    _variant_t varBLOB;
    varBLOB = m_pRecordset->GetFields()->GetItem("photo")->GetChunk(lDataSize);
    if(varBLOB.vt == (VT_ARRAY | VT_UI1)) ///判断数据类型是否正确
    {
        char *pBuf = NULL;
        SafeArrayAccessData(varBLOB.parray,(void **)&pBuf); ///得到指向数据的指针
        /*****在这里我们可以对pBuf中的数据进行处理*****/
        SafeArrayUnaccessData (varBLOB.parray);
    }
}

---------------------------------------------------------------------------------------------------------------------------------------------

---------------------------------------------------------------------------------------------------------------------------------------------

利用UDL文件来建立ADO连接

Microsoft提供了通用数据连接文件（.UDL）来建立和测试ADO连接属性。ADO连接对象可以很方便地使用UDL文件来连接数据源，下面例子使用my_data.udl来创建ADO连接。

_ConnectionPtr m_pDBConn;
m_pDBConn.CreateInstance(__uuidof(Connection));
m_pDBConn->ConnectionString ="File Name=c:\mydir\my_data.udl";
m_pDBConn->Open("","","",NULL);

这样一来无论数据源如何变化，在软件中都可以用统一的方法编程。当数据源改变时，只要双击相应的udl文件即可可视化地设置数据源，无需更改软件。

--------------------------------------------------------------------------------------------------------------------------------------------

--------------------------------------------------------------------------------------------------------------------------------------------

ADO接口简介

ADO库包含三个基本接口:

__ConnectionPtr接口、

__CommandPtr接口和、

__RecordsetPtr接口,

__ConnectionPtr接口返回一个记录集或一个空指针。通常使用它来创建一个数据连接或执行一条不返回任何结果的SQL语句，如一个存储过程。用__ConnectionPtr接口返回一个记录集不是一个好的使用方法。通常同CDatabase一样，使用它创建一个数据连接，然后使用其它对象执行数据输入输出操作。

__CommandPtr接口返回一个记录集。它提供了一种简单的方法来执行返回记录集的存储过程和SQL语句。在使用__CommandPtr接口时，可以利用全局__ConnectionPtr接口，也可以在__CommandPtr接口里直接使用连接串。如果只执行一次或几次数据访问操作，后者是比较好的选择。但如果要频繁访问数据库，并要返回很多记录集，那么，应该使用全局__ConnectionPtr接口创建一个数据连接，然后使用__CommandPtr接口执行存储过程和SQL语句。

__RecordsetPtr是一个记录集对象。与以上两种对象相比，它对记录集提供了更多的控制功能，如记录锁定，游标控制等。同__CommandPtr接口一样，它不一定要使用一个已经创建的数据连接，可以用一个连接串代替连接指针赋给__RecordsetPtr的connection成员变量，让它自己创建数据连接。如果要使用多个记录集，最好的方法是同Command对象一样使用已经创建了数据连接的全局—ConnectionPtr接口，然后使用__RecordsetPtr执行存储过程和SQL语句。

--------------------------------------------------------------------------------------------------------------------------------------------

--------------------------------------------------------------------------------------------------------------------------------------------

使用ADO接口

__ConnectionPtr是一个连接接口，它类似于CDatabase和CDaoDatabase。首先创建一个__ConnectionPtr接口实例，接着指向并打开一个ODBC数据源或OLE DB数据提供者(Provider)。以下代码分别创建一个基于DSN和非DSN的数据连接。

//使用__ConnectionPtr(基于DSN)
__ConnectionPtr MyDb;
MyDb.CreateInstance(__uuidof(Connection));
MyDb－〉Open("DSN=samp;UID=admin;PWD=admin","","",－1);

//使用—ConnectionPtr (基于非DSN)
__ConnectionPtr MyDb;
MyDb.CreateInstance(__uuidof(Connection));
MyDb－〉Open("Provider=SQLOLEDB;SERVER=server;DATABASE=samp;UID=admin;PWD=admin","","",－1);

__RecordsetPtr接口的使用方法和CDaoDatabase类似，通过以下代码的比较，你会发现使用—RecordsetPtr接口非常简单(以下代码使用上面已经创建的数据连接)：

//使用CDaoDatabase执行SQL语句
CDaoRecordset MySet = new CDaoRecordset(MyDb);
MySet－〉Open(AFX__DAO__USE__DEFAULT__TYPE,"SELECT ? FROM t__samp");
//使用__RecordsetPtr执行SQL语句
__RecordsetPtr MySet;
MySet.CreateInstance(__uuidof(Recordset));
MySet－〉Open("SELECT ? FROM some__table",MyDb.GetInterfacePtr(),adOpenDynamic,adLockOptimistic,adCmdText);

//使用ADO访问数据
__variant__t Holder
try{while(!MySet－〉adoEOF)
{
    Holder = MySet－〉GetCollect("FIELD__1");
    if(Holder.vt!=VT__NULL)
        m__List.AddString((char?)__bstr__t(Holder));
    MySet－〉MoveNext();}
}
catch(__com__error ? e)
{
    CString Error = e－〉ErrorMessage();
    AfxMessageBox(e－〉ErrorMessage());
}
catch(...)
{
    MessageBox("ADO发生错误!");
}

__CommandPtr接口返回一个Recordset对象，并且提供了更多的记录集控制功能，以下代

码示例使用__CommandPtr接口的方法：

//使用__CommandPtr接口获取数据
__CommandPtr pCommand;
__RecordsetPtr MySet;
pCommand.CreateInstance(__uuidof(Command));
pCommand－〉ActiveConnection=MyDb;
pCommand－〉CommandText="select ? from some—table";
pCommand－〉CommandType=adCmdText;
pCommand－〉Parameters－〉Refresh();
MySet=pCommand－〉Execute(NULL,NULL,adCmdUnknown);
__variant__t TheValue = MySet－〉GetCollect("FIELD__1");
CString sValue=(char?)__bstr__t(TheValue);

--------------------------------------------------------------------------------------------------------------------------------------------

--------------------------------------------------------------------------------------------------------------------------------------------

关于数据类型转换

由于COM对象是跨平台的，它使用了一种通用的方法来处理各种类型的数据，因此CString 类和COM对象是不兼容的，我们需要一组API来转换COM对象和C＋＋类型的数据。__vatiant__t和__bstr__t就是这样两种对象。它们提供了通用的方法转换COM对象和C＋＋类型的数据。

--------------------------------------------------------------------------------------------------------------------------------------------

--------------------------------------------------------------------------------------------------------------------------------------------

下面给出 ADO+开发指南.pdf 下载传送门 http://download.csdn.net/detail/wlsgzl/6371783