TongLINKQ 6.0 for JAVA 使用手册

合集下载

TongLINKQ8.0系统常见问题排除手册

版权保护说明未经东方通科技公司书面许可，本文档不得整体或部分地复印、复制、翻译或缩减成任何电子介质或计算机可以阅读的格式。

本文档中的信息可能不加通知进行修改。

TongTech、TongLINK/Q、TongEASY、TongWeb、TongIntegrator、TongSEC、TongWorkflow、TongGTP、MBP是东方通科技的注册商标。

其他所有的公司和产品名称可能为第三方所有。

前言本文档主要介绍系统启动常见问题、应用程序的常见问题及管理控制台的常见问题等进行分类说明。

1. 阅读对象本手册面向消息中间件TongLINKQ8.0产品用户以及对消息中间件感兴趣的读者。

2.手册约定本手册遵循以下约定：z手册中所有的队列控制单元简称为QCU。

z手册中所有的消息中间件TongLINK/Q8.0简称为TLQ。

z此手册适用于Windows。

z下面相关技术文档中的蓝色字体，表示当前阅读文档。

3.相关技术文档z《TongLINKQ8.0快速使用手册》主要介绍产品简介、基本概念、产品安装、发送节点和接收节点的配置、节点启动停止、程序流程、程序运行及错误号的跟踪与查找等。

z《TongLINKQ8.0系统安装手册_管理控制台安装》主要介绍TLQ管理控制台安装的环境、安装过程、有关环境变量设置、TLQ控制台服务器的启动及TLQ管理控制台的登录等。

z《TongLINKQ8.0系统安装手册_服务端安装》主要介绍系统安装的环境、系统安装过程、系统有关环境变量配置、系统的启动、License 相关说明、系统的停止及系统日志说明等。

TongLINKQ8.1系统开发手册_安全出口编写指南

TrigType 类型新增一种类型 OnDirect(D)，具体请参见下面详细说明。
5) 第 2 章[JndiBroker]的参数说明小节中新增一个参数 IP，请参见下面的[JndiBroker]小节说明。 6) 第 2 章 [JmsBroker]的参数说明小节中新增七个参数 JmsBrokerID 、 IP 、 ConnAssignPolicy、
5. 友情提示
发布订阅功能仅限于单层星型结构使用，多级的发布订阅暂不推荐使用!! 接收端连接使用 SSL 的时候，必须使用同步 socket 通信方式（即：接收方 ssl 连接不支持异
步 socket 通信方式），且不支持 IPV6 协议类型。
目
1.1
录
第 1 章 TONGLINK/Q 的运行 ....................................................................................................................... 1 系统运行准备 .............................................................................................................................. 1 1.1.1 设置环境变量 ...................................................................................................................... 1 UNIX ............................................................................................................................ 1 Windows ....................................................................................................................... 2

TongLINKQ8.0系统性能调优手册

版权保护说明
未经东方通科技公司书面许可，本文档不得整体或部分地复印、复制、翻译或缩减成任何电子介质或计算机可以阅读的格式。本文档中的信息可能不加通知进行修改。
商标
©1993-2011 东方通科技版权所有。TongTech、TongLINK/Q、TongEASY、TongWeb、 TongIntegrator、TongSEC、TongWorkflow、TongGTP、MBP 是东方通科技的注册商标。其他所有的务端系统性能调优和客户端性能调优等方面说明。通过阅读此手册能有效地提高工作效率。
1. 阅读对象
本手册面向消息中间件TongLINKQ8.0产品用户以及对消息中间件感兴趣的读者。
2. 手册约定
本手册遵循以下约定： z 手册中所有的队列控制单元简称为QCU。 z 手册中所有的消息中间件TongLINK/Q8.0简称为TLQ。 z 此手册适用于UNIX &Windows。 z 下面相关技术文档中的蓝色字体，表示当前阅读文档。
3. 相关技术文档
z 《TongLINKQ8.0快速使用手册》主要介绍产品简介、基本概念、产品安装、发送节点和接收节点的配置、节点启动停止、程序流程、程序运行及错误号的跟踪与查找等。 z 《TongLINKQ8.0系统安装手册_管理控制台安装》
主要介绍TLQ管理控制台安装的环境、安装过程、有关环境变量设置、TLQ控制台服务器的启动及TLQ管理控制台的登录等。
z 《TongLINKQ6.3代理使用手册》
主要介绍TLQ63代理的概述、系统架构、相关系统安装、参数配置、配置举例、相关环境变量、启动配置及相关日志等方面说明。
z 《TongLINKQ8.0系统开发手册_客户端集群编程参考》
主要介绍客户端集群简介、客户端集群相关参数配置、应用编写中用到的数据结构、客户端集群 C 接口介绍及客户端集群 DEMO 等。

