断点续传简明二次开发以及测试手册

1二次开发接口

导入com.ibm.mqtrans. MQTransInterface类、com.ibm.mqtrans.model.TransInfo类、com.ibm.mqtrans.model.TransInfo，com.ibm.mqtrans.model .ReceveFileData类

com.ibm.mqtrans. MQTransInterface类提供了以下几个接口

方法：initFromConfig(String configFileName)

此方法是静态方法，在调用MQ断点续传接口时仅仅需要调用此接口一次

configFileName：是所需要的配置文件的绝对路径名

方法：int sendFile(String absolutFileName,String receiverName,TransInfo transInfo) 发送文件到MQ服务器中。

参数：

absolutFileName：要发送的文件名

receiverName：此文件的接收者，使用时请置NULL

transInfo:存储了发送的字节数目等信息，使用此方法时每使用一次请创建此对象一次。返回值：

/*

* -6:没有足够的可用线程来启动分块传输，请过段时间重试

* -5:没有空闲的服务线程服务

* -4:要发送的文件不能够读取，不能够继续

* -3:要发送的不是文件

* -2:要发送的文件不存在

* -1:失败

* 0:成功

* 1:无法取得与MQ队列管理器的连接

* 2:与MQ队列管理器的连接无效，即出现网络失效错误

*/

方法：List getReceiveFileList(String receiverName,int count)

从MQ服务器中取得可以下载的文件列表

参数：

receiverName：接收者，使用时请置NULL

count：需要此接口的返回数目，如置上50

返回值：

返回能够接收的文件列表对象，此列表包含ReceveFileData对象

ReceveFileData对象的定义：

Msgid：唯一标志能够接收的文件ID

Chunkcount：此文件被分成几段上传的，也就意味着将分成几段同时下载

fileLength：此文件的长度

desc：此文件的描述信息,此信息的格式为：主机名+":"+IP地址+":"+文件名;

tradeCode：需要调用外部类的交易ID，现在不支持

方法:String recvFile(ReceveFileData receveFileData,String dirName,String receiverName,TransInfo transInfo,List errorList)

接收文件，调用此方法前需要先调用getReceiveFileList

参数：

receveFileData:调用getReceiveFileList方法返回的List中对应的对象，指明需要下载的文件

dirName：指定下载下来的文件需要存放的路径

transInfo: 存储了接收的字节数目等信息，使用此方法时每使用一次请创建此对象一次。

errorList：错误信息的一些列表，主要是对应分段下载有多个信息

1.1如何编译和修改此系统

此系统是采用JA V A语言，eclipse IDE环境实现，在相应的工程目录中，src目录是源代码的目录，lib 目录是系统所需要的外部库的目录（需要把这个目录中相应的JAR文件加入到ECLIPSE环境中）。

JDK需要1.5 。当然用JDK1.4.2也是可以进行编译和测试的，不过建议使用JDK1.5。2配置文件定义

userid="" password="" connectionpollnum="5" timeout="10" />

1

1

2

0

1

32

TRANS.FILEDA TA

FILETRANS.CONTROL

FILETRANS.CONTROL.FINISH

c:\temp

3系统初始化

1、安装MQ服务器，并建立相应地队列管理器（如TESTQM），并且建立一个侦听器（如

侦听1414端口）。

2、接口的日志信息记录是采用LOG4J库，所以如果更改相应的日志记录信息请修改

log4j的配置文件

3、打开配置文件sysparamconfg.xml文件，找到queuename、filetranscontorlqueuename、

filetranscontorlfinishqueuename三个节点修改相应的值或者不进行修改。并在队列管理器中建立此三个节点对应的值的队列名，（特别是需要把filetranscontorlqueuename针对的最大深度值改大，如改成5千万）。

示例：我们在总公司端安装了MQ服务器，下面大概有31个分公司需要往总公司端传送数据。我们可以把这31家分公司按照一定的规则划分如下所示：

|

|

| 华北(NC.QM 1414)

|

|

|

北京分公司

|

|

|天津分公司

|

|

| 华东(EC.QM 2414)

