UG二次开发中外部数据访问方法研究

砂轮

1 前言
随着UG系统的推广和普及应用，基于UG平台的二次开发工作显得越来越重要，在UG的二次开发应用系统中，经常需要与各种外部数据打交道， UG/OPEN API提供了丰富的文件访问操作函数，利用这些操作函数及VC++的MFC类库，可以方便地实现外部数据读写访问编程。
2 外部数据访问的主要方法
在UG二次开发应用系统中，主要访问的外部数据有文本文件、Excel表、关系型数据库表等，通常可以通过以下方法访问这些外部数据：
（1）通过UG/OPEN API提供的文件操作函数访问外部数据
（2）通过ODBC数据源访问外部数据
（3）通过ADO访问外部数据
( ~5 u/ |" R  q$ b9 _  E) S2.1 通过UG/OPEN API提供的文件操作函数访问文本文件数据
UG/OPEN API中有关文件操作的函数包含在头文件uf_cfi.h中，通过函数uc4500可以打开二进制文件，相关的文件操作函数有uc4510、uc4511、uc4512、uc4513及uc4520、uc4521、uc4522、uc4523，通过函数uc4504可以打开文本文件，相关的文件操作函数有uc4514、uc4524、uc4525，函数uc4540用于关闭文件，判断文件是否存在使用函数UF_CFI_ask_file_exist。
/ Q' R4 ^# A3 n' Y+ W9 }8 W通过UG/OPEN API提供的文件操作函数访问外部数据时，要注意以下问题：
（1）UG/Manager 和 IMAN中的文件和文件夹操作不能使用uf_cfi.h中函数；
（2）UG/OPEN API中对文件和文件夹标识符的长度有如下限制：
文件名长度不能超过UF_CFI_MAX_FILE_NAME_LEN；文件夹路径的长度不能超过UF_CFI_MAX_PATH_NAME_LEN；整个文件路径的长度不能超过UF_CFI_MAX_PATH_NAME_LEN。
! R, _9 i3 y- K( }访问文本文件的程序流程如下图：
  S) ~+ k2 a5 t6 a! N
2.2 通过ODBC数据源访问Excel表或关系型数据库表数据
* M' h$ ^1 W6 I% I* j  @) WODBC（Open Database connectivity 开放式数据库互连）是由微软公司提出的一个用于访问数据库的统一界面标准，它提供了一个一致的应用程序编程接口，该接口使用一个针对数据库的驱动程序与不同的数据库协同工作。
; G% Z: _, q# u" q% r7 L: }6 k通过ODBC访问外部数据时，需要先指定访问的数据源DSN（Data Source Name），以指定ODBC与相关的驱动程序相对应的入口。在控制面板的管理工具中可以打开ODBC数据源管理器，指定DSN。
6 G5 H% F# ~9 e% X建立MFC数据库类Cdatabse对象可以实现对外部数据的访问编程。一个CDatabase对象代表与数据源的一个连接。创建一个CDatabase对象之后，调用Open或OpenEx成员函数指定一个DSN，就建立起了与DSN的底层数据源的连接（打开数据库）。成员函数Close关闭数据库。CDatabase对象通常与一个或多个记录集（CRecordset对象）一起使用，通过CRecordset类的各成员函数完成对数据源的读写操作。
" b/ {/ R$ O0 ~! C# f通过ODBC访问一个Excel表的编程实例代码如下：
  y1 D2 F; Y, |$ ustatic void do_ugopen_api(void)