TongWeb6 0 Eclipse插件使用手册

T o n g T ec h®TongWeb6.0 Eclipse插件使用说明东方通科技目录目录 (2)1.TongWeb6.0 Eclipse插件简介 (4)2.Eclipse插件功能概述 (4)2.1. Eclipse插件基本功能 (4)2.2. 简化应用开发功能 (4)2.3. 创建数据源 (4)2.4. 全局设置 (4)3.TongWeb6.0 Eclipse插件的安装 (5)3.1.安装WTP插件 (5)3.1.1.从Eclipse官网下载 (5)3.1.2.在Eclipse官网进行更新 (5)3.2.安装TongWeb6.0 Eclipse插件 (7)3.3.卸载TongWeb6.0 Eclipse插件 (7)4.TongWeb6.0 Eclipse插件的使用 (7)4.1.在Eclipse中打开或关闭TongWeb6.0 (7)4.1.1.在“Servers”视图中添加TongWeb6.0应用服务器 (7)4.1.2.启动或停止“TongWeb6.0应用服务器” (12)4.1.3.编辑“TongWeb6.0应用服务器” (14)4.2.使用“TongWeb6.0 Eclipse插件”开发工程 (14)4.2.1.创建并编写“企业级应用”工程 (14)4.2.2.创建数据源 (18)4.2.3.创建EJB2.x Session Bean (20)4.2.4.创建JP A工程 (28)4.2.5.开发WebService (34)4.3.部署工程 (44)4.3.1.打包后通过管理控制台或命令行部署 (44)4.3.2.直接将工程部署到TongWeb6.0应用服务器 (44)4.4.在Eclipse中浏览页面 (46)4.5.使用Debug功能 (46)4.6.解部署工程 (47)5.其他选项功能 (47)5.1. 查看应用服务器的基本信息及配置 (47)5.1.1. 基本信息（General Information） (48)5.1.2. 关于部署的配置（Publishing） (48)5.1.3. 超时时间设置（Timeouts） (48)5.2. 手动重部署应用（Publish） (48)5.3. 清理垃圾文件（Clean） (49)5.4. 部署与解部署项目（Add and Remove Projects） (49)5.5. TCP/IP监听功能（Monitoring） (49)5.6. 在Eclipse中查看管理控制台 (51)5.7. 查看应用服务器的属性（Properties） (51)6.全局设置 (51)6.1. Eclipse日志配置 (52)6.2. 详细显示TongWeb6.0的日志信息 (52)6.3. 以多种颜色显示TongWeb6.0的日志信息视图 (52)7.图形化功能 (53)1.TongWeb6.0 Eclipse插件简介Eclipse是一个开放的Java集成开发环境，通过一系列插件的支持可以方便的进行EJB、JSP/Servlet的开发。

（整理）TongLinkQ常见问题处理指南

