Ai

随笔 - 4, 文章 - 0, 评论 - 0, 引用 - 0
数据加载中……

Visual C++ ADO数据库编程入门(上)(转)

ADO 是目前在Windows环境中比较流行的客户端数据库编程技术。ADO是建立在OLE DB底层技术之上的高级编程接口,因而它兼具有强大的数据处理功能(处理各种不同类型的数据源、分布式的数据处理等等)和极其简单、易用的编程接口,因而得到了广泛的应用。而且按微软公司的意图,OLE DB和ADO将逐步取代 ODBC和DAO。现在介绍ADO各种应用的文章和书籍有很多,本文着重站在初学者的角度,简要探讨一下在VC++中使用ADO编程时的一些问题。我们希望阅读本文之前,您对ADO技术的基本原理有一些了解。

  一、在VC++中使用ADO编程

  ADO实际上就是由一组Automation对象构成的组件,因此可以象使用其它任何Automation对象一样使用ADO。ADO中最重要的对象有三个:Connection、Command和Recordset,它们分别表示连接对象、命令对象和记录集对象。如果您熟悉使用MFC中的ODBC类(CDatabase、CRecordset)编程,那么学习ADO编程就十分容易了。

  使用ADO编程时可以采用以下三种方法之一:

  1、使用预处理指令#import     
#import "C:\Program Files\Common Files\System\ADO\msado15.dll" \
no_namespace rename(
"EOF""EndOfFile")
但要注意不能放在stdAfx.h文件的开头,而应该放在所有include指令的后面。否则在编译时会出错。
程序在编译过程中,VC++会读出msado15.dll中的类型库信息,自动产生两个该类型库的头文件和实现文件msado15.tlh和msado15.tli(在您的Debug或Release目录下)。在这两个文件里定义了ADO的所有对象和方法,以及一些枚举型的常量等。我们的程序只要直接调用这些方法就行了,与使用MFC中的COleDispatchDriver类调用Automation对象十分类似。

  2、使用MFC中的CIDispatchDriver

  就是通过读取msado15.dll中的类型库信息,建立一个COleDispatchDriver类的派生类,然后通过它调用ADO对象。

  3、直接用COM提供的API

  如使用如下代码:
CLSID clsid;
HRESULT hr 
= ::CLSIDFromProgID(L"ADODB.Connection"&clsid);
if(FAILED(hr))
{}
::CoCreateInstance(clsid, NULL, CLSCTX_SERVER, IID_IDispatch, (
void **)
&pDispatch);
if(FAILED(hr))
{}
以上三种方法,第一和第二种类似,可能第一种好用一些,第三种编程可能最麻烦。但可能第三种方法也是效率最高的,程序的尺寸也最小,并且对ADO的控制能力也最强。

  据微软资料介绍,第一种方法不支持方法调用中的默认参数,当然第二种方法也是这样,但第三种就不是这样了。采用第三种方法的水平也最高。当你需要绕过ADO而直接调用OLE DB底层的方法时,就一定要使用第三种方法了。

  ADO编程的关键,就是熟练地运用ADO提供的各种对象(object)、方法(method)、属性(property)和容器(collection)。另外,如果是在MS SQL或Oracle等大型数据库上编程,还要能熟练使用SQL语言。


  二、使用#import方法的编程步骤

  这里建议您使用#import的方法,因为它易学、易用,代码也比较简洁。

  1、 添加#import指令

  打开stdafx.h文件,将下列内容添加到所有的include指令之后:
#include <icrsint.h> //Include support for VC++ Extensions
#import "C:\Program Files\Common Files\System\ADO\msado15.dll" \
no_namespace rename(
"EOF""adoEOF")
其中icrsint.h文件包含了VC++扩展的一些预处理指令、宏等的定义,用于COM编程时使用。

  2、定义_ConnectionPtr型变量,并建立数据库连接

  建立了与数据库服务器的连接后,才能进行其他有关数据库的访问和操作。ADO使用Connection对象来建立与数据库服务器的连接,所以它相当于MFC中的CDatabase类。和CDatabase类一样,调用Connection对象的Open方法即可建立与服务器的连接。

  数据类型 _ConnectionPtr实际上就是由类模板_com_ptr_t而得到的一个具体的实例类,其定义可以到msado15.tlh、comdef.h 和comip.h这三个文件中找到。在msado15.tlh中有:
