TongTech®TongLINK/Q8.1系统开发手册-JMS编程参考2011年7月TongLINK/QV8.1系统开发手册_JMS编程参考北京东方通科技股份有限公司地址:北京市海淀区彩和坊路10号1+1大厦2、3层客户服务热线:400-650-7088Email:版权声明版权©2006-2016东方通科技版权所有。版权保护说明未经东方通科技公司书面许可,本文档不得整体或部分地复印、复制、翻译或缩减成任何电子介质或计算机可以阅读的格式。本文档中的信息可能不加通知进行修改。商标©2006-2016东方通科技版权所有。、TongTech、TongLINK、TongLINK/Q、TongIntegrator、TongSEC、TongWeb、TongEASY、TongWorkflow是东方通科技的注册商标。其他所有的公司和产品名称可能为第三方所有。前言本手册主要介绍TongLINK/QJMS应用体系结构、JAVA目录说明、使用TLQJMS程序的步骤、TLQJMS程序配置说明、TLQJMS环境设置、编写TLQJMS程序、编写发布订阅应用、JMS消息、JMS中的加密&压缩、JMS的接口、使用基于TLQJMS的MDB及常见问题等进行说明。通过阅读此手册能快速了解JMS相关应用编写及用法等。1.阅读对象本手册面向消息中间件TongLINKQ8.1产品用户以及对消息中间件感兴趣的读者。2.手册约定本手册遵循以下约定:手册中所有的队列控制单元简称为QCU。手册中所有的消息中间件TongLINK/Q8.1简称为TLQ。TLQ缺省安装路径TongLINK/Q-Root。此手册适用于UNIX&Windows。下面相关技术文档中的蓝色字体,表示当前阅读文档。3.相关技术文档《TongLINKQ8.1快速使用手册》主要介绍产品简介、基本概念、产品安装、发送节点和接收节点的配置、节点启动停止、程序流程、程序运行及错误号的跟踪与查找等。《TongLINKQ8.1系统安装手册_服务端安装》主要介绍系统安装的环境、系统安装过程、系统有关环境变量配置、系统的启动、License相关说明、系统的停止及系统日志说明等。《TongLINKQ8.1系统安装手册_管理控制台安装》主要介绍TLQ管理控制台安装的环境、安装过程、有关环境变量设置、TLQ控制台服务器的启动及TLQ管理控制台的登录等。《TongLINKQ8.1系统概述》主要介绍消息中间件产品的系统功能及特点、系统结构架构、基本概念、队列控制单元、消息管理、发布订阅、集群、网络传输、SSL安全传输、安全出口、事务、事件管理、应用程序管理、系统管理、目录管理等。《TongLINKQ8.1系统开发手册_程序设计指南》主要介绍有关应用程序设计概述、消息介绍、技术及队列准备、消息描述及消息操作选项设计、消息体数据用户自定义属性设计、连接上下文参数设计、应用程序编写、消息操作相关程序编译、配置文件的编辑约束、配置相关数据结构、配置文件动/静态配置、配置文件相关编程和编译、使用Java进行配置文件的编辑等。《TongLINKQ8.1系统开发手册_安全出口编写指南》主要介绍安全出口概述、配置、编写及编程模式等。《TongLINKQ8.1系统开发手册_C编程参考》主要介绍C接口有关的应用编写中用到的相关宏、数据结构及函数定义等。《TongLINKQ8.1系统管理手册_管理控制台》主要介绍管理控制台使用说明、用户管理、组管理及节点管理等。《TongLINKQ8.1系统管理手册_配置管理》主要介绍有关系统运行、参数配置、参数配置项约束、参数配置举例、系统日志等。《TongLINKQ8.1系统管理手册_系统工具》主要介绍系统监视工具tlqstat、系统对象控制工具、错误信息查看工具、资源占用计算工具tlqdispshm、IPC资源查询工具tlqipc、检查系统是否启动工具tlqready、配置文件转换工具tlqconvert及设置SSL的p12证书密码工具tlqcertpwd等。《TongLINKQ8.1客户端使用手册》主要介绍客户端的基本概念、客户端UNIX和Windows的安装、系统目录结构、参数配置、代理操作、通讯安全及系统日志等。《TongLINKQ8.1系统常见问题排除手册》主要介绍系统启动常见问题、应用程序的常见问题及管理控制台的常见问题等。《TongLINKQ8.1系统性能调优手册》主要介绍服务端系统性能调优和客户端性能调优等方面说明。《TongLINKQ8.1系统开发手册_JMS编程参考》主要介绍TongLINK/QJMS应用体系结构、JAVA目录说明、使用TLQJMS程序的步骤、TLQJMS程序配置说明、TLQJMS环境设置、编写TLQJMS程序、编写发布订阅应用、JMS消息、JMS中的加密&压缩、JMS的接口、使用基于TLQJMS的MDB及常见问题等进行说明。《TongLINKQ8.1系统开发手册_客户端集群编程参考》主要介绍客户端集群简介、客户端集群相关参数配置、C客户端集群接口相关内容及JMS客户端集群接口相关内容等信息。4.对此版本新增和更改的内容TLQ8.1版本在TLQ8.0版本基础上增加和变化的内容如下:第6章编写TLQJMS程序新增HTTP协议小节,具体请见下面的HTTP协议小节。第10章新增文件消息收发进度百分比等相关信息,具体请参见下面的文件消息收发进度百分比章节。5.友情提示JMS不支持带Selector的临时队列和临时topic。客户端模式的JMS支持发布订阅功能。目录第1章TONGLINK/QJMS应用体系结构..................................................................................................11.1Factory、Destination都来自JNDI服务器.......................................................................................11.2仅Factory来自JNDI服务器............................................................................................................21.3Factory、Destination都不是来自JNDI服务器...............................................................................31.4JMS与TLQ节点的部署关系..........................................................................................................3第2章JAVA目录说明...................................................................................................................................42.1Java目录下的目录.............................................................................................................................42.2Java目录下的目录及文件说明.........................................................................................................4第3章使用TLQJMS程序的步骤...............................................................................................................63.1使用JMS程序...................................................................................................................................63.1.1Windows...................................................................................................................................63.1.2Unix..........................................................................................................................................63.2在应用服务器中使用JMS程序........................................................................................................63.2.1在Windows环境下.................................................................................................................63.2.2在Unix环境下.........................................................................................................................6第4章TLQJMS程序配置说明....................................................................................................................74.1参数配置.............................................................................................................................................74.1.1tong-log.xml配置文件.............................................................................................................74.1.1.1tong-log.xml参数配置文件格式................................................................................74.1.1.2tong-log.xml参数配置说明........................................................................................84.1.2tlqjndi.conf配置文件.................................................................