（整理）TongLinkQ常见问题处理指南TongLINK/Q常见问题处理指南北京东⽅通科技⽀持服务中⼼⽬录1.引⾔ (3)2.故障处理前期准备 (3)3.故障处理流程 (4)3.1.故障处理流程 (4)3.2.节点运⾏诊断流程 (4)3.2.1.操作系统核⼼参数 (5)3.2.2.TongLINK/Q环境变量 (5)3.2.3.查看TongLINK/Q配置⽂件 (6)3.2.4.查看系统资源和进程 (7)3.2.5.查看TongLINK.sys⽂件 (8)3.3.⽹络连接诊断流程 (9)3.3.1.⽹络层连通性诊断 (9)3.3.2.使⽤TongLINK/Q命令检测节点间的连通性 (10)3.4.检查队列中的消息 (11)3.4.1.检查错误⽇志TongLink.sys (12)4.【附录】 (13)4.1.常⽤系统命令 (13)4.2.核⼼参数 (13)4.3.SETP⽂件D EMO (14)1.引⾔TongLINK/Q的常见故障主要出现在基于TongLINK/Q架构的应⽤系统运⾏时。

此⽂档将重点描述如何判断和处理TongLINK/Q 常见的故障问题。

2.故障处理前期准备在进⾏故障处理之前，必须先了解TongLINK/Q运⾏环境的相关信息，具体的信息需求如表格所⽰：图2.1 故障处理需求表注：1、表格中红⾊字体选项是东⽅通科技公司⽀持服务中⼼⼈员进⾏故障处理时必须了解的信息；2、“TongLINK/Q架构模式”包括多节点、转发、集群、订阅/发布、JMS等；3.故障处理流程3.1. 故障处理流程TongLINK/Q故障处理顺序如下：查看节点运⾏情况、查看⽹络运⾏状况、判断队列中消息运⾏情况、查看应⽤⽇志判断故障等；具体的总流程如下：图3.0 故障处理总流程3.2. 节点运⾏诊断流程在处理TongLINK/Q可能出现的问题时，⾸先需要要确保客户⽅和服务⽅的TongLINK/Q正常运⾏，⽹络连接正常，并且机器资源够⽤。

TongLinkQ使用

TongLinkQ使用TongLinkQ使用一、TongLinkQ安装在Windows中的安装过程执行默认安装即可，在安装过程中安装程序会自动设置环境变量，安装完毕后提示重新启动。

注意：系统重启后安装过程中设置的环境变量才会生效。

Windows下安装过程中设置的环境变量在CLASSPATH环境变量中添加以下内容（Java程序使用） C:\\ProgramFiles\\Tongtech\\TLQ72\\java\\lib\\tlclient.jar;C:\\Program Files\\Tongtech\\TLQ72\\java\\lib\\TLQRemoteApi.jar;C:\\Program Files\\Tongtech\\TLQ72\\java\\conf;C:\\Program Files\\Tongtech\\TLQ72\\java\\lib\\javaee.jar; C:\\ProgramFiles\\Tongtech\\TLQ72\\java\\lib\\TongJMS.jar;在Path环境变量中添加以下内容（TLQ的命令和测试程序路径） C:\\ProgramFiles\\Tongtech\\TLQ72\\bin;C:\\Program Files\\Tongtech\\TLQ72\\samples\\bin;新添加的环境变量TLQCONFDIR = C:\\Program Files\\Tongtech\\TLQ72\\etc （配置文件的保存目录）TLQHOMEDIR = C:\\Program Files\\Tongtech\\TLQ72 （TLQ的家目录）TLQLICENSEDIR = C:\\Program Files\\Tongtech\\TLQ72 （TLQ的License保存目录）TLQLOGDIR = C:\\Program Files\\Tongtech\\TLQ72\\log （日志文件的保存目录）TLQMSGDIR = C:\\Program Files\\Tongtech\\TLQ72\\msgTLQRCVFILESDIR = C:\\Program Files\\Tongtech\\TLQ72\\rcvfiles （接收文件的目录） TLQSNDFILESDIR = C:\\Program Files\\Tongtech\\TLQ72\\sndfiles （发送文件的目录）二、TLQ的几个基本概念 1．TLQ节点安装TLQ服务器端软件的一台主机。

