ADO數據庫編程入門（下）

10、邦定數據

　　定義一個綁定類，將其成員變量綁定到一個指定的記錄集，以方便於訪問記錄集的字段值。

　　(1). 從CADORecordBinding派生出一個類：

class CCustomRs : public CADORecordBinding
{
BEGIN_ADO_BINDING(CCustomRs)
ADO_VARIABLE_LENGTH_ENTRY2(3, adVarChar, m_szau_fname, 
sizeof(m_szau_fname), lau_fnameStatus, false)
ADO_VARIABLE_LENGTH_ENTRY2(2, adVarChar, m_szau_lname, 
sizeof(m_szau_lname), lau_lnameStatus, false)
ADO_VARIABLE_LENGTH_ENTRY2(4, adVarChar, m_szphone, 
sizeof(m_szphone), lphoneStatus, true)
END_ADO_BINDING()

public:
CHAR m_szau_fname[22];
ULONG lau_fnameStatus;
CHAR m_szau_lname[42];
ULONG lau_lnameStatus;
CHAR m_szphone[14];
ULONG lphoneStatus;
};

　　其中將要綁定的字段與變量名用BEGIN_ADO_BINDING宏關聯起來。每個字段對應於兩個變量，一個存放字段的值，另一個存放字段的狀態。字段用從1開始的序號表示，如1，2，3等等。

　　特別要注意的是：如果要綁定的字段是字符串類型，則對應的字符數組的元素個數一定要比字段長度大2（比如m_szau_fname[22]，其綁定的字段au_fname的長度實際是20），不這樣綁定就會失敗。我分析多出的2可能是爲了存放字符串結尾的空字符null和BSTR字符串開頭的一個字（表示BSTR的長度）。這個問題對於初學者來說可能是一個意想不到的問題。

　　CADORecordBinding類的定義在icrsint.h文件裏，內容是：

class CADORecordBinding
{
public:
STDMETHOD_(const ADO_BINDING_ENTRY*, GetADOBindingEntries) (VOID) PURE;
};

BEGIN_ADO_BINDING宏的定義也在icrsint.h文件裏，內容是：
#define BEGIN_ADO_BINDING(cls) public: \
typedef cls ADORowClass; \
const ADO_BINDING_ENTRY* STDMETHODCALLTYPE GetADOBindingEntries() { \
static const ADO_BINDING_ENTRY rgADOBindingEntries[] = { 

ADO_VARIABLE_LENGTH_ENTRY2宏的定義也在icrsint.h文件裏：
#define ADO_VARIABLE_LENGTH_ENTRY2(Ordinal, DataType, Buffer, Size, Status, Modify)\
{Ordinal, \
DataType, \
0, \
0, \
Size, \
offsetof(ADORowClass, Buffer), \
offsetof(ADORowClass, Status), \
0, \
classoffset(CADORecordBinding, ADORowClass), \
Modify},

#define END_ADO_BINDING宏的定義也在icrsint.h文件裏：
#define END_ADO_BINDING() {0, adEmpty, 0, 0, 0, 0, 0, 0, 0, FALSE}};\
return rgADOBindingEntries;}

　　　(2). 綁定

_RecordsetPtr Rs1;
IADORecordBinding *picRs=NULL;
CCustomRs rs;
......
Rs1->QueryInterface(__uuidof(IADORecordBinding), 
(LPVOID*)&picRs));
picRs->BindToRecordset(&rs);

　　派生出的類必須通過IADORecordBinding接口才能綁定，調用它的BindToRecordset方法就行了。

　　(3). rs中的變量即是當前記錄字段的值

//Set sort and filter condition:
// Step 4: Manipulate the data
Rs1->Fields->GetItem("au_lname")->Properties->GetItem("Optimize")->Value = true; 
Rs1->Sort = "au_lname ASC";
Rs1->Filter = "phone LIKE '415 5*'";

Rs1->MoveFirst();
while (VARIANT_FALSE == Rs1->EndOfFile)
{
printf("Name: %s\t %s\tPhone: %s\n", 
(rs.lau_fnameStatus == adFldOK ? rs.m_szau_fname : ""), 
(rs.lau_lnameStatus == adFldOK ? rs.m_szau_lname : ""),
(rs.lphoneStatus == adFldOK ? rs.m_szphone : ""));
if (rs.lphoneStatus == adFldOK)
strcpy(rs.m_szphone, "777");
TESTHR(picRs->Update(&rs)); // Add change to the batch
Rs1->MoveNext();
}
Rs1->Filter = (long) adFilterNone;
......
if (picRs) picRs->Release();
Rs1->Close();
pConn->Close();