3 g' W, O% Y8 X% A{
CDatabase Database; // 定义一个MFC的CDatabse数据库类对象Databse
CString SQLCommand = "select `Serial_Number`, `Outer_Diameter`, `Inner_Diameter`,`Height` from `Sheet1$`"; // SQL查询语句
/ x/ W! C3 a$ t9 m) K$ N) K% TDWORD dwOptions = 0;// 设置连接的建立方式
& y, v$ g( Q3 q( Z" M% wCDBVariant temp;// 数据库数据通用类型
: E8 @+ f4 L% o0 W$ m; Kint result; // 储存返回值的变量
+ `9 n$ ~; ]7 E: t( q' ~6 Z5 Q# Jchar buf[133];
  T4 E( s% N% `6 x( otry
3 k' H+ v( k0 n0 h: X8 j7 T{
$ P6 U8 w4 I+ X6 N6 e  u5 zresult = Database.OpenEx( "DSN=Standard Part", dwOptions ); // 打开数据库
if( result != 0 ) // 如果成功打开
; o7 u1 R- b9 q  v6 K{
- `+ l+ u" M2 l. z- J; C9 J6 XCRecordset rs( &Database ); // 定义记录集
if ( rs.Open( CRecordset::snapshot, SQLCommand ) != false )
& u5 k+ Z8 ~6 F* }: S& j) j7 y* S{
! y' {& M$ b7 f/ Z# Ars.MoveFirst( );
short nFields = rs.GetODBCFieldCount( );// 获取记录的字段数目
UF_UI_open_listing_window( );
while( !rs.IsEOF( ) )
{
8 y7 {/ ~+ V# N" G5 Bfor( short index = 1; index m_strError );
2 U' K/ u4 A. f( L2 w! Epe -> Delete( );
}
}
3 R6 a( Y5 S* F+ E3 f0 @. I2.3 通过ADO访问外部数据
ADO(ActiveX Data Objects)是微软的数据库对象技术，ADO里面包括连接数据库的对象，从查询语句中返回数据的记录集对象和表现数据元素的字段对象。支持ADO编程的库文件是msado15.dll，它默认保存在“c:\program files\common siles\system\ado\”目录下，动态链接库msado15.dll封装了ADO的所有功能。在默认情况下，Visual C++不支持ADO对象。要在程序中使用ADO对象，需要使用#import命令将ADO库文件导入到工程中，代码如下：
#import “c:\Program Files\Common Files\System\ado\msado15.dll” no_namespace rename(“EOF”,”adoEOF”) rename(“BOF”,”adoBOF”)
5 Y1 ~! n4 N5 s8 J- R参数no_namespace 表示不使用ADO的名字空间。为了避免出现常量名冲突，需要将EOF改名为adoEOF、BOF改名为adoBOF。
ADO库包含3个基本接口，即_ConnectionPtr接口、_CommandPtr接口和_RecordsetPtr接口。它们分别对应Connection对象、Command对象和Recordset对象。通过这三个基本接口可实现对数据库的访问。
0 _! g' {0 @3 _6 ~2 C2 I+ Z: |. K9 o通过ADO访问数据库的一般步骤如下：
（1）连接到数据源；
2 l9 N1 O, X+ a! C& p" B（2）指定访问数据源的命令（查询、更新、删除等操作命令）；
& k5 `( ]" ?% T, I7 `（3）执行命令。
; \2 g8 N5 ?! I% Q7 V4 ~有关ADO库基本接口的使用方法请参见相关的参考手册，下面给出通过ADO访问Access数据库表的实例程序代码段：
bool DoAdoTest( void )
{
5 {# R3 A! D% U  T" A& n// 初始化对COM的调用
CoInitialize( 0 );
_ConnectionPtr pConnection = NULL; // 连接
9 O+ x$ T3 B; k! r_RecordsetPtr pRecordset = NULL; // 记录集
% F" {8 ~; f& n7 ^& Y2 _HRESULT hr = E_UNEXPECTED;
: p; w  X: p* m2 mCString strConnectionString( "Provider=Microsoft.Jet.OLEDB.4.0;Data 落Source=f:\\ug\\chapter3_4\\screw.mdb" ); // 连接字符串
1 B$ o4 v  x9 c+ aCString strSqlCommandString( "SELECT * From screw_table " ); // SQL语句
+ w& @( E5 I$ d) F5 NpConnection.CreateInstance( __uuidof( Connection ) ); // ( "ADODB.Connection" );
0 }% r8 {; b+ O) jpRecordset.CreateInstance( __uuidof( Recordset ) ); // ( "ADODB.Recordset" );
, M' {% e+ s$ y( |* c  ~- Vtry
" {/ T+ a5 }1 M  K9 n{ hr = pConnection->Open( ( _bstr_t )strConnectionString, "", "", adModeUnknown ); // 连接数据库
MessageBox( NULL, "连接数据库成功！", "提示", MB_OK | MB_ICONINFORMATION );
}
catch ( _com_error e )
" e+ o3 v: D  w8 [{
MessageBox( NULL, "连接数据库失败！", "错误", MB_OK | MB_ICONERROR );
% D3 i  F& L0 g& i2 B& Nreturn false;
}
0 H5 _( u$ Q. Gtry
  K& x& H6 T& Q: r# }  @& o# i* @{
2 a6 g3 Z: E! [* c4 E- k& Xhr = pRecordset->Open( ( _bstr_t )strSqlCommandString,
_variant_t((IDispatch*)pConnection,true),
adOpenStatic,
: u+ u5 \4 n) K7 }adLockOptimistic,
adCmdText ); // 获取记录集
' J2 A  w; I! x* ?' L# O: N+ t: q}
catch ( _com_error* e )
{
, Q$ P1 _' v0 A9 \( Ne->ErrorMessage();
$ R: Z  ~$ S. r+ o; d- vMessageBox( NULL, "打开记录集失败！", "错误", MB_OK | MB_ICONERROR );
" n0 W! _% w# ^5 t, T  B}
& [- t0 G' s. _CString tmp;
$ x' b, Z4 V* ~$ ~1 q5 EUF_UI_open_listing_window();
// 输出字段名
long lFieldsCount = -1;
) w, m) K6 d5 G* Z' BlFieldsCount = pRecordset->GetFields()->Count;
for ( long i = 0; i GetFields()->Item[ i ]->Name );
) P* n: W3 p- @6 i# k2 PUF_UI_write_listing_window( ( LPTSTR )( LPCSTR )tmp );
5 L2 u& w$ J; T0 H+ gUF_UI_write_listing_window( "\t" );
}
1 K+ X. j" M/ s& V: vUF_UI_write_listing_window( "\n\n" );
// 输出所有记录
. S6 P( J! ^: B3 V/ P* \  x+ E% P. ApRecordset->MoveFirst();
8 _+ l; v4 c& Zwhile(!pRecordset->adoEOF)
3 w8 m' w" b7 _, z1 ]; L3 r{
' A% @3 n: I8 z/ V9 Etmp = pRecordset->GetCollect( 0L );
UF_UI_write_listing_window( ( LPTSTR )( LPCSTR )tmp );
, y; ?. G/ C' e4 a& u……//输出记录中其他字段值
: Q8 _; n, e9 O, l4 bpRecordset->MoveNext();
+ ?8 G$ ?8 ?# d: I}
5 ?( k7 S( y4 |+ i/ R4 }pRecordset->Close();
; c3 ?, W6 `) }/ Q8 M+ Z4 o. [pRecordset = NULL;
5 Q0 c+ E6 \9 epConnection->Close();
0 D% ~3 q! c7 b9 j/ F! ~pConnection = NULL;
! K) i# v% _' ~, u9 p1 U: BCoUninitialize();
0 s, q/ E7 A8 X- t% f: E% D6 |return true;
}
3 结论
  F6 N/ l+ l' ?$ l. u4 G: N在UG二次开发过程中，确定选择哪种方法访问外部数据，取决于具体的应用系统要求。通过UG/OPEN API编程较适合于对外部文本文件的访问，可方便实现用户与UG信息窗口交互等功能；通过ODBC和ADO技术可以访问各种支持的数据源，包括文本文件、Excel表及各种关系型数据库表等，ADO与ODBC相比，使用更加简便，免去了繁琐的配置数据源工作，但有些数据库仅支持ODBC，不直接支持ADO数据库技术。
文章关键词：