JMS for TongLINKQ6.3安全和使用手册

TongTech®JMS for TongLINK/Q6.3 管理与开发手册适用于UNIX & Windows北京东方通科技公司目录第1章 JMS 概述 (1)1.1 JMS技术简介 (1)1.2 JMS的相关概念 (2)1.2.1 JMS队列 (2)1.2.2 TLQ队列 (2)1.2.3 JMS 队列与TLQ队列 (2)1.2.4 JMS队列限制 (2)1.3 Java消息服务 (3)1.3.1 JMS和其他企业级Java API的关系 (3)1.3.2 JMS点到点的消息模型 (4)1.3.3 JMS发布与订阅模型 (4)1.3.4 QueueConnectionFactory (5)1.3.5 TopicConnectionFactory (5)1.3.6 JMS 消息对象 (6)1.3.6.1 消息头(Message Header) (6)1.3.6.2 属性（Properities） (6)1.3.6.3 消息体(Body) (6)1.3.7 JMS消息查询 (7)1.3.8 XA-JMS分布式事务 (8)1.3.8.1 概述 (8)1.3.8.2 XA的支持 (8)1.3.9特别说明 (8)1.3.10J MS1.1支持说明 (8)1.4命名及目录服务JNDI (9)1.4.1命名服务(naming service) (9)1.4.2目录服务(directory service) (9)1.4.3 JNDI (9)1.4.4 JNDI概述 (9)1.4.5 JNDI结构 (10)1.4.6 JNDI在应用服务器中的使用 (10)1.5TongLINK/Q - JMS 体系结构 (11)第2章客户端代理参数配置 (12)2.1 2.1TongCliBroker.Conf配置文件格式 (12)2.2系统参数配置 (13)2.2.1系统参数配置格式 (13)2.2.2参数配置说明 (13)2.3 JMS队列定义 (14)2.3.1 JMS队列定义格式 (14)2.3.2队列定义说明 (14)2.4 JMS主题 (15)2.4.1 JMS主题格式 (15)2.4.2主题说明 (15)2.4.3特别说明 (15)第3章客户端代理应用 (16)3.1客户端代理的结构模型 (16)3.2 TongLINK/Q_JMS客户通信 (17)3.2.1集中通信 (17)3.2.2集中通信参数配置举例 (18)3.2.3跨节点通信 (19)3.2.4跨节点通信参数配置举例 (20)3.2.5配置说明 (22)3.3客户端代理的作用 (22)第4章客户端代理系统日志 (23)4.1错误日志（TongCliBroker.sys）主要有： (23)4.2运行日志（TongCliBroker.log）主要有： (24)第5章 JMS应用开发 (25)5.1 TongLINK/Q_JMS的环境设置 (25)5.2 TongLINK/Q_JMS设置不同类型的连接 (26)5.3TongLINK/Q Jmsclient ConnectionFactory 构造器 (27)5.3.1通过指定主机名和端口构造ConnectionFactory (27)5.3.2利用tlkq协议名串构造ConnectionFactory (27)5.4 JNDI配置 (28)5.4.1 TongJndi.Conf配置文件 (28)5.4.1.1 TongJndi.Conf参数配置文件格式 (28)5.4.1.2 TongJndi.Conf参数配置说明 (28)5.4.1.3 特别说明 (28)5.4.2 5.4.2 JMSAdmin.config配置文件 (29)5.4.2.1 5.4.2.1 JMSAdmin.config参数配置文件格式 (29)5.4.2.2 5.4.2.2 JMSAdmin.config配置文件说明 (29)5.4.2.3 5.4.2.3 JMSAdmin的启动 (30)5.4.2.4 5.4.2.4 JMSAdmin.config配置文件举例 (30)5.4.3 JNDI对象 (31)5.4.4子上下文的定义 (31)5.4.5配置JNDI对象 (32)5.4.6注意事项 (32)5.5 JNDI应用 (33)5.5.1标准JNDI属性文件 (33)5.5.2自定义JNDI属性文件 (34)5.5.2.1 JNDI属性文件说明 (35)5.5.2.2 装入JNDI属性文件的两种方法 (35)5.5.3指定 JNDI服务器 (35)5.5.4 JNDI查询 (36)5.5.5 JNDI Service名称体系结构 (37)5.6 JMS编程 (38)5.6.1 JMS API (38)5.6.2开发JMS的步骤 (38)5.6.3 JMS中使用Session注意事项 (38)5.6.4 JMS自定义属性 (39)5.6.5 JMS客户端程序 (39)5.6.5.1 JMS的发送/接收消息程序 (39)5.6.5.2 JMS的发布/订阅消息程序 (42)第6章 JMS应用程序的编写 (44)6.1消息发送 (44)6.1.1普通方式发送程序流程 (44)6.1.2 JMS发送程序举例 (45)6.2消息接收 (46)6.2.1 JNDI方式接收程序流程 (46)6.2.2特别说明 (47)6.2.3 JMS接收程序举例 (48)6.3消息发送事务 (49)6.3.1 JMS发送方事务流程 (49)6.3.2 JMS发送方事务程序举例 (50)6.4消息接收事务 (52)6.4.1 JMS接收方事务流程 (52)6.4.2特别说明 (52)6.4.3 JMS接收方事务程序举例 (53)6.5消息相关性 (54)6.5.1 JMS相关性流程 (54)6.5.2 JMS相关性程序举例 (55)第7章 MDB (57)7.1 MDB简介 (57)7.2 MDB特征 (57)7.3 MDB的实现 (57)7.4 MDB的生命周期 (58)7.5 MDB示例 (59)7.6 MDB的部署描述符 (59)7.7 MDB集成到应用程序中 (60)第8章在Weblogic上的应用 (61)8.1修改Weblogic的启动脚本 (61)8.2启动TongLINK/Q (63)8.3启动JmsAdmin (64)8.3.1配置ConnectionFactory的JNDI名 (64)8.3.2配置XAConnectionFactory的JNDI名 (65)8.3.3配置queue的JNDI名 (65)8.3.4查看配置的JNDI (66)8.4启动Weblogic (67)8.4.1配置Foreign JMSServer (67)8.4.2配置Foreign JMSConnection Factories (69)8.4.3配置Foreign JMSDestinations (70)8.5查看JNDI树 (71)8.6编写MDB (73)8.6.1编写不需要交易支持的MDB (73)8.6.2编写需要交易支持的MDB (75)8.7部署MDB (77)8.7.1 Jbuilder部署MDB (77)8.7.2 Weblogic控制台部署MDB (78)8.8测试MDB (82)8.9在WebLogic上开发MDB示例 (85)第1章JMS 概述1.1 JMS技术简介JMS本身不是一个通信软件，而是一个标准的应用编程接口（API），用来建立厂商中立的异步通信机制。