　　只要字段的狀態是adFldOK，就可以訪問。如果修改了字段，不要忘了先調用picRs的Update（注意不是Recordset的Update），然後才關閉，也不要忘了釋放picRs（即picRs->Release();）。

　　(4). 此時還可以用IADORecordBinding接口添加新紀錄

if(FAILED(picRs->AddNew(&rs)))
......

　　11. 訪問長數據

　　在Microsoft SQL中的長數據包括text、image等這樣長類型的數據，作爲二進制字節來對待。

　　可以用Field對象的GetChunk和AppendChunk方法來訪問。每次可以讀出或寫入全部數據的一部分，它會記住上次訪問的位置。但是如果中間訪問了別的字段後，就又得從頭來了。

　　請看下面的例子：

//寫入一張照片到數據庫：
VARIANT varChunk;
SAFEARRAY *psa;
SAFEARRAYBOUND rgsabound[1];

//VT_ARRAY │ VT_UI1
CFile f("h:\\aaa.jpg",Cfile::modeRead);
BYTE bVal[ChunkSize+1];
UINT uIsRead=0;
//Create a safe array to store the array of BYTES 
while(1)
{
uIsRead=f.Read(bVal,ChunkSize);
if(uIsRead==0)break;
rgsabound[0].cElements =uIsRead;
rgsabound[0].lLbound = 0;
psa = SafeArrayCreate(VT_UI1,1,rgsabound);
for(long index=0;index<uIsRead;index++) 
{
if(FAILED(SafeArrayPutElement(psa,&index,&bVal[index])))
::MessageBox(NULL,"啊，又出毛病了。","提示",MB_OK │ MB_ICONWARNING);
}
varChunk.vt = VT_ARRAY│VT_UI1;
varChunk.parray = psa;
try{
m_pRecordset->Fields->GetItem("photo")->AppendChunk(varChunk); 
}
catch (_com_error &e)
{
CString str=(char*)e.Description();
::MessageBox(NULL,str+"\n又出毛病了。","提示",MB_OK │ MB_ICONWARNING);
}
::VariantClear(&varChunk);
::SafeArrayDestroyData( psa);
if(uIsRead<ChunkSize)break;
}//while(1) 
f.Close();

//從數據庫讀一張照片：
CFile f;
f.Open("h:\\bbb.jpg",Cfile::modeWrite│Cfile::modeCreate);
long lPhotoSize = m_pRecordset->Fields->Item["photo"]->ActualSize; 
long lIsRead=0;

_variant_t varChunk;
BYTE buf[ChunkSize];
while(lPhotoSize>0)
{
lIsRead=lPhotoSize>=ChunkSize? ChunkSize:lPhotoSize;
varChunk = m_pRecordset->Fields->
Item["photo"]->GetChunk(lIsRead);
for(long index=0;index<lIsRead;index++) 
{ 
::SafeArrayGetElement(varChunk.parray,&index,buf+index); 
}
f.Write(buf,lIsRead);
lPhotoSize-=lIsRead;
}//while()
f.Close();

　　12. 使用SafeArray問題

　　學會使用SafeArray也是很重要的，因爲在ADO編程中經常要用。它的主要目的是用於automation中的數組型參數的傳遞。因爲在網絡環境中，數組是不能直接傳遞的，而必須將其包裝成SafeArray。實質上SafeArray就是將通常的數組增加一個描述符，說明其維數、長度、邊界、元素類型等信息。SafeArray也並不單獨使用，而是將其再包裝到VARIANT類型的變量中，然後才作爲參數傳送出去。在VARIANT的vt成員的值如果包含VT_ARRAY│...,那麼它所封裝的就是一個SafeArray，它的parray成員即是指向SafeArray的指針。SafeArray中元素的類型可以是VARIANT能封裝的任何類型，包括VARIANT類型本身。 

　　使用SafeArray的具體步驟：

　　方法一：

　　包裝一個SafeArray：

　　(1). 定義變量，如：

VARIANT varChunk;
SAFEARRAY *psa;
SAFEARRAYBOUND rgsabound[1];

　　(2). 創建SafeArray描述符：

uIsRead=f.Read(bVal,ChunkSize);//read array from a file.
if(uIsRead==0)break;
rgsabound[0].cElements =uIsRead;
rgsabound[0].lLbound = 0;
psa = SafeArrayCreate(VT_UI1,1,rgsabound);

