1 前言

    隨著UG系統(tǒng)的推廣和普及應(yīng)用，基于UG平臺(tái)的二次開發(fā)工作顯得越來(lái)越重要，在UG的二次開發(fā)應(yīng)用系統(tǒng)中，經(jīng)常需要與各種外部數(shù)據(jù)打交道， UG/OPEN API提供了豐富的文件訪問操作函數(shù)，利用這些操作函數(shù)及VC++的MFC類庫(kù)，可以方便地實(shí)現(xiàn)外部數(shù)據(jù)讀寫訪問編程。

2 外部數(shù)據(jù)訪問的主要方法

    在UG二次開發(fā)應(yīng)用系統(tǒng)中，主要訪問的外部數(shù)據(jù)有文本文件、Excel表、關(guān)系型數(shù)據(jù)庫(kù)表等，通常可以通過以下方法訪問這些外部數(shù)據(jù)：

（1）通過UG/OPEN API提供的文件操作函數(shù)訪問外部數(shù)據(jù)
（2）通過ODBC數(shù)據(jù)源訪問外部數(shù)據(jù)
（3）通過ADO訪問外部數(shù)據(jù)

2.1 通過UG/OPEN API提供的文件操作函數(shù)訪問文本文件數(shù)據(jù)

    UG/OPEN API中有關(guān)文件操作的函數(shù)包含在頭文件uf_cfi.h中，通過函數(shù)uc4500可以打開二進(jìn)制文件，相關(guān)的文件操作函數(shù)有uc4510、uc4511、uc4512、uc4513及uc4520、uc4521、uc4522、uc4523，通過函數(shù)uc4504可以打開文本文件，相關(guān)的文件操作函數(shù)有uc4514、uc4524、uc4525，函數(shù)uc4540用于關(guān)閉文件，判斷文件是否存在使用函數(shù)UF_CFI_ask_file_exist。

    通過UG/OPEN API提供的文件操作函數(shù)訪問外部數(shù)據(jù)時(shí)，要注意以下問題：

（1）UG/Manager 和 IMAN中的文件和文件夾操作不能使用uf_cfi.h中函數(shù)；

（2）UG/OPEN API中對(duì)文件和文件夾標(biāo)識(shí)符的長(zhǎng)度有如下限制：

    文件名長(zhǎng)度不能超過UF_CFI_MAX_FILE_NAME_LEN；文件夾路徑的長(zhǎng)度不能超過UF_CFI_MAX_PATH_NAME_LEN；整個(gè)文件路徑的長(zhǎng)度不能超過UF_CFI_MAX_PATH_NAME_LEN。

訪問文本文件的程序流程如下：

2.2 通過ODBC數(shù)據(jù)源訪問Excel表或關(guān)系型數(shù)據(jù)庫(kù)表數(shù)據(jù)

    ODBC（Open Database connectivity 開放式數(shù)據(jù)庫(kù)互連）是由微軟公司提出的一個(gè)用于訪問數(shù)據(jù)庫(kù)的統(tǒng)一界面標(biāo)準(zhǔn)，它提供了一個(gè)一致的應(yīng)用程序編程接口，該接口使用一個(gè)針對(duì)數(shù)據(jù)庫(kù)的驅(qū)動(dòng)程序與不同的數(shù)據(jù)庫(kù)協(xié)同工作。

    通過ODBC訪問外部數(shù)據(jù)時(shí)，需要先指定訪問的數(shù)據(jù)源DSN（Data Source Name），以指定ODBC與相關(guān)的驅(qū)動(dòng)程序相對(duì)應(yīng)的入口。在控制面板的管理工具中可以打開ODBC數(shù)據(jù)源管理器，指定DSN。

    建立MFC數(shù)據(jù)庫(kù)類Cdatabse對(duì)象可以實(shí)現(xiàn)對(duì)外部數(shù)據(jù)的訪問編程。一個(gè)CDatabase對(duì)象代表與數(shù)據(jù)源的一個(gè)連接。創(chuàng)建一個(gè)CDatabase對(duì)象之后，調(diào)用Open或OpenEx成員函數(shù)指定一個(gè)DSN，就建立起了與DSN的底層數(shù)據(jù)源的連接（打開數(shù)據(jù)庫(kù)）。成員函數(shù)Close關(guān)閉數(shù)據(jù)庫(kù)。CDatabase對(duì)象通常與一個(gè)或多個(gè)記錄集（CRecordset對(duì)象）一起使用，通過CRecordset類的各成員函數(shù)完成對(duì)數(shù)據(jù)源的讀寫操作。

