| |
一、 课程目标
通过本课程学习，你可以掌握如下知识：
掌握tuxedo中STRING类型buffer的用途
掌握tuxedo中CARRAY类型buffer的用途
掌握tuxedo中FML(FML32)类型buffer的用途
掌握tuxedo中VIEW(VIEW32)类型buffer的用途
注:后续的课程将介绍Tuxedo新增的数据类型:EFML(Embedded Record in FML)、XML Buffer
二、 String类型buffer介绍
（1）STRING类型buffer简介
STRING类型buffer是主要用于面向行、变长度的文本信息类型buffer。STRING类型buffer要求必须以NULL作为结束符的。如果系统采用STRING类型，那么在配置ubbconfig文件时，必须在*MACHINE部分配置TYPE，指明buffer类型为STRING类型。在两种不同类型架构的机器进行buffer传输时候，TUXEDO对STRING类型buffer进行加码、解码过程。无论系统申请了多少长度的buffer，系统自动按着NULL所在的位置决定STRING类型的buffer长度。
（2）STRING类型buffer如何申请
char *SndBuf;
SndBuf = (char *) tpalloc("STRING",NULL,1024)
（3）STRING类型使用方法和调用方法
strcpy(SndBuf,"Bea Tuxedo");
tpcall("TOUPPER",SndBuf,0,&RcvBuf,&len,0);
三、 CARRAY类型buffer介绍
（1）CARRAY类型buffer简介
CARRAY类型buffer是一种独立于机器的buffer类型。用户在使用时必须指定CARRAY类型数据的长度，CARRAY类型数据可以包含NULL字符。CARRAY类型数据不需要加、解码过程。CARRAY类型数据可以用来传输汉字、二进制数据、文件、图形等。CARRAY类型可以作为FML（FML32）、VIEW（VIEW32）的数据类型子项buffer。
（2）CARRAY类型buffer如何申请
tpalloc("CARRAY",NULL,1024*2)
（3）CARRAY类型使用方法和调用方法
四、 VIEW（VIEW32）类型buffer介绍
（1）VIEW类型buffer简介
Tuxedo使用VIEW类型buffer处理类似C语言的结构等数据类型复杂数据。使用VIEW类型buffer可以将各数据元素与一种结构数据类型结合，通过结构就可以访问各数据元素。VIEW类型数据即使没有没有数据也占用空间，结构发生变化，需要重新编译程序。
注明:(VIEW类型buffer是16位寻址的,VIEW32是32位寻址的.)
（2）VIEW类型buffer使用方法
使用VIEW类型数据步骤：
建立VIEW文件
设置环境变量
编译VIEW文件
在代码中包含VIEW头文件，在程序中使用VIEW结构及API函数
编译程序
运行程序
（1）建立VIEW文件
|
VIEW user
* VIEW structure for user information */
#type cname fbname count flag size null
long count COUNT 1 - - “” 0
float sumfee SUMFEE 1 - - 0.0
string usrname USRNAME 1 - 80 “”
short num NUM 1 - - 0
END
|
（2）设置环境变量
/* view文件存放路径，使用冒号分割(NT用分号)*/
VIEWDIR＝/inc
/* 用逗号分割的二进制view文件 */
VIEWFILES=user.V
export VIEWDIR VIEWFILES
（3）编译VIEW文件
使用viewc（viewc32）编译view文件
-n user.v
view命令简介：
viewc [-n] [-d viewdir] viewfile [viewfile ...]
或者：
viewc32 [-n] [-d viewdir] viewfile [viewfile ...]
[-d viewdir]：指定输出文件的路径（默认在当前目录下）
[-n]：指定在编译view结构类型数据不产生FML buffer数据结构
（4）view编译后生成的头文件
|
struct user {
/* VIEW structure for user information */
long count;
float sumfee;
char usrname[80];
short num;
};
|
（5）VIEW类型buffer的使用
struct user *pszUser;
pszUser=(struct user *)tpalloc("VIEW"," user",sizeof(user));
…………………
pszUser ->count = 1680;
pszUser ->sumfee = 198.96;
strcpy(pszUser->usrname,"Wsy");
pszUser->num = 160;
…………………
tpcall("PSVC",(char *)pszUser,0,(char **)&pszUser,&rcvlen,0);
…………………
五、 FML（FML32）类型buffer介绍
（1）VIEW类型buffer简介
FML类型buffer允许存取多个命名的字段。例如：（NAME: "BEA",ADDRESS "China Beijing",PHONE "010-85281188"）。每一个命名的字段可以在buffer中存放零个或更多个（occurrences）的值.
注明:(FML类型buffer是16位寻址的,FML32是32位寻址的.)
（2）FML支持的数据类型：
Short
Char
Long
Float
Double
String
Carray
（3）FML类型buffer使用方法
使用FML类型数据步骤：
建立FML文件
设置环境变量
编译FML文件
在代码中包含FML头文件，在程序中使用FML API函数
编译程序
运行程序
（1）建立FML Field Table文件
|
*base 1000
# name number type flags comments
COUNT 1 long - -
SUMFEE 2 float - -
USRNAME 3 string - -
NUM 4 short - -
|
（2）设置环境变量
set FLDTBLDIR32="c: uxedowsy"
set FIELDTBLS32=user.fld
其中：
FLDTBLDIR（FLDTBLDIR32）：指明Field Table文件的名字，多个用逗号分割
FIELDTBLS （FIELDTBLS32）：Filed Table文件的所在路径，多个用冒号分割，在WinNT系统中使用分号分割.
（3）编译FML Field Table文件
使用mkfldhdr（mkfldhdr32）编译Field Table文件
user.fld
（4）FML Field Table编译后生成的头文件
|
/* fname fldid */
/* ----- ----- */
#define COUNT ((FLDID32)33555433) /* number: 1001 type: long */
#define SUMFEE ((FLDID32)100664298)/* number: 1002 type: float */
#define USRNAME ((FLDID32)167773163)/* number: 1003 type: string */
#define NUM ((FLDID32)1004) /* number: 1004 type: short */
|
（5）FML类型buffer的使用
FBFR32 *SndBuf;
SndBuf = (FBFR32 *)tpalloc("FML32",NULL,1024);
…………………
lCount = 1680;
Fchg32(SndBuf, COUNT,0,(char *)&lCount ,0);
fSumFee = 198.96;
Fchg32(SndBuf, SUMFEE, (char *)&fSumFee,0);
Strcpy(sUsrName , "wsy");
Fchg32(SndBuf, USRNAME, (char *)sUsrName,0);
iNum = 160;
Fchg32(SndBuf, SUMFEE, (char *)&iNum,0);
…………………
tpcall("PSVC",(char *) SndBuf,0,(char **)& SndBuf,&rcvlen,0);
Fget32(SndBuf, COUNT,0, (char *)&lCount ,0);
Fget32(SndBuf, USRNAME,0, (char *)sUsrName,0);
…………………
注:FML和VIEW类型buffer的API函数在后续的文章有详细的介绍和代码分析.
|