|

|

|上海分公司

|

|

| 浙江分公司

|

|江苏分公司

|

|

|华南(SC.QM 3414)

|

|

|广东分公司

|

|

|其它(OTHER.QM)

针对华北地区建立一个队列管理器如NC.QM，其它几大地区类似，并且监听不同的端口号，如华北的1414，华东的2414等；然后对每个地区如华东地区，由于上海、浙江、江苏这三家分公司的数据量都差不多，而其它分公司较少，所以我们对上海、浙江、江苏这三家分公司建立不同的队列来存放相应地数据（queuename、filetranscontorlqueuename、filetranscontorlfinishqueuename三个节点对应的数据每个分公司都不一样，如上海分公司为

SH. TRANS.FILEDATA, SH.FILETRANS.CONTROL, SH.FILETRANS.CONTROL.FINISH.浙江和江苏的都是类似，并且对于每个分公司都在服务端启动一个JA V A进程来进行相应的接收工作）。

4、打开配置文件sysparamconfg.xml文件，找到msgpersist节点，把此节点的值改成1的话

将启用MQ消息持久性，传输性能将下降1倍左右，但是在多个队列管理器组织成分布式队列管理器的时候请设置为1。

5、打开配置文件sysparamconfg.xml文件，找到controlmsgpersist节点，把此节点的值改成

1，请不要把这个字段才成其它值。

6、打开配置文件sysparamconfg.xml文件，找到msgsize节点，可以修改此节点的值，如在

带宽降低的情况下，这个值可以改小如4K/8K。

7、系统提供了相应的发送接口和接收接口，可以在接收接口的基础上开发一个模块，此模

块定时如每个100毫秒，调用一次getReceiveFileList获取能够下载的文件列表，然后可以根据相应的需要启动多个线程或者就启动一个线程，每个线程调用recvFile进行收取（当然线程也不需要启动过多）。

8、要运行系统请修改sysparamconfg.xml 文件mqparamset节点对应的连接信息。

4测试

编写了两个客户端，一个是发送客户端和一个是接收客户端，启动的脚本分别是startSendTest.cmd和startRecvTest.cmd。这个客户端也是系统的测试程序，也是此系统接口调用的例子程序。

如何启动这两个客户端呢？

1．请从网站下载sun公司的最新版本的JDK1.5.

2．修改setEnv.cmd这个文件中的

set JA V A_HOME=C:\Program Files\Java\jdk1.5.0_06 这个JA V A_HOME指向你安装JDK1.5的目录

3. 找一台机器安装MQ Server

你可以修改可执行程序目录中的classes目录log4j.properties中相应地字段的值，使此接口输出的日志指向你所需要的路径

可以修改sysparamconfig.xml这个配置文件，来修改你要连接的MQ服务器的地址和名称，也可以修改这个配置文件相应地值来更改此程序的行为（如修改msgsize字段来决定发送的消息大小和修改msgpersist字段来使接口是否启用持久性消息）

4.1发送测试

此测试客户端可以演示网络中断，客户端进程被突然杀死，MQ服务器突然当掉这些异常情况出现的断点续传。

启动startSendTest.cmd脚本

1.启动后程序界面：

2．点击选择文件，来选择你所需要发送的文件和目录

3．点击开始上传按钮，程序将显示相应地信息（如进度条，速率等信息）

在这个途中，你可以拔掉网线，杀死这个进程，杀掉MQ SERVER进程，来测试发送的断点上传。

4.2 接收测试

此测试客户端可以演示网络中断，客户端进程被突然杀死，MQ服务器突然当掉这些异常情况出现的断点下载。

启动startRecvTest.cmd脚本

1．启动后的界面：

2．点击查询按钮，来获取你能够下载的文件列表

3．选中某一行，点击开始下载的按钮，程序将出现一个界面，让你选择你要把下载的文件放在哪个目录中。

4．点击打开，程序将开始下载，如下面的界面所示：

当然在sysparamconfig.xml文件中的c:\temp节点所示的内容对应的路径+/RECV具有下载的相应的临时信息。