TUXEDO+JOLT配置与编程简介.doc

JOLT的配置与编程简介开发建立一个 JOLT 客户端访问 BEA Tuxedo 的应用服务的主要的步骤，可以描述以下的过程（参见下图）1、 确认已经安装 BEA Jolt 系统2、 首先要建立或已经存在一个BEA Tuxedo 系统的一个应用服务3、 利用Bulk Loader（批量装载） 工具装载 BEA Tuxedo 应用服务到 Jolt Repository Database1） 使用 Bulk Loader：jbld 是一个java 程序，在运行 jbld 命令以前检查环境变量 CLASSPATH 是否指定了 jolt 类的路径（jolt.jar、joltadmin.jar），如果没有指定这个环境变量，java 虚拟机不能够定位到任何的 jolt classes* 激活Bulk Loader：在提示符下输入以下命令（带上正确的选择项）：java bea.jolt.admin.jbld -n -p package -u usrname -r usrrole /host:port filename选 择 项描 述-u username指定用户名（默认为你的帐户名称，如果安全要求强制）-r usrrole指定用户的角色（默认为：admin，如果安全要求强制）-n 使输入文件依靠当前的接口服务库有效；不使接口服务库变动更新。（可选）-p package接口服务库包的名字（默认为：BULKPKG）/host：port指定 JRLY 或者 JSL 的地址（主机名字和IP的端口）（必须的）Filename指定包含定义服务的文件名。（必须的）*批量装载文件 the Bulk Loader File Bulk Loader File 是一个定义服务和关联参数文本文件，Bulk Loader装载定义在the Bulk Loader File（批量装载文件）中的服务到 jolt 接口服务库中（默认的包是：BULKPKG）。 2) Bulk Loader File 的语法 每一个服务定义是由服务属性和参数组成的：属性和参数都有一个要设置的数字，每一个属性描绘都通过一个关键字和一个值 关键字分为两层： Service_level (服务层) Parameter_level (参数层)* 关键字的指导方针* jbld 程序读取服务定义文本文件，关键字的用法遵守下表的指导方针： 指 导 方 针举 例每个关键字都必须跟随一个等号（）和一个值正确： type=string错误： type每一行只允许有一个关键字正确： type=string错误： type=string access=out任何一行都不能忽略等号（）正确： type=string错误： type string确定的关键字只接受一个合理设置的值访问关键字只支持以下这些值：in，out，inout，noaccess装载导入文件能够包含多服务定义service=INQUIRYservice=DEPOSITservice=WITHGRAWLservice=TRANSFER每一个服务定义都由多个关键字和值组成service=DEPOSITexport=trueinbuf=VIEW32outbuf=VIEW32inview=INVIEWoutview=OUTVIEW 在 Bulk Loader 文本文件中关键字的顺序 一个服务定义必须以 service= 开始，服务如果是采用 CARRAY 或者是 STRING 类型的 BUFFER，在服务中只有一个参数。在服务中使用的是一个CARRAY类型的BUFFER则推荐参数使用CARRAY数据类型；在服务中使用的是一个STRING类型的BUFFER则推荐参数使用STRING数据类型。 下表是包含使用服务层关键字和每一个可接受的值的指导方针 * 服务层的关键字和值的用法关 键 字值service任何 BEA Tuxedo 服务名字exporttrue 或 false (默认值为：false)Inbuf / outbuf选择下列这些 BUFFER 类型中的一种FML FML32 VIEWVIEW32 STRING CARRAYX_OCTET X_COMMON X_C_TYPEinview任何输入参数的view 名字这个参数是可选的，只有在下列一种BUFFER类型被用到时：VIEW、VIEW32、X_COMMON、X_C_TYPEoutview任何输出参数的 view 名字* 参数层关键字和值的用法一个参数是从 param=，当遇到另一个参数 param 或是另一个服务 service就结束了。参数关键字是可以任何顺序的。下表是包含使用参数层关键字和每一个可接受的值的指导方针关 键 字值param任何参数名typebyteshortintegerfloatdoublestringcarrayaccessinoutinoutnoaccesscount出现的最大数值（默认值是1），当这个值无限时为0，仅用在Repository Editor 格式化测试屏幕 3）疑难问题的解决如果你使用 Bulk Loader 批量装载工具时遇到了一些问题，参阅下表：一个完整的Bulk Loader 批量装载工具错误消息和解决方案If 。 。Then 。 。数据文件没有找到检查并确认路径是否正确关键字无效检查并确认关键字对于 package、service、parameter关键字的值是空为关键字赋值值无效检查并确认参数分配的值在参数范围之内数据类型无效检查并确认参数使用的类型是否有效Bulk Load data 的例子：下列列表包含一个例子数据文件，这个例子装载 TRANSFER、LOGIN、PAYROLL服务到默认的 BULKPKG 包。批量装载数据样本：service=TRANSFERexport=trueinbuf=FMLoutbuf=FMLparam=ACCOUNT_IDtype=integeraccess=incount=2param=SAMOUNTtype=stringaccess=inparam=SBALANCEtype=stringaccess=outcount=2param=STATLINtype=stringaccess=outservice=LOGINinbuf=VIEWinview=LOGINSoutview=LOGINRexport=trueparam=usertype=stringaccess=inparam=passwdtype=stringaccess=inparam=tokentype=integeraccess=outservice=PAYROLLinbuf=FMLoutbuf=FMLparam=EMPLOYEE_NUMtype=integeraccess=inparam=SALARYtype=floataccess=inoutparam=HIRE_DATEtype=stringaccess=inout4、 使用 Jolt Repository Editor 编辑器定义和配置应用服务1) Repository Editor Repository Editor 是一个有效地可下载的 JAVA Applet 应用程序，Jolt Repository 主要是用于 Jolt 翻译 JAVA 参数到一个 BEA Tuxedo BUFFER 类型中；当一个 BEA Tuxedo 服务加载到 Repository，而且必须要 Export，这样 Jolt Server 才能确保客户端请求从 Jolt Client能够完成。 2) Repository Editor 窗口 3) Repository Editor 窗口描述窗口各部分功 能1、文本编辑诓输入文本、数字、或者是文字数字的字符，例如：“Service Name”，“Input View Name”，server name，或者是 port number，在上图中的“Service Name”2、下拉框列表显示列表使用一个下拉框列表，在上图中的：“Input Buffer Type”或者是“Output Buffer Type”3、显示列表从一个列表中选择预定义项，例如：参数列表，4、命令按钮激活一个操作，例如：显示一个包的窗口；服务窗口；或者是包的组织，在上图中包括：“Save Service”、“Test”、“Back”、“New”、“Edit”、“Delete”5、单选按钮只选中一个选项，一次只能存在一种状态，例如： Export Status只能是“Unexport”或者是“Export”。 4）启动Repository Editor 在启动Repository Editor前，确认已经安装了所要求的最小化，Jolt Server 和 Jolt Client，可以用 JavaSoft 的 appletviewer 或者是用你的浏览器中任何一种方式都可以启动Repository Editor。* 用 Java appletviewer 启动Repository Editor 设置 Jolt Class 的CLASSPATH的环境变量。从本地启动Repository Editor appletviewer /RE.html 从WEB服务器远程启动Repository Editor appletviewer http:/RE.html* 用浏览器启动Repository Editor 从本地启动的RE页面设置 Jolt Class 的CLASSPATH的环境变量。file:/RE.html 从WEB Server 启动Repository Editor 确保 CLASSPATH 不包括 Jolt Class 的路径 不设置 CLASSPATHhttp:/RE.html注意：在打开这个文件之前，修改在 RM.html的applet codebase parameter 匹配你的Jolt Class 的路径 * 登录到Repository Editor 完成上述启动步骤后，就会显示下图： 在SERVER中输入主机的机器名或是主机的IP，然后在 PortNumber中输入主机启用的通信端口号 注意：除非你登录通过 Jolt Relay，相同的端口号通常用于配置 Jolt Listener，查阅UBBCONFIG 文件的附加信息 输入BEA Tuxedo应用的口令 在依赖认证的等级上，完成以下两步： 输入BEA Tuxedo的User Name 和 User Password，然后 Packages、Services、Log Off 按钮就可以激活。 注意：查看JoltSessionClass的附加信息 * Repository Editor 登录窗口的描述 选 项描 述Server服务器名字或者是服务器的IPPort Number一个十进制的端口数值User RoleBEA Tuxedo的用户角色，至少要求 BEA Tuxedo认证等级是 USER_AUTH 或者是更高。Application PasswordBEA Tuxedo 超级管理员的口令User NameBEA Tuxedo用户标识，第一个字符必须是一个alpha字符User PasswordBEA Tuxedo 的口令Packages访问Packages的窗口Services访问Services的窗口Log Off中断与服务器的连接5、 用 Jolt Class Library 建立一个客户端应用在典型的需要web enble的3层OLTP系统中，基于Bea中间件的解决方案是：Browser WebLogicServer Tuxedo RDBMS, 整个流程图如下:Web Browse(Http)ServletJSPJDBCEJBBEA WebLogic ServerJOLTTUX APPBEA TUXEDOTUX APPRDBMSJolt Protocl流程说明:Browser发送Post Form数据到Weblogic中,Servlet接受Post 数据,通过JNDI去查找SessionPoolManager名,并传递服务,此时WebServer的SessionPool通过Jolt Protocl与Bea Tuxedo服务连接并通讯,BeaTuxedo 服务接受来之Webserver的请求,并处理后返回,WebServer接受结果返回到WebBrowse显示. 根据此流程创建一个完整程序的流程如下：在这个流程中BEA Jolt是Java程序与Tuxedo APP（C程序）之间连接通讯的桥梁。所有的Tuxedo APP对C客户端而言，只要服务START，C客户端即可调用。但是对通过Jolt协议访问的Java客户端，必须在Jolt Repository(Jolt资源库)中注册，并导出（Export），Jolt Client才可以调用该服务，否则将提示：Service not available. 在这个流程中，他们之间的关系如下图所示：Jlot Client其中Repository Editor是BEA提供的一个GUI界面，用于增加和删除提供给Jolt Client 的TUXEDO Service。其全称为Jolt Repository Editor. 运行%Jolt_home%/udataobj/jolt/re.html可进入该界面。在此Editor中用户可增加删除Jolt Repository 中的Service，但只有标志为Export的Service才能被Jolt Client调用。注意：在安装Jolt时，其安装目录必须选在Tuxedo安装目录下,（如D:beatuxedo）,否则即使进入了Editor界面，但无法打开Service编辑窗口。更具体信息请参照Tuxedo Jolt 帮助文档。Jolt Client:Jolt Client 可以是纯Java程序，也可以是Browser 通过Servlet调用Tuxedo Service。无论那种方式，如果调用Tuxedo Service