消息中间件TongLINKQ

消息中间件TongLINK/Q概述TongLINK/Q作为东方通科技公司的消息中间件产品，其先进的队列、消息处理机制，为应用系统提供了高效、灵活的同步和异步传输处理、存储转发、可靠传输等技术支持，确保消息在任何情况下都能够安全、可靠的送达。

TongLINK/Q提供点对点、发布订阅、路由、集群等多种方式的消息传递模式，极大方便了企业应用的灵活构建，为不同应用模式、不同系统规模、不同消息传输量的系统提供了强有力的后台支撑。

TongLINK/Q作为一个消息传递的可靠平台，应用系统可以借助于它轻松地交换和处理消息，而无需考虑消息传递的具体细节，能够大大降低开发难度，缩短开发周期，节约开发成本。

图表1TongLINK/Q产品体系结构典型应用TongLINK/Q是一个标准化、适合中国应用环境的消息中间件，具有高效、可靠、实用等特点。

1993年诞生以来，已成功运行在金融、电信、交通、政府等行业的数百个大、中型企业级应用系统中。

中国移动通信全国冗灾备份系统是一个全国性项目。

中国移动通信将全国计费中心设在北京，同时在深圳建立备份中心，与全国32个省（市）的中国移动通信分公司进行统一计费结算，互为备份。