　　(3). 放置數據元素到SafeArray：

for(long index=0;index<uIsRead;index++) 
{
if(FAILED(SafeArrayPutElement(psa,&index,&bVal[index])))
::MessageBox(NULL,"出毛病了。","提示",MB_OK │ MB_ICONWARNING);
}

　　一個一個地放，挺麻煩的。

　　(4). 封裝到VARIANT內：

varChunk.vt = VT_ARRAY│VT_UI1;
varChunk.parray = psa;

　　這樣就可以將varChunk作爲參數傳送出去了。

　　讀取SafeArray中的數據的步驟：

　　(1). 用SafeArrayGetElement一個一個地讀

BYTE buf[lIsRead];
for(long index=0;index<lIsRead;index++) 
{ 
::SafeArrayGetElement(varChunk.parray,&index,buf+index); 
}

　　就讀到緩衝區buf裏了。

　　方法二：

　　使用SafeArrayAccessData直接讀寫SafeArray的緩衝區：

　　(1). 讀緩衝區：

BYTE *buf;
SafeArrayAccessData(varChunk.parray, (void **)&buf);
f.Write(buf,lIsRead);
SafeArrayUnaccessData(varChunk.parray);

　　(2). 寫緩衝區：

BYTE *buf;
::SafeArrayAccessData(psa, (void **)&buf);
for(long index=0;index<uIsRead;index++) 
{
buf[index]=bVal[index]; 
}
::SafeArrayUnaccessData(psa);

varChunk.vt = VT_ARRAY│VT_UI1;
varChunk.parray = psa;

　　這種方法讀寫SafeArray都可以，它直接操縱SafeArray的數據緩衝區，比用SafeArrayGetElement和SafeArrayPutElement速度快。特別適合於讀取數據。但用完之後不要忘了調用::SafeArrayUnaccessData(psa)，否則會出錯的。

　　13. 使用書籤( bookmark )

　　書籤可以唯一標識記錄集中的一個記錄，用於快速地將當前記錄移回到已訪問過的記錄，以及進行過濾等等。Provider會自動爲記錄集中的每一條記錄產生一個書籤，我們只需要使用它就行了。我們不能試圖顯示、修改或比較書籤。ADO用記錄集的Bookmark屬性表示當前記錄的書籤。

　　用法步驟：

　　(1). 建立一個VARIANT類型的變量

_variant_t VarBookmark;

　　(2). 將當前記錄的書籤值存入該變量

　　也就是記錄集的Bookmark屬性的當前值。

VarBookmark = rst->Bookmark;

　　(3). 返回到先前的記錄

　　將保存的書籤值設置到記錄集的書籤屬性中：

// Check for whether bookmark set for a record
if (VarBookmark.vt == VT_EMPTY)
printf("No Bookmark set!\n");
else 
rst->Bookmark = VarBookmark;

　　設置完後，當前記錄即會移動到該書籤指向的記錄。


　　14、設置過濾條件

　　Recordset對象的Filter屬性表示了當前的過濾條件。它的值可以是以AND或OR連接起來的條件表達式（不含WHERE關鍵字）、由書籤組成的數組或ADO提供的FilterGroupEnum枚舉值。爲Filter屬性設置新值後Recordset的當前記錄指針會自動移動到滿足過濾條件的第一個記錄。例如：

rst->Filter = _bstr_t ("姓名='趙薇' AND 性別=’女’");

　　在使用條件表達式時應注意下列問題：

　　（1）、可以用圓括號組成複雜的表達式

　　例如：

rst->Filter = _bstr_t ("(姓名='趙薇' AND 性別=’女’) OR AGE<25");

　　但是微軟不允許在括號內用OR，然後在括號外用AND，例如：

rst->Filter = _bstr_t ("(姓名='趙薇' OR 性別=’女’) AND AGE<25");

　　必須修改爲：

rst->Filter = _bstr_t ("(姓名='趙薇' AND AGE<25) OR (性別=’女’ AND AGE<25)");

　　（2）、表達式中的比較運算符可以是LIKE

　　LIKE後被比較的是一個含有通配符*的字符串，星號表示若干個任意的字符。

　　字符串的首部和尾部可以同時帶星號*

rst->Filter = _bstr_t ("姓名 LIKE '*趙*' ");

　　也可以只是尾部帶星號：

rst->Filter = _bstr_t ("姓名 LIKE '趙*' ");

