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

砂轮

1 前言
随着UG系统的推广和普及应用，基于UG平台的二次开发工作显得越来越重要，在UG的二次开发应用系统中，经常需要与各种外部数据打交道， UG/OPEN API提供了丰富的文件访问操作函数，利用这些操作函数及VC++的MFC类库，可以方便地实现外部数据读写访问编程。
) i7 N1 S7 u3 O$ f5 C. \2 外部数据访问的主要方法
在UG二次开发应用系统中，主要访问的外部数据有文本文件、Excel表、关系型数据库表等，通常可以通过以下方法访问这些外部数据：
2 ?% u( L" Z& W- U3 a8 a5 |（1）通过UG/OPEN API提供的文件操作函数访问外部数据
（2）通过ODBC数据源访问外部数据
( N' d- y; H: D. E1 ]（3）通过ADO访问外部数据
6 i+ e! S: B+ u) {* @! s2.1 通过UG/OPEN API提供的文件操作函数访问文本文件数据
) Y. ]. K+ V9 E+ }! y2 E' E) Z' dUG/OPEN API中有关文件操作的函数包含在头文件uf_cfi.h中，通过函数uc4500可以打开二进制文件，相关的文件操作函数有uc4510、uc4511、uc4512、uc4513及uc4520、uc4521、uc4522、uc4523，通过函数uc4504可以打开文本文件，相关的文件操作函数有uc4514、uc4524、uc4525，函数uc4540用于关闭文件，判断文件是否存在使用函数UF_CFI_ask_file_exist。
  F* j; D+ y  L$ E) ?4 s0 A通过UG/OPEN API提供的文件操作函数访问外部数据时，要注意以下问题：
- m& C5 P; ^7 I（1）UG/Manager 和 IMAN中的文件和文件夹操作不能使用uf_cfi.h中函数；
（2）UG/OPEN API中对文件和文件夹标识符的长度有如下限制：
0 Q/ ?" v( I( V2 ~. w文件名长度不能超过UF_CFI_MAX_FILE_NAME_LEN；文件夹路径的长度不能超过UF_CFI_MAX_PATH_NAME_LEN；整个文件路径的长度不能超过UF_CFI_MAX_PATH_NAME_LEN。
" ^6 `: ]9 K8 Y8 F访问文本文件的程序流程如下图：