T ongLINK/Q为中国移动通信全国冗灾备份系统搭建了安全可靠的数据传输平台。

交通部海事局全国水上安全监督系统是一个覆盖全国20多个沿海省、市的全国性项目，旨在实现沿海船舶、船员信息、通航环境信息等主要海事信息的数字化以及船舶、船员、通航管理等主要业务处理的网络化。

TongLINK/Q为全国水上安全监督系统提供了安全高效、可靠传输的通讯平台及应用开发平台。

中国建设银行国际业务系统是一个全国性的系统，覆盖全国38个省、直辖市、计划单列市以及10个沿海城市的外汇结算业务。

中国建设银行B股资金清算系统也是一个全国性系统，由总行、38个一级分行、上百个二级分行以及200多个支行构成。

TongLINK/Q在国际业务系统、B股资金清算系统中均发挥了积极作用。

1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。

TongLINK/Q for JA V A 使用手册V6.0版北京东方通科技公司前言中间件是一个通道, 保障应用信息的可靠传递；中间件是一个桥梁, 达成商务构件的互连互通；中间件是一个框架, 促成企业应用的完整集成；中间件是一个平台, 实现分布式应用的顺利部署。

中间件以自身的复杂换取了企业应用的简捷。

它试图通过屏蔽、疏通各种复杂的基础技术细节，使企业的应用开发、部署与管理变得轻松和谐。

IT技术的发展和市场的演进，使中间件软件成为分布式应用的关键性基础设施，中间件的内涵也变得越来越丰富，种类越来越多，技术越来越复杂，应用范围越来越广阔。

中间件处于操作系统与用户的应用软件的中间。

中间件在操作系统、网络和数据库之上，应用软件的下层，其主要功能是帮助用户灵活、高效地开发和集成复杂的应用软件。

从广义上看，商务应用包括三个逻辑层次：表示层逻辑、业务逻辑和基础逻辑。

其中，基础逻辑贯穿了通讯、事件和应用管理三个方面。

换言之，中间件就是从应用中分离出来的基础逻辑的一种独立的标准形式。

东方通科技是中国目前一家重要的专业中间件产品供应商，也是国内中间件领域的开拓者和中坚力量。

我们的产品包括消息中间件ＴｏｎｇＬＩＮＫ／Ｑ、交易中间件ＴｏｎｇＬＩＮＫ／Ｑ、基于ＰＫＩ的安全中间件ＴｏｎｇＳＥＣ、面向对象以ＣＯＲＢＡ体系结构为基础的ＴｏｎｇＢｒｏｋｅｒ和符合Ｊ２ＥＥ规范的ＷＥＢ应用服务器ＴｏｎｇＷｅｂ。

本手册所描述的是消息中间件TongLINK/Q。

TongLINK/Q6.0 参考文献介绍TongLINK/Q6.0系统概述主要介绍消息中间件TongLINK/Q的系统功能、特点、组成、基本概念及基本原理。

TongLINK/Q6.0系统管理主要介绍基于Unix和Windows环境下的安装、运行及系统目录结构，并且构造和管理TongLINK/Q系统的命令，这些命令可以用于系统启动，参数配置、消息状态监控及日志的查看等。

TongLINK/Q 6.0 编程参考主要介绍TongLINK/Q6.0开发系统的组成、标准接口函数的定义、配合流程图进行应用程序的编写、参数配置举例及TongLINK/Q的编译举例。