　　Filter屬性值的類型是Variant，如果過濾條件是由書籤組成的數組，則需將該數組轉換爲SafeArray，然後再封裝到一個VARIANT或_variant_t型的變量中，再賦給Filter屬性。

　　15、索引與排序

　　（1）、建立索引

　　當以某個字段爲關鍵字用Find方法查找時，爲了加快速度可以以該字段爲關鍵字在記錄集內部臨時建立索引。只要將該字段的Optimize屬性設置爲true即可，例如：

pRst->Fields->GetItem("姓名")->Properties->
GetItem("Optimize")->PutValue("True");
pRst->Find("姓名 = '趙薇'",1,adSearchForward);
......
pRst->Fields->GetItem("姓名")->Properties->
GetItem("Optimize")->PutValue("False");
pRst->Close();

　　說明：Optimize屬性是由Provider提供的屬性（在ADO中稱爲動態屬性），ADO本身沒有此屬性。

　　（2）、排序

　　要排序也很簡單，只要把要排序的關鍵字列表設置到Recordset對象的Sort屬性裏即可，例如：

pRstAuthors->CursorLocation = adUseClient;
pRstAuthors->Open("SELECT * FROM mytable",
_variant_t((IDispatch *) pConnection),
adOpenStatic, adLockReadOnly, adCmdText);
......
pRst->Sort = "姓名 DESC, 年齡 ASC";

　　關鍵字（即字段名）之間用逗號隔開，如果要以某關鍵字降序排序，則應在該關鍵字後加一空格，再加DESC（如上例）。升序時ASC加不加無所謂。本操作是利用索引進行的，並未進行物理排序，所以效率較高。
但要注意，在打開記錄集之前必須將記錄集的CursorLocation屬性設置爲adUseClient，如上例所示。Sort屬性值在需要時隨時可以修改。

　　16、事務處理

　　ADO中的事務處理也很簡單，只需分別在適當的位置調用Connection對象的三個方法即可，這三個方法是：
　　（1）、在事務開始時調用

pCnn->BeginTrans();

　　（2）、在事務結束併成功時調用

pCnn->CommitTrans ();

　　（3）、在事務結束並失敗時調用

pCnn->RollbackTrans ();

　　在使用事務處理時，應儘量減小事務的範圍，即減小從事務開始到結束（提交或回滾）之間的時間間隔，以便提高系統效率。需要時也可在調用BeginTrans()方法之前，先設置Connection對象的IsolationLevel屬性值，詳細內容參見MSDN中有關ADO的技術資料。

　　三、使用ADO編程常見問題解答

　　以下均是針對MS SQL 7.0編程時所遇問題進行討論。

　　1、連接失敗可能原因

　　Enterprise Managemer內，打開將服務器的屬性對話框，在Security選項卡中，有一個選項Authentication。

　　如果該選項是Windows NT only，則你的程序所用的連接字符串就一定要包含Trusted_Connection參數，並且其值必須爲yes，如：

"Provider=SQLOLEDB;Server=888;Trusted_Connection=yes"
";Database=master;uid=lad;";

　　如果不按上述操作，程序運行時連接必然失敗。

　　如果Authentication選項是SQL Server and Windows NT，則你的程序所用的連接字符串可以不包含Trusted_Connection參數，如：

"Provider=SQLOLEDB;Server=888;Database=master;uid=lad;pwd=111;";

　　因爲ADO給該參數取的默認值就是no，所以可以省略。我認爲還是取默認值比較安全一些。

　　2、改變當前數據庫的方法

　　使用Tansct-SQL中的USE語句即可。

　　3、如何判斷一個數據庫是否存在

　　(1)、可打開master數據庫中一個叫做SCHEMATA的視圖，其內容列出了該服務器上所有的數據庫名稱。

　　(2) 、更簡便的方法是使用USE語句，成功了就存在；不成功，就不存在。例如：

try{
m_pConnect->Execute ( _bstr_t("USE INSURANCE_2002"),NULL,
adCmdText│adExecuteNoRecords );
}
catch (_com_error &e)
{
blSuccess=FALSE;
CString str="數據庫INSURANCE_2002不存在！\n";
str+=e.Description();
::MessageBox(NULL,str,"警告",MB_OK │ MB_ICONWARNING); 
}

　　4、判斷一個表是否存在

　　（1）、同樣判斷一個表是否存在，也可以用是否成功地打開它來判斷，十分方便，例如：