通過ODBC訪問一個(gè)Excel表的編程實(shí)例代碼如下：

static void do_ugopen_api(void)
{
CDatabase Database; // 定義一個(gè)MFC的CDatabse數(shù)據(jù)庫(kù)類對(duì)象Databse
CString SQLCommand = "select `Serial_Number`, `Outer_Diameter`, `Inner_Diameter`,`Height` from `Sheet1$`"; // SQL查詢語(yǔ)句
DWORD dwOptions = 0;// 設(shè)置連接的建立方式
CDBVariant temp;// 數(shù)據(jù)庫(kù)數(shù)據(jù)通用類型
int result; // 儲(chǔ)存返回值的變量
char buf[133];
try
{
result = Database.OpenEx( "DSN=Standard Part", dwOptions ); // 打開數(shù)據(jù)庫(kù)
if( result != 0 ) // 如果成功打開
{
CRecordset rs( &Database ); // 定義記錄集
if ( rs.Open( CRecordset::snapshot, SQLCommand ) != false )
{
rs.MoveFirst( );
short nFields = rs.GetODBCFieldCount( );// 獲取記錄的字段數(shù)目
UF_UI_open_listing_window( );
while( !rs.IsEOF( ) )
{
for( short index = 1; index < nFields; index++ )
{
rs.GetFieldValue( index, temp );
sprintf(buf,"%f",temp.m_dblVal );
UF_UI_write_listing_window(buf );
UF_UI_write_listing_window( "t" );
}
UF_UI_write_listing_window( "n" );
rs.MoveNext( );
}
rs.Close( );// 關(guān)閉記錄集
}
Database.Close(); // 關(guān)門數(shù)據(jù)庫(kù)連接
}
}
catch( CDBException *pe ) // 出錯(cuò)處理
{
AfxMessageBox( "Exception!" );
AfxMessageBox( pe->m_strError );
pe -> Delete( );
}
}

2.3 通過ADO訪問外部數(shù)據(jù)

    ADO(ActiveX Data Objects)是微軟的數(shù)據(jù)庫(kù)對(duì)象技術(shù)，ADO里面包括連接數(shù)據(jù)庫(kù)的對(duì)象，從查詢語(yǔ)句中返回?cái)?shù)據(jù)的記錄集對(duì)象和表現(xiàn)數(shù)據(jù)元素的字段對(duì)象。支持ADO編程的庫(kù)文件是msado15.dll，它默認(rèn)保存在“c:program filescommon silessystemado”目錄下，動(dòng)態(tài)鏈接庫(kù)msado15.dll封裝了ADO的所有功能。在默認(rèn)情況下，Visual C++不支持ADO對(duì)象。要在程序中使用ADO對(duì)象，需要使用#import命令將ADO庫(kù)文件導(dǎo)入到工程中，代碼如下：

#import “c:Program FilesCommon FilesSystemadomsado15.dll” no_namespace rename(“EOF”,”adoEOF”) rename(“BOF”,”adoBOF”)

    參數(shù)no_namespace 表示不使用ADO的名字空間。為了避免出現(xiàn)常量名沖突，需要將EOF改名為adoEOF、BOF改名為adoBOF。

    ADO庫(kù)包含3個(gè)基本接口，即_ConnectionPtr接口、_CommandPtr接口和_RecordsetPtr接口。它們分別對(duì)應(yīng)Connection對(duì)象、Command對(duì)象和Recordset對(duì)象。通過這三個(gè)基本接口可實(shí)現(xiàn)對(duì)數(shù)據(jù)庫(kù)的訪問。

通過ADO訪問數(shù)據(jù)庫(kù)的一般步驟如下：

（1）連接到數(shù)據(jù)源；
（2）指定訪問數(shù)據(jù)源的命令（查詢、更新、刪除等操作命令）；
（3）執(zhí)行命令。