TongLINK/Q 6.0管理工具主要介绍在Unix和Windows环境中构造和管理TongLINK/Q系统的命令，这些命令可以用于系统启动和停止，参数配置和运行监控等。

JMS管理与开发手册主要介绍JMS概述、JMS Server参数配置、JMS Server应用、JMS Server系统日志、JMS应用开发、JMS应用程序的编写、MDB及在Weblogic上的应用等。

TongLINK/Q 6.0 for JAVA 使用手册主要介绍TongLINK/Q的J A V A接口类及方法，包括应用程序编写示例。

目录第一章TonglINK/Q for JAVA的环境设置 (4)第二章类及方法说明 (5)第三章TongLINK/Q提供的类 (6)第四章TongLINK/Q类的使用说明 (8)4.1 tlqLogin 应用程序注册 (8)4.2 tlqLogout 应用程序注销 (9)4.3 tlqPutMsg 发送消息 (10)4.4 tlqGetMsg 接收消息 (11)4.5 tlqBegin 开始事务 (12)4.6 tlqCommit 提交事务 (13)4.7 tlqRollback 回滚事务 (14)4.8 tlqGetEvent 接收事件消息 (15)4.9 tlqTestLine 测试节点状态 (16)4.10 tlqGetLocalNode得到本地节点名称 (17)4.11 tlqGetErr获得系统错误信息 (18)第五章 TongLINK/Q for JAVA应用程序编写 (19)5.1消息发送 (19)5.1.1发送程序流程 (19)5.1.2一般消息发送程序举例 (20)5.2消息接收 (21)5.2.1接收程序流程 (21)5.2.2一般消息接收程序举例 (22)5.3消息发送事务 (23)5.3.1发送方事务流程 (23)5.3.2发送方事务程序举例 (24)5.4消息接收事务 (25)5.4.1接收方事务流程 (25)5.4.2接收方事务程序举例 (26)第一章TonglINK/Q for JAVA的环境设置TongLINK/Q6.0 for JAVA适用于UNIX环境和Windows环境，利用此项功能可以在TongLINK/Q 平台上使用J A V A开发客户端应用程序。

TongLINK/Q6.0 for JAVA包含在TongLINK/Q标准版的安装盘上，如果需要使用该产品需要进行如下操作：?使用J A V A接口的客户端节点需要安装TongLINK/Q6.0（UNIX或WINDOWS）标准版系统，安装方法请参考用户手册，在安装完成后，系统的安装目录下会有下面几个与JAVA API 相关的文件：Windows环境：Bin\libjtlq_adapter.dlljava\lib\tlqadapter.jarUNIX环境：lib/libjtlq_adapter.so(或libjtlq_adapter.sl等，不同OS的后缀不同)java/lib/tlqadapter.jar?设置环境变量在CLASSPATH中增加TongLINK/Q的java/lib/tlqadapter.jar设置；在Windows环境下：PATH中要有libjtlq_adapter.dll的存放目录；在UNIX环境下，要指明动态链接库的位置；LD_LIBRARY_PATH不同的OS设置动态链接库的环境变量的名称不同。

例如：DEC SCO SUN 系统为：LD_LIBRARY_PATH=LINUX　系统为：LD_LIBRARY_PATH=IBM AIX系统为：LIBPATH=HP系统为：SHLIB_PATH=?如果没有安装J A V A，需要下载并安装JDK 1.2.2（或以上版本）。

第二章类及方法说明在Java中，最重要的数据类型就是类（classes）。

利用类，可以将对象种类的特性定义，至于对象实体，则是由系统在程序执行时，不断地按对象类的定义而产生。

对于方法定义的方式和C语言中的函数，形式上基本是相同的。

在Java中，程序包的概念和其他编程语言中的函数库，目的可以说是相同的。

为了开发一个大的程序或者开发有用的程序工具，可以将写好的程序类整理成一个个程序包，将所有的相关的类都放在这个程序包里。