try{
m_pRecordset->Open(_variant_t("mytable"),
_variant_t((IDispatch *)m_pConnection,true), adOpenKeyset,
adLockOptimistic, adCmdTable);
}
catch (_com_error &e)
{
::MessageBox(NULL,"該表不存在。","提示",MB_OK │ MB_ICONWARNING);
}

　　(2)、要不然可以採用麻煩一點的辦法，就是在MS-SQL服務器上的每個數據庫中都有一個名爲sysobjects的表，查看此表的內容即知指定的表是否在該數據庫中。

　　(3)、同樣，每個數據庫中都有一個名爲TABLES的視圖(View)，查看此視圖的內容即知指定的表是否在該數據庫中。

　　5、類型轉換問題

　　（1）、類型VARIANT_BOOL

　　類型VARIANT_BOOL等價於short類型。The VARIANT_BOOL is equivalent to short. see it's definition below:
typdef short VARIANT_BOOL

　　（2）、_com_ptr_t類的類型轉換

　　_ConnectionPtr可以自動轉換成IDspatch*類型，這是因爲_ConnectionPtr實際上是_com_ptr_t類的一個實例，而這個類有此類型轉換函數。

　　同理，_RecordsetPtr和_CommandPtr也都可以這樣轉換。

　　（3）、_bstr_t和_variant_t類

　　在ADO編程時，_bstr_t和_variant_t這兩個類很有用，省去了許多BSTR和VARIANT類型轉換的麻煩。

　　6、打開記錄集時的問題

　　在打開記錄集時，在調用Recordset的Open方法時，其最後一個參數裏一定不能包含adAsyncExecute，否則將因爲是異步操作，在讀取數據時無法讀到數據。

　　7、異常處理問題

　　對所有調用ADO的語句一定要用try和catch語句捕捉異常，否則在發生異常時，程序會異常退出。

　　8、使用SafeArray問題

　　在初學使用中，我曾遇到一個傷腦筋的問題，一定要注意：

　　在定義了SAFEARRAY的指針後，如果打算重複使用多次，則在中間可以調用::SafeArrayDestroyData釋放數據，但決不能調用::SafeArrayDestroyDescriptor，否則必然出錯，即使調用SafeArrayCreate也不行。例如：

SAFEARRAY *psa;
......
//When the data are no longer to be used:
::SafeArrayDestroyData( psa);

　　我分析在定義psa指針時，一個SAFEARRAY的實例（也就是SAFEARRAY描述符）也同時被自動建立了。但是隻要一調用::SafeArrayDestroyDescriptor，描述符就被銷燬了。

　　所以我認爲::SafeArrayDestroyDescriptor可以根本就不調用，即使調用也必須在最後調用。

　　9、重複使用命令對象問題

　　一個命令對象如果要重複使用多次（尤其是帶參數的命令），則在第一次執行之前，應將它的Prepared屬性設置爲TRUE。這樣會使第一次執行減慢，但卻可以使以後的執行全部加快。

　　10、綁定字符串型字段問題

　　如果要綁定的字段是字符串類型，則對應的字符數組的元素個數一定要比字段長度大2（比如m_szau_fname[22]，其綁定的字段au_fname的長度實際是20），不這樣綁定就會失敗。

　　11、使用AppendChunk的問題

　　當用AddNew方法剛剛向記錄集內添加一個新記錄之後，不能首先向一個長數據字段（image類型）寫入數據，必須先向其他字段寫入過數據之後，才能調用AppendChunk寫該字段，否則出錯。也就是說，AppendChunk不能緊接在AddNew之後。另外，寫入其他字段後還必須緊接着調用AppendChunk，而不能調用記錄集的Update方法後，才調用AppendChunk，否則調用AppendChunk時也會出錯。換句話說，就是必須AppendChunk在前，Update在後。因而這個時候就不能使用帶參數的AddNew了，因爲帶參數的AddNew會自動調用記錄集的Update，所以AppendChunk就跑到Update的後面了，就只有出錯了！因此，這時應該用不帶參數的AddNew。

　　我推測這可能是MS SQL 7.0的問題，在MS SQL 2000中則不存在這些問題，但是AppendChunk仍然不能在Update之後。

　　四、小結

　　一般情況下，Connection和Command的Execute用於執行不產生記錄集的命令，而Recordset的Open用於產生一個記錄集，當然也不是絕對的。特別Command主要是用於執行參數化的命令，可以直接由Command對象執行，也可以將Command對象傳遞給Recordset的Open。