有關(guān)ADO庫(kù)基本接口的使用方法請(qǐng)參見相關(guān)的參考手冊(cè)，下面給出通過ADO訪問Access數(shù)據(jù)庫(kù)表的實(shí)例程序代碼段：

bool DoAdoTest( void )
{
// 初始化對(duì)COM的調(diào)用
CoInitialize( 0 );
_ConnectionPtr pConnection = NULL; // 連接
_RecordsetPtr pRecordset = NULL; // 記錄集
HRESULT hr = E_UNEXPECTED;
CString strConnectionString( "Provider=Microsoft.Jet.OLEDB.4.0;Data 落Source=f:\ug\chapter3_4\screw.mdb" ); // 連接字符串
CString strSqlCommandString( "SELECT * From screw_table " ); // SQL語(yǔ)句
pConnection.CreateInstance( __uuidof( Connection ) ); // ( "ADODB.Connection" );
pRecordset.CreateInstance( __uuidof( Recordset ) ); // ( "ADODB.Recordset" );
try
{ hr = pConnection->Open( ( _bstr_t )strConnectionString, "", "", adModeUnknown ); // 連接數(shù)據(jù)庫(kù)
MessageBox( NULL, "連接數(shù)據(jù)庫(kù)成功！", "提示", MB_OK | MB_ICONINFORMATION );
}
catch ( _com_error e )
{
MessageBox( NULL, "連接數(shù)據(jù)庫(kù)失敗！", "錯(cuò)誤", MB_OK | MB_ICONERROR );
return false;
}
try
{
hr = pRecordset->Open( ( _bstr_t )strSqlCommandString,
_variant_t((IDispatch*)pConnection,true),
adOpenStatic,
adLockOptimistic,
adCmdText ); // 獲取記錄集
}
catch ( _com_error* e )
{
e->ErrorMessage();
MessageBox( NULL, "打開記錄集失敗！", "錯(cuò)誤", MB_OK | MB_ICONERROR );
}
CString tmp;
UF_UI_open_listing_window();
// 輸出字段名
long lFieldsCount = -1;
lFieldsCount = pRecordset->GetFields()->Count;
for ( long i = 0; i < lFieldsCount; i++ )
{
tmp.Format( "%-7s", ( LPCSTR )pRecordset->GetFields()->Item[ i ]->Name );
UF_UI_write_listing_window( ( LPTSTR )( LPCSTR )tmp );
UF_UI_write_listing_window( "t" );
}
UF_UI_write_listing_window( "nn" );
// 輸出所有記錄
pRecordset->MoveFirst();
while(!pRecordset->adoEOF)
{
tmp = pRecordset->GetCollect( 0L );
UF_UI_write_listing_window( ( LPTSTR )( LPCSTR )tmp );
……//輸出記錄中其他字段值
pRecordset->MoveNext();
}
pRecordset->Close();
pRecordset = NULL;
pConnection->Close();
pConnection = NULL;
CoUninitialize();
return true;
}

3 結(jié)論

    在UG二次開發(fā)過程中，確定選擇哪種方法訪問外部數(shù)據(jù)，取決于具體的應(yīng)用系統(tǒng)要求。通過UG/OPEN API編程較適合于對(duì)外部文本文件的訪問，可方便實(shí)現(xiàn)用戶與UG信息窗口交互等功能；通過ODBC和ADO技術(shù)可以訪問各種支持的數(shù)據(jù)源，包括文本文件、Excel表及各種關(guān)系型數(shù)據(jù)庫(kù)表等，ADO與ODBC相比，使用更加簡(jiǎn)便，免去了繁瑣的配置數(shù)據(jù)源工作，但有些數(shù)據(jù)庫(kù)僅支持ODBC，不直接支持ADO數(shù)據(jù)庫(kù)技術(shù)。

[參考文獻(xiàn)]
[1] 董正衛(wèi)，田立中，付宜利.UG/OPEN API編程基礎(chǔ)[M].北京：清華大學(xué)出版社，2002.
[2] UGS公司UG/OPENAPIReference.1997.
[3] David J.Kruglinski. Visual C++ 技術(shù)內(nèi)幕[M] .北京：清華大學(xué)出版社，2001.