$ i; @$ ]0 Q1 j* \9 v9 }2.2 通过ODBC数据源访问Excel表或关系型数据库表数据
9 W1 s  b1 L% m1 h+ G! ~! l; OODBC（Open Database connectivity 开放式数据库互连）是由微软公司提出的一个用于访问数据库的统一界面标准，它提供了一个一致的应用程序编程接口，该接口使用一个针对数据库的驱动程序与不同的数据库协同工作。
/ Q( T% f* d% q% H& o) n6 Y通过ODBC访问外部数据时，需要先指定访问的数据源DSN（Data Source Name），以指定ODBC与相关的驱动程序相对应的入口。在控制面板的管理工具中可以打开ODBC数据源管理器，指定DSN。
建立MFC数据库类Cdatabse对象可以实现对外部数据的访问编程。一个CDatabase对象代表与数据源的一个连接。创建一个CDatabase对象之后，调用Open或OpenEx成员函数指定一个DSN，就建立起了与DSN的底层数据源的连接（打开数据库）。成员函数Close关闭数据库。CDatabase对象通常与一个或多个记录集（CRecordset对象）一起使用，通过CRecordset类的各成员函数完成对数据源的读写操作。
/ ^1 v+ d# `/ b4 l' K- Q- c通过ODBC访问一个Excel表的编程实例代码如下：
9 w- ~) v  S( }) ^7 z7 hstatic void do_ugopen_api(void)
; q5 P* s3 T7 v0 v{
CDatabase Database; // 定义一个MFC的CDatabse数据库类对象Databse
CString SQLCommand = "select `Serial_Number`, `Outer_Diameter`, `Inner_Diameter`,`Height` from `Sheet1$`"; // SQL查询语句
  F, W8 p; f0 M& e; [  WDWORD dwOptions = 0;// 设置连接的建立方式
CDBVariant temp;// 数据库数据通用类型
) D% ^5 q$ Z. s% f6 `" `int result; // 储存返回值的变量
char buf[133];
try
4 P& K% b0 _; [6 N, p# b. t" K2 j  ]- r{
result = Database.OpenEx( "DSN=Standard Part", dwOptions ); // 打开数据库
if( result != 0 ) // 如果成功打开
% X# l3 c3 |* D" z4 e1 W{
CRecordset rs( &Database ); // 定义记录集
6 Z1 N0 e- V, ]' V6 M  u1 j7 M3 _if ( rs.Open( CRecordset::snapshot, SQLCommand ) != false )
{
$ n* b0 O7 |0 W" l0 l  }2 zrs.MoveFirst( );
  P$ J; e3 N9 a8 Q9 cshort nFields = rs.GetODBCFieldCount( );// 获取记录的字段数目
UF_UI_open_listing_window( );
while( !rs.IsEOF( ) )
: ^5 v0 E) H# x1 O$ K4 ]{
for( short index = 1; index m_strError );
7 @. n8 X1 G# U$ cpe -> Delete( );
}
}
) e6 R9 v# j1 x% H2.3 通过ADO访问外部数据
$ E# U8 m7 k+ ]' d, pADO(ActiveX Data Objects)是微软的数据库对象技术，ADO里面包括连接数据库的对象，从查询语句中返回数据的记录集对象和表现数据元素的字段对象。支持ADO编程的库文件是msado15.dll，它默认保存在“c:\program files\common siles\system\ado\”目录下，动态链接库msado15.dll封装了ADO的所有功能。在默认情况下，Visual C++不支持ADO对象。要在程序中使用ADO对象，需要使用#import命令将ADO库文件导入到工程中，代码如下：
6 ]0 w2 w6 @% w- I2 _7 e; O#import “c:\Program Files\Common Files\System\ado\msado15.dll” no_namespace rename(“EOF”,”adoEOF”) rename(“BOF”,”adoBOF”)
) o8 X- {) c/ [3 t; |. j# h- h7 f参数no_namespace 表示不使用ADO的名字空间。为了避免出现常量名冲突，需要将EOF改名为adoEOF、BOF改名为adoBOF。
9 V5 E4 z2 b& B" \- RADO库包含3个基本接口，即_ConnectionPtr接口、_CommandPtr接口和_RecordsetPtr接口。它们分别对应Connection对象、Command对象和Recordset对象。通过这三个基本接口可实现对数据库的访问。
1 b1 Z+ s, Y/ _5 p  Z% \7 }3 V6 Y通过ADO访问数据库的一般步骤如下：
6 @) ^( R  o8 U0 d  B* V- J（1）连接到数据源；
3 Z  u# m! |9 K4 n' F: z' t; ^' C（2）指定访问数据源的命令（查询、更新、删除等操作命令）；
  T6 g/ ~# N! O% `- d$ q( Z（3）执行命令。
有关ADO库基本接口的使用方法请参见相关的参考手册，下面给出通过ADO访问Access数据库表的实例程序代码段：
bool DoAdoTest( void )
0 s4 U6 `6 s  R4 d{
// 初始化对COM的调用
% ?$ [: g2 A& k, ?1 S* P; u# b# ACoInitialize( 0 );
+ I# G( E5 s' H) N4 z% N3 N* \_ConnectionPtr pConnection = NULL; // 连接
( |. ]( q; p6 g! a1 E; n( A: |5 g_RecordsetPtr pRecordset = NULL; // 记录集
HRESULT hr = E_UNEXPECTED;
' _* V$ p+ {6 k/ ICString strConnectionString( "Provider=Microsoft.Jet.OLEDB.4.0;Data 落Source=f:\\ug\\chapter3_4\\screw.mdb" ); // 连接字符串
CString strSqlCommandString( "SELECT * From screw_table " ); // SQL语句
; \( C, o& s4 ~  c5 a$ tpConnection.CreateInstance( __uuidof( Connection ) ); // ( "ADODB.Connection" );
pRecordset.CreateInstance( __uuidof( Recordset ) ); // ( "ADODB.Recordset" );
try
{ hr = pConnection->Open( ( _bstr_t )strConnectionString, "", "", adModeUnknown ); // 连接数据库
MessageBox( NULL, "连接数据库成功！", "提示", MB_OK | MB_ICONINFORMATION );
}
catch ( _com_error e )
" C* @  ~% L% u! T& }6 B{
MessageBox( NULL, "连接数据库失败！", "错误", MB_OK | MB_ICONERROR );
return false;
}
try
{
$ E9 |. d* r2 P# f, p6 p# E1 mhr = pRecordset->Open( ( _bstr_t )strSqlCommandString,
_variant_t((IDispatch*)pConnection,true),
adOpenStatic,
adLockOptimistic,
adCmdText ); // 获取记录集
}
, l. |. q: _5 c) g8 W5 Ecatch ( _com_error* e )
{
& Y0 V; a6 E4 B; l* b! Oe->ErrorMessage();
9 H$ J) ?3 d' A# Z, a8 [7 [MessageBox( NULL, "打开记录集失败！", "错误", MB_OK | MB_ICONERROR );
$ w' t! I$ f: n- J. w% A}
. t8 C1 r4 \; ?! p& dCString tmp;
6 d4 M6 u0 h& ^/ ~/ S0 TUF_UI_open_listing_window();
// 输出字段名
long lFieldsCount = -1;
lFieldsCount = pRecordset->GetFields()->Count;
for ( long i = 0; i GetFields()->Item[ i ]->Name );
7 f+ K2 k) M5 qUF_UI_write_listing_window( ( LPTSTR )( LPCSTR )tmp );
UF_UI_write_listing_window( "\t" );
5 r/ X+ y0 [+ k# S}
* b; d' i+ q8 R' A8 B  y  n# e- FUF_UI_write_listing_window( "\n\n" );
8 h3 f0 v' M) ^// 输出所有记录
1 e& O6 f7 H! U  {3 V7 C% W3 N  W3 m! DpRecordset->MoveFirst();
while(!pRecordset->adoEOF)
. {6 Z1 I% p1 q! J: F4 N$ ?  b" R) D{
tmp = pRecordset->GetCollect( 0L );
UF_UI_write_listing_window( ( LPTSTR )( LPCSTR )tmp );
……//输出记录中其他字段值
. U8 @8 V: }" H4 E1 n1 npRecordset->MoveNext();
}
- O  f" i2 y( o1 a6 x( ~pRecordset->Close();
pRecordset = NULL;
pConnection->Close();
pConnection = NULL;
4 r" s+ \$ @' }0 i' {( ?, ^8 N  DCoUninitialize();
  I* K1 n$ L$ W/ W5 areturn true;
9 P2 z/ w( c' ^1 G( i}
* O- ~, P6 }. E7 N; b( x% I' f3 结论
& J- m6 T1 D& W4 o2 g) Z在UG二次开发过程中，确定选择哪种方法访问外部数据，取决于具体的应用系统要求。通过UG/OPEN API编程较适合于对外部文本文件的访问，可方便实现用户与UG信息窗口交互等功能；通过ODBC和ADO技术可以访问各种支持的数据源，包括文本文件、Excel表及各种关系型数据库表等，ADO与ODBC相比，使用更加简便，免去了繁琐的配置数据源工作，但有些数据库仅支持ODBC，不直接支持ADO数据库技术。
文章关键词：