TongLINK/Q Java API中提供了五个类，放于package(程序包) “tlqadapter”中。

为了能够使Java调用TongLINK/Q的接口方法，将TongLINK/Q的接口函数定义为方法。

下面章节主要介绍TongLINK/Q Java API中类及方法。

第三章TongLINK/Q提供的类TongLINK/Q JAVA API中提供了五个类给用户使用：TlqgId、：TlqMsgId、TlqMsgInfo、TlqEventInfo和TlqInterface。

以下将以表格的形式对四个类的变量、方法及功能作简单的介绍。

TlqMsgId类成员变量功能int time系统当前时间short id消息唯一标识short rgsLoc进程登记表的下标。

TlqMsgInfo类常数功能int MSGNAMELEN msgname 最多容纳的ASC码字符个数int NAMELEN node节点名的最多ASC码字符个数int USRCONTEXTLEN usrcontext最多存放的byte个数int BUF_MSG数据报消息int FILE_MSG文件消息int LOG_ON可靠性int LOG_OFF非可靠性int PRIOR_LOW低优先级int PRIOR_NORMAL中优先级int PRIOR_HIGH高优先级成员变量功能int msgType消息的类型byte[]msgName消息的名称byte[] usrContext用户根据自己的需要填写发送的信息boolean removeFileFlag用户文件发送成功后是否删除int logFlag发送消息的可靠性标识boolean compressFlag压缩标识boolean cryptFlag加密标识int priorNo优先级编号byte[] destNode目标节点名byte[] rcvQName接收队列名int expiry生命周期int msgLen数据长度int reportType订阅事件的类型byte[] reportQName订阅事件的接收队列名TlqMsgId corrMsgId消息相关性的属性Int priority优先级下标Int orgMsgLen加密压缩前消息长度，由API填写byte　srcNode产生消息节点名TlqMsgId msgId消息的标识byte[] msgContent消息的内容特别说明： byte类型数组必须赋值为某个Ｓｔｒｉｎｇ．ｇｅｔＢｙｔｅｓ（）所得到byte数组值（msgContent除外）。

TlqEventInfo类成员变量功能int style事件类型标识int evTime事件产生的时间byte[] evFlag事件的唯一标识byte[] reason事件产生的原因TlqInterface类方法原型功能TlqLogin()应用程序注册TlqLogout()应用程序注销TlqBegin()开始一个事务TlqCommit()提交一个事务TlqRollback()回滚一个事务TlqPutMsg()发送消息TlqGetMsg()接收消息TlqGetEvent()接收事件消息TlqTestLine()测试节点连接状态TlqGetErr()获得系统错误信息TlqGetLocalNode()得到本地节点名称成员变量功能EVENT_M_STMOUT=0x00000001核心发送超时EVENT_M_RTMOUT= 0x00000002核心接收超时EVENT_M_BSNDFAIL = 0x00000004核心发送前失败EVENT_M_SNDFAIL = 0x00000008核心发送失败EVENT_M_KRCVFAIL = 0x00000010核心接收失败EVENT_M_RECEIVE = 0x00000040接收到一条消息EVENT_M_RCVOVER = 0x00000080接收一条消息完成EVENT_M_APRCV = 0x00000100应用收到一条消息EVENT_M_KBEGINSND= 0x00000400开始发送消息信息EVENT_M_SNDOVER = 0x00000800发送一条消息完成EVENT_M_WAITACKTMOUT=0x00004000发送方等待应答超时EVENT_M_WAITDEALTMOUT=0x00008000接收方等待处理过程中超时EVENT_M_CHKRCVEND= 0X00010000发送方通过核对得知接收方已经接收结束，但不知道成功还是失败第四章TongLINK/Q类的使用说明4.1 tlqLogin 应用程序注册方法说明：int tlqLogin(TlqId tlqId, int type);参数：type应用程序编号tlqId TlqId类的实例返回值：０成功-1　失败使用说明：1．用于初始化过程。