tuxedo速成培训教材

一个例子（服务端）
• 服务端：
– 包含TUXEDO系统头文件”atmi.h” – 象所有的TUXEDO交易函数一样，TOUPPER 不用直接返回任何值，所以返回类型为void – 从客户端收到的数据放在TPSVCINFO结构中， 是唯一的入参 – 交易处理… – 用tpreturn()将数据缓冲返回客户端
分布式系统的层次结构
• 分布式系统的Байду номын сангаас要层次：
– 用户界面：被分成表示管理和表示逻 辑。代表有主机框架的仿真终端； UNIX系统的X终端等；还包括Web浏 览器界面。 – 商业逻辑：包含应用逻辑和应用规则。 – 数据管理：分为数据访问逻辑（SQL） 和数据库管理。
基本的C/S模式
客户端模块 （可能包含逻辑处理） 服务端模块 （在数据库中包含逻辑处理）
TUXEDO 应用的三个基本部分
• 客户端：提交交易请求
• 服务端：响应请求交易的服务 • 配置文件：描述机器信息、服务信息等
一个例子 （图示）
main () { main
()
void TOUPPER (TPSVCINFO *p) {
{
tpinit() p=tpalloc() tpcall(“TOUPPER”,p,0,&p,&l,0) tpfree(p) tpterm() return }
一个例子（客户端）
• 应用程序包含TUXEDO系统的头文 件”atmi.h”,以便引用TUXEDO的函数和变 量定义。 • 客户端调用tpinit()连接应用 • 用tpalloc()分配一个STRING类型数据缓冲 • 将数据拷贝进缓冲 • 用tpcall()包含数据缓冲，向交易 “TOUPPER”发一个同步请求 • 调用tpterm()切断与应用的连接
一个例子（配置文件）
• 有关应用的信息，如可用交易，交易位置，应用范围等， 有必要集中管理于单一资源。事实上，这些信息被集中于 文件UBBCONFIG。该文件分7节，主要部分内容描述如 下：
– *RESOURCES节包含全局信息，如：标识公告牌位置的唯一键值 （IPCKEY），主控节点的名字（MASTER），应用类型 （MODEL），SHM表示是一个单节点应用。 – *MACHINES节包含节点信息，如：机器物理名，TUXEDO系统 位置（TUXDIR），服务程序位置（APPDIR），以及本文件的二 进制码文件名（TUXCONFIG）。 – *GROUPS节包含一些管理用信息，如设定服务或交易的分布式事 务处理。 – *SERVERS节包含需要启动的交易和其组信息等其他信息。 – *SERVICES节包含影响应用操作方式的的必要信息。本节列出的 交易都是需要特别配置的，如有特别的优先级，装入参数，数据 依赖路由等。
–定义配置文件ubbconfig
ubbconfig, tmloadcf
tmboot
–启动Tuxedo –执行程序
Tuxedo速成培训
• • • • • • Tuxedo及C/S结构介绍 Tuxedo应用的一个简单例子 客户端开发 服务端开发 应用配置 Tuxedo管理命令
客户端在C/S模式中的作用
一个例子（建立应用）
• 建立一个TUXEDO应用，有以下关键步骤：
–确保环境变量设置正确
TUXCONFIG, PATH, TUXDIR, SHLIB_PATH, APPDIR, others„..
–编写client端和server端的代码，编译
buildclient, buildserver
• buildclient –f client.c –o client -w • buildserver –f simpserv.c –o simpserv –s TOUPPER
进程管理
为了使客户端能够访问TUXEDO交易，客户端程序必须连接 TUXEDO应用并进行登记。这种管理性步骤在切断连接时也要类似执 行一次。API如下： int tpinit(TPINIT *tpinfo) 客户端通过调用tpinit()与应用连接，进行交互，有以下事件发生： • 调用安全接口检查客户端是否需要认证 • 连接BB，使进一步的ATMI函数得到信息 • 使BBL了解BB中已经存在请求 • 建立客户端消息队列使服务可以发回返回信息，系统可以送出 广播通知等 int tpterm() 客户端调用tpterm()切断与应用的连接，结束了客户端的TUXEDO 进程，该过程发生以下事件： • BB入口删除，使BBL知道客户端已经离开 • 客户端离开BB，客户端的信号量被移除
客户端开发过程
客户端程序的设计和实现可以被分成2部分考虑： – 用户处理过程 – TUXEDO功能部分 TUXEDO功能部分 ，利用TUXEDO的ATMI API调用实现： – 基本的TUXEDO调试技巧 （tperrno,tpstrerror,userlog） – TUXEDO进程管理(tpinit,tpterm) – 基本数据缓冲管理(tpalloc,tprealloc,tpfree) – 基本通讯(tpcall,tpacall,tpgetrply)
应用管理 资源管理（RM）
数
据 访 问
请求“Z”
交易管理
处理请求 “Y”“Z”
TUXEDO的C/S方案
公告牌 机器信息 服务信息 交易信息 客户端信息
1
客户端回应Q
服务请求Q
5
2
4
3
客户端 tpcall(...)
服务端
Tuxedo速成培训
• • • • • • Tuxedo及C/S结构介绍 Tuxedo应用的一个简单例子 客户端开发 服务端开发 应用配置 Tuxedo管理命令
一个例子（服务端）
#include <stdio.h> #include <ctype.h> #include “atmi.h” void TOUPPER (TPSVCINFO *rqst) { int i; for ( i=0;i<rqst->len-1;i++) rqst->data[i] = toupper(rqst->data[i]); tpreturn(TPSUCCESS,0,rqst->data,0L,0); }
ATMI
ATMI
tpreturn() }
}
一个例子（客户端）
#include "atmi.h" /* TUXEDO Header File */ main(int argc, char *argv[]) { char *buf ; long sendlen, rcvlen; int ret; if (tpinit((TPINIT *) NULL) == -1) { (void) fprintf(stderr, "Tpinit failed\n"); exit(1); } sendlen = strlen(argv[1]); if((buf = (char *) tpalloc("STRING", NULL, sendlen+1)) == NULL) { (void) fprintf(stderr,"Error allocating send buffer\n"); tpterm(); exit(1); } (void) strcpy(buf, argv[1]); ret = tpcall(”TOUPPER", (char *) buf, 0, (char **)&buf, &rcvlen, (long)0); if(ret == -1) { (void) fprintf(stderr, "Can't send request to service TOUPPER\n"); (void) fprintf(stderr, "Tperrno = %d\n", tperrno); tpfree(buf); tpterm(); exit(1); } (void) fprintf(stdout, "Returned string is: %s\n",buf); tpfree(buf); tpterm(); }
为了更好的了解客户端的所有任务以编写客户 端应用，有必要重新认识客户端在C/S模式中扮演 的角色。 – 首先，客户端是用户界面。当用户在系统上 用程序进行一次操作的整个过程就是一个客 户端过程。前端过程是对客户端的另一个描 述。客户端的首要任务就是获得执行操作应 该得到的数据。 – 一旦客户端得到了应有的信息，应该将数据 按服务能够识别并适合传输的格式打包。 – 然后，向服务端发送请求并等待回应。 – 收到回应数据后，将其按一定格式展现给终 端用户。
Tuxedo速成培训
@Copy Right 2004-2007,Shanghai Baosight Software Co.,Ltd. The document is created and modified by Baosight, All rights reserved by Baosight.
使用类型缓冲区
• 在Tuxedo系统中的所有通信过程都是通过类型缓 冲区来完成的，Tuxedo系统提供了大量的类型缓 冲区来供开发者使用。所有类型缓冲区都必须通 过Tuxedo的tpalloc(), tprealloc(), tpfree() 这些ATMI来分配回收。 • 统一定义的类型缓冲区可以使它们在跨越不同网 络、不同协议、不同CPU构架以及不同操作系统之 间得到统一的处理，这就使得开发者在分布式计 算环境中有效地避开了异构网络和异构计算机系 统带来的差异，把精力集中在商业逻辑的开发上。
数据缓冲管理
ATMI提供函数分配（tpalloc(),tprealloc()）、释 放（tpfree()）TUXEDO数据缓冲。应用负责将应用 数据填入缓冲。应用的数据类型和组织决定应该选择 何种数据缓冲。函数type()可以返回正在使用的数据 缓冲类型。 以下是TUXEDO基本的数据缓冲类型： • STRING 以空值结尾的单域字符数据。 • CARRAY 有长度定义的单域二进制数据， 不进行编、解码。使BBL了解BB中已经存在 请求 • VIEW 类似C的结构多域组织 • FML 无固定结构的自定义缓冲