_COM_SMARTPTR_TYPEDEF(_Collection, __uuidof(_Collection));
 经宏扩展后就得到了_ConnectionPtr类。_ConnectionPtr类封装了Connection对象的Idispatch接口指针,及一些必要的操作。我们就是通过这个指针来操纵Connection对象。类似地,后面用到的_CommandPtr和_RecordsetPtr类型也是这样得到的,它们分别表示命令对象指针和记录集对象的指针。

  (1)、连接到MS SQL Server

  注意连接字符串的格式,提供正确的连接字符串是成功连接到数据库服务器的第一步,有关连接字符串的详细信息参见微软MSDN Library光盘。

  本例连接字符串中的server_name,database_name,user_name和password在编程时都应该替换成实际的内容。
_ConnectionPtr pMyConnect=NULL;
HRESULT hr
=pMyConnect.CreateInstance(__uuidof(Connection)));
if(FAILED(hr))return;

_bstr_t strConnect
="Provider=SQLOLEDB; Server=server_name;"
"Database=database_name; uid=user_name; pwd=password;"
//connecting to the database server now:
try{pMyConnect->Open(strConnect,"","",NULL);}
catch (_com_error &e)
{
::MessageBox(NULL,e.Description(),
"警告",MB_OK │ MB_ICONWARNING);
}
注意Connection对象的Open方法中的连接字符串参数必须是BSTR或_bstr_t类型。另外,本例是直接通过OLE DB Provider建立连接,所以无需建立数据源。

  (2)、通过ODBC Driver连接到Database Server连接字符串格式与直接用ODBC编程时的差不多:
_bstr_t strConnect="DSN=datasource_name; Database=database_name; uid=user_name; pwd=password;";
此时与ODBC编程一样,必须先建立数据源。

  3、定义_RecordsetPtr型变量,并打开数据集

  定义_RecordsetPtr型变量,然后通过它调用Recordset对象的Open方法,即可打开一个数据集。所以Recordset对象与MFC中的CRecordset类类似,它也有当前记录、当前记录指针的概念。如:
_RecordsetPtr m_pRecordset;
if(!FAILED(m_pRecordset.CreateInstance( __uuidof( Recordset )))
{
m_pDoc
->m_initialized=FALSE;
return;
}


try{
m_pRecordset
->Open(_variant_t("mytable"),
_variant_t((IDispatch 
*)pMyConnect,true), adOpenKeyset,
adLockOptimistic, adCmdTable);
}

catch (_com_error &e)
{
::MessageBox(NULL,
"无法打开mytable表。","提示",
MB_OK │ MB_ICONWARNING);
}
Recordset对象的Open方法非常重要,它的第一个参数可以是一个SQL语句、一个表的名字或一个命令对象等等;第二个参数就是前面建立的连接对象的指针。此外,用Connection和Command对象的Execute方法也能得到记录集,但是只读的。


  4、读取当前记录的数据

  我认为读取数据的最方便的方法如下:
try{
m_pRecordset
->MoveFirst(); 
while(m_pRecordset->adoEOF==VARIANT_FALSE) 
{
//Retrieve column's value: 
CString sName=(char*)(_bstr_t)(m_pRecordset->Fields->GetItem
(_variant_t(
"name"))->Value);
short cAge=(short)(m_pRecordset->Fields->GetItem
(_variant_t(
"age"))->Value);
//Do something what you want to do:

m_pRecordset
->MoveNext(); 
}

}
//try
catch (_com_error &e)
{
CString str
=(char*)e.Description();
::MessageBox(NULL,str
+"\n又出毛病了。","提示",
MB_OK │ MB_ICONWARNING);
}
本例中的name和age都是字段名,读取的字段值分别保存在sName和cAge变量内。例中的Fields是Recordset对象的容器,GetItem方法返回的是Field对象,而Value则是Field对象的一个属性(即该字段的值)。通过此例,应掌握操纵对象属性的方法。例如,要获得Field 对象的Value属性的值可以直接用属性名Value来引用它(如上例),但也可以调用Get方法,例如:
CString sName=(char*)(_bstr_t)(m_pRecordset->Fields->GetItem
(_variant_t(
"name"))->GetValue());
从此例还可以看到,判断是否到达记录集的末尾,使用记录集的adoEOF属性,其值若为真即到了结尾,反之则未到。判断是否到达记录集开头,则可用BOF属性。

  另外,读取数据还有一个方法,就是定义一个绑定的类,然后通过绑定的变量得到字段值(详见后面的介绍)。

  5、修改数据

  方法一:
try{
m_pRecordset
->MoveFirst(); 
while(m_pRecordset->adoEOF==VARIANT_FALSE) 

m_pRecordset
->Fields->GetItem
(_variant_t(
"姓名"))->Value=_bstr_t("赵薇");

m_pRecordset
->Update();

m_pRecordset
->MoveNext(); 
}

}
//try
改变了Value属性的值,即改变了字段的值。

  方法二:
m_pRecordset->Fields->GetItem
(_variant_t(
"姓名"))->PutValue(_bstr_t("赵薇"));
方法三:就是用定义绑定类的方法(详见后面的介绍)。

  6、添加记录

  新记录添加成功后,即自动成为当前记录。AddNew方法有两种形式,一个含有参数,而另一个则不带参数。

  方法一(不带参数):
// Add new record into this table:
try{
if(!m_pRecordset->Supports(adAddNew)) return;

m_pRecordset
->AddNew(); 
m_pRecordset
->Fields->GetItem
(_variant_t(
"姓名"))->Value=_bstr_t("赵薇");
m_pRecordset
->Fields->GetItem
(_variant_t(
"性别"))->Value=_bstr_t("");
m_pRecordset
->Fields->GetItem
(_variant_t(
"age"))->Value=_variant_t((short)20);
m_pRecordset
->Fields->GetItem
(_variant_t(
"marry"))->Value=_bstr_t("未婚");
m_pRecordset
->Update(); 
}
//try
catch (_com_error &e)
{
::MessageBox(NULL, 
"又出毛病了。","提示",MB_OK │ MB_ICONWARNING);
}
这种方法弄完了还要调用Update()。

  方法二(带参数):
_variant_t varName[4],narValue[4];
varName[
0= L"姓名";
varName[
1= L"性别";
varName[
2= L"age";
varName[
3= L"marry";
narValue[
0]=_bstr_t("赵薇");
narValue[
1]=_bstr_t("");
narValue[
2]=_variant_t((short)20);
narValue[
3]=_bstr_t("未婚");

const int nCrit = sizeof varName / sizeof varName[0];
// Create SafeArray Bounds and initialize the array
SAFEARRAYBOUND rgsaName[1],rgsaValue[1];
rgsaName[
0].lLbound = 0
rgsaName[
0].cElements = nCrit;
SAFEARRAY 
*psaName = SafeArrayCreate( VT_VARIANT, 1, rgsaName );
rgsaValue[
0].lLbound = 0;
rgsaValue[
0].cElements = nCrit;
SAFEARRAY 
*psaValue = SafeArrayCreate( VT_VARIANT, 1, rgsaValue );
// Set the values for each element of the array
HRESULT hr1=S_OK.hr2=S_OK;
forlong i = 0 ; i < nCrit && SUCCEEDED( hr1 ) && SUCCEEDED( hr2 );i++

hr1
=SafeArrayPutElement(psaName, &i,&varName[i]);
hr2
=SafeArrayPutElement(psaValue, &i,&narValue[i]); }


// Initialize and fill the SafeArray
VARIANT vsaName,vsaValue; 
vsaName.vt 
= VT_VARIANT │ VT_ARRAY;
vsaValue.vt 
= VT_VARIANT │ VT_ARRAY;
V_ARRAY(
&vsaName) = psaName;//&vsaName->parray=psaName;
//see definition in oleauto.h file.
V_ARRAY(&vsaValue) = psaValue;

// Add a new record:
m_pRecordset->AddNew(vsaName,vsaValue);
这种方法不需要调用Update,因为添加后,ADO会自动调用它。此方法主要是使用SafeArray挺麻烦。

  方法三:就是用定义绑定类的方法(详见后面的介绍)。

 7、删除记录

  调用Recordset的Delete方法就行了,删除的是当前记录。要了解Delete的其它用法请查阅参考文献。
try{
m_pRecordset
->MoveFirst(); 
while(m_pRecordset->adoEOF==VARIANT_FALSE) 
{
CString sName
=(char*)(_bstr_t)(m_pRecordset->Fields->GetItem
(_variant_t(
"姓名"))->Value);
if(::MessageBox(NULL,"姓名="+sName+"\n删除她吗?",
"提示",MB_YESNO │ MB_ICONWARNING)==IDYES)
{
m_pRecordset
->Delete(adAffectCurrent); 
m_pRecordset
->Update();
}

m_pRecordset
->MoveNext(); 
}

}
//try
catch (_com_error &e)
{
::MessageBox(NULL,
"又出毛病了。","提示",MB_OK │ MB_ICONWARNING);
}
8、使用带参数的命令

  Command对象所代表的就是一个Provider能够理解的命令,如SQL语句等。使用Command对象的关键就是把表示命令的语句设置到CommandText属性中,然后调用Command对象的Execute方法就行了。一般情况下在命令中无需使用参数,但有时使用参数,可以增加其灵活性和效率。

  (1). 建立连接、命令对象和记录集对象

  本例中表示命令的语句就是一个SQL语句(SELECT语句)。SELECT语句中的问号?就代表参数,如果要多个参数,就多放几个问号,每个问号代表一个参数。
_ConnectionPtr Conn1;
_CommandPtr Cmd1;
ParametersPtr 
*Params1 = NULL; // Not an instance of a smart pointer.
_ParameterPtr Param1;
_RecordsetPtr Rs1;

try
{
// Create Connection Object (1.5 Version)
Conn1.CreateInstance( __uuidof( Connection ) );
Conn1
->ConnectionString = bstrConnect;
Conn1
->Open( bstrEmpty, bstrEmpty, bstrEmpty, -1 );
// Create Command Object
Cmd1.CreateInstance( __uuidof( Command ) );
Cmd1
->ActiveConnection = Conn1;
Cmd1
->CommandText = _bstr_t("SELECT * FROM mytable WHERE age< ?");
}
//try
要注意命令对象必须与连接对象关联起来才能起作用,本例中将命令对象的ActiveConnection属性设置为连接对象的指针,即为此目的:
Cmd1->ActiveConnection = Conn1;
(2). 创建参数对象,并给参数赋值
// Create Parameter Object
Param1 = Cmd1->CreateParameter( _bstr_t(bstrEmpty),
adInteger,
adParamInput,
-1,
_variant_t( (
long5) );
Param1
->Value = _variant_t( (long5 );
Cmd1
->Parameters->Append( Param1 );
用命令对象的方法来创建一个参数对象,其中的长度参数(第三个)如果是固定长度的类型,就填-1,如果是字符串等可变长度的就填其实际长度。Parameters是命令对象的一个容器,它的Append方法就是把创建的参数对象追加到该容器里。Append进去的参数按先后顺序与SQL语句中的问号从左至右一一对应。

  (3). 执行命令打开记录集
// Open Recordset Object
Rs1 = Cmd1->Execute( &vtEmpty, &vtEmpty2, adCmdText );
      但要注意,用Command和Connection对象的Execute方法得到的Recordset是只读的。因为在打开Recordset之前,我们无法设置它的LockType属性(其默认值为只读)。而在打开之后设置LockType不起作用。

  我发现用上述方法得到记录集Rs1后,不但Rs1中的记录无法修改,即使直接用SQL语句修改同一表中任何记录都不行。

  要想能修改数据,还是要用Recordset自己的Open方法才行,如:
try{
m_pRecordset
->Open((IDispatch *) Cmd1, vtMissing,
adOpenStatic, adLockOptimistic, adCmdUnspecified);
}

catch (_com_error &e)
{
::MessageBox(NULL,
"mytable表不存在。","提示",MB_OK │ MB_ICONWARNING);
}
Recordset对象的Open方法真是太好了,其第一个参数可以是SQL语句、表名字、命令对象指针等等。

  9、响应ADO的通知事件

  通知事件就是当某个特定事件发生时,由Provider通知客户程序,换句话说,就是由Provider调用客户程序中的一个特定的方法(即事件的处理函数)。所以为了响应一个事件,最关键的就是要实现事件的处理函数。

  (1). 从ConnectionEventsVt接口派生出一个类

  为了响应_Connection的通知事件,应该从ConnectionEventsVt接口派生出一个类
class CConnEvent : public ConnectionEventsVt
{
private:
ULONG m_cRef;
public:
CConnEvent() 
{ m_cRef = 0; };
~CConnEvent() {};

STDMETHODIMP QueryInterface(REFIID riid, 
void ** ppv);
STDMETHODIMP_(ULONG) AddRef(
void);
STDMETHODIMP_(ULONG) Release(
void);
STDMETHODIMP raw_InfoMessage( 
struct Error *pError,
EventStatusEnum 
*adStatus,
struct _Connection *pConnection);
STDMETHODIMP raw_BeginTransComplete( 
LONG TransactionLevel,
struct Error *pError,
EventStatusEnum 
*adStatus,
struct _Connection *pConnection);

}
;
(2). 实现每一个事件的处理函数(凡是带raw_前缀的方法都把它实现了):
STDMETHODIMP CConnEvent::raw_InfoMessage( 
struct Error *pError,
EventStatusEnum 
*adStatus,
struct _Connection *pConnection)
{
*adStatus = adStatusUnwantedEvent;
return S_OK;
}
;
有些方法虽然你并不需要,但也必须实现它,只需简单地返回一个S_OK即可。但如果要避免经常被调用,还应在其中将adStatus参数设置为adStatusUnwantedEvent,则在本次调用后,以后就不会被调用了。
另外还必须实现QueryInterface, AddRef, 和Release三个方法: 
STDMETHODIMP CConnEvent::QueryInterface(REFIID riid, void ** ppv) 
{
*ppv = NULL;
if (riid == __uuidof(IUnknown) ││ 
riid 
== __uuidof(ConnectionEventsVt)) *ppv = this;
if (*ppv == NULL)
return ResultFromScode(E_NOINTERFACE);
AddRef();
return NOERROR;
}

STDMETHODIMP_(ULONG) CConnEvent::AddRef() 
return ++m_cRef; };
STDMETHODIMP_(ULONG) CConnEvent::Release()

if (0 != --m_cRef) return m_cRef;
delete 
this;
return 0;
}
(3). 开始响应通知事件
// Start using the Connection events
IConnectionPointContainer *pCPC = NULL;
IConnectionPoint 
*pCP = NULL;

hr 
= pConn.CreateInstance(__uuidof(Connection));
if (FAILED(hr)) return;

hr 
= pConn->QueryInterface(__uuidof(IConnectionPointContainer), 
(
void **)&pCPC);
if (FAILED(hr)) return;
hr 
= pCPC->FindConnectionPoint(__uuidof(ConnectionEvents), &pCP);
pCPC
->Release();
if (FAILED(hr)) return;

pConnEvent 
= new CConnEvent();
hr 
= pConnEvent->QueryInterface(__uuidof(IUnknown), (void **&pUnk);
if (FAILED(hr)) return rc; 
hr 
= pCP->Advise(pUnk, &dwConnEvt);
pCP
->Release();
if (FAILED(hr)) return;

pConn
->Open("dsn=Pubs;""sa""", adConnectUnspecified);
也就是说在连接(Open)之前就做这些事。

  (4). 停止响应通知事件
pConn->Close();
// Stop using the Connection events
hr = pConn->QueryInterface(__uuidof(IConnectionPointContainer), 
(
void **&pCPC);
if (FAILED(hr)) return;
hr 
= pCPC->FindConnectionPoint(__uuidof(ConnectionEvents), &pCP);
pCPC
->Release();
if (FAILED(hr)) return rc;
hr 
= pCP->Unadvise( dwConnEvt );
pCP
->Release();
if (FAILED(hr)) return;
在连接关闭之后做这件事。

posted on 2010-12-18 16:23 王凯 阅读(187) 评论(0)  编辑 收藏 引用 所属分类: C++


只有注册用户登录后才能发表评论。
网站导航: 博客园   IT新闻   BlogJava   知识库   博问   管理