《断点续传简明二次开发以及测试手册.doc》由会员分享，可在线阅读，更多相关《断点续传简明二次开发以及测试手册.doc（10页珍藏版）》请在三一办公上搜索。
1、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
2、sendFile(String absolutFileName,String receiverName,TransInfo transInfo)发送文件到MQ服务器中。参数：absolutFileName：要发送的文件名receiverName：此文件的接收者，使用时请置NULLtransInfo:存储了发送的字节数目等信息，使用此方法时每使用一次请创建此对象一次。返回值：/* * -6:没有足够的可用线程来启动分块传输，请过段时间重试 * -5:没有空闲的服务线程服务 * -4:要发送的文件不能够读取，不能够继续 * -3:要发送的不是文件 * -2:要发送的文件不存在 * -1:失败 *
3、0:成功 * 1:无法取得与MQ队列管理器的连接 * 2:与MQ队列管理器的连接无效，即出现网络失效错误 */方法：List getReceiveFileList(String receiverName,int count) 从MQ服务器中取得可以下载的文件列表参数： receiverName：接收者，使用时请置NULL count：需要此接口的返回数目，如置上50返回值： 返回能够接收的文件列表对象，此列表包含ReceveFileData对象ReceveFileData对象的定义：Msgid：唯一标志能够接收的文件IDChunkcount：此文件被分成几段上传的，也就意味着将分成几段同时下载
4、fileLength：此文件的长度desc：此文件的描述信息,此信息的格式为：主机名+:+IP地址+:+文件名;tradeCode：需要调用外部类的交易ID，现在不支持方法:String recvFile(ReceveFileData receveFileData,String dirName,String receiverName,TransInfo transInfo,List errorList)接收文件，调用此方法前 需要先调用getReceiveFileList参数：receveFileData:调用getReceiveFileList方法返回的List中对应的对象，指明需要下载的文
5、件dirName：指定下载下来的文件需要存放的路径transInfo: 存储了接收的字节数目等信息，使用此方法时每使用一次请创建此对象一次。errorList：错误信息的一些列表，主要是对应分段下载有多个信息1.1 如何编译和修改此系统此系统是采用JAVA语言，eclipse IDE环境实现，在相应的工程目录中，src目录是源代码的目录，lib 目录是系统所需要的外部库的目录（需要把这个目录中相应的JAR文件加入到ECLIPSE环境中）。JDK需要1.5。当然用JDK1.4.2也是可以进行编译和测试的，不过建议使用JDK1.5。2 配置文件定义112 01 32TRANS.FILEDATAFI
6、LETRANS.CONTROLFILETRANS.CONTROL.FINISHc:temp3 系统初始化1、 安装MQ服务器，并建立相应地队列管理器（如TESTQM），并且建立一个侦听器（如侦听1414端口）。2、 接口的日志信息记录是采用LOG4J库，所以如果更改相应的日志记录信息请修改log4j的配置文件3、 打开配置文件sysparamconfg.xml文件，找到queuename、filetranscontorlqueuename、filetranscontorlfinishqueuename三个节点修改相应的值或者不进行修改。并在队列管理器中建立此三个节点对应的值的队列名，（特别是需
7、要把filetranscontorlqueuename针对的最大深度值改大，如改成5千万）。示例：我们在总公司端安装了MQ服务器，下面大概有31个分公司需要往总公司端传送数据。我们可以把这31家分公司按照一定的规则划分如下所示：| 华北(NC.QM 1414) |北京分公司|天津分公司 | | | 华东(EC.QM 2414) | | |上海分公司 | | | 浙江分公司 | |江苏分公司 | | |华南(SC.QM 3414) | | |广东分公司|其它(OTHER.QM)针对华北地区建立一个队列管理器如NC.QM，其它几大地区类似，并且监听不同的端口号，如华北的1414，华东的2414等；
8、然后对每个地区如华东地区，由于上海、浙江、江苏这三家分公司的数据量都差不多，而其它分公司较少，所以我们对上海、浙江、江苏这三家分公司建立不同的队列来存放相应地数据（queuename、filetranscontorlqueuename、filetranscontorlfinishqueuename三个节点对应的数据每个分公司都不一样，如上海分公司为SH. TRANS.FILEDATA, SH.FILETRANS.CONTROL, SH.FILETRANS.CONTROL.FINISH.浙江和江苏的都是类似，并且对于每个分公司都在服务端启动一个JAVA进程来进行相应的接收工作）。4、 打开配置文
9、件sysparamconfg.xml文件，找到msgpersist节点，把此节点的值改成1的话将启用MQ消息持久性，传输性能将下降1倍左右，但是在多个队列管理器组织成分布式队列管理器的时候请设置为1。5、 打开配置文件sysparamconfg.xml文件，找到controlmsgpersist节点，把此节点的值改成1，请不要把这个字段才成其它值。6、 打开配置文件sysparamconfg.xml文件，找到msgsize节点，可以修改此节点的值，如在带宽降低的情况下，这个值可以改小如4K/8K。7、 系统提供了相应的发送接口和接收接口，可以在接收接口的基础上开发一个模块，此模块定时如每个10
10、0毫秒，调用一次getReceiveFileList获取能够下载的文件列表，然后可以根据相应的需要 启动多个线程或者就启动一个线程，每个线程调用recvFile进行收取（当然线程也不需要启动过多）。8、 要运行系统请修改sysparamconfg.xml 文件mqparamset节点对应的连接信息。4 测试编写了两个客户端，一个是发送客户端和一个是接收客户端，启动的脚本分别是startSendTest.cmd和startRecvTest.cmd。这个客户端也是系统的测试程序，也是此系统接口调用的例子程序。如何启动这两个客户端呢？1 请从网站下载sun公司的最新版本的JDK1.5.2 修改set
11、Env.cmd这个文件中的set JAVA_HOME=C:Program FilesJavajdk1.5.0_06 这个JAVA_HOME指向你安装JDK1.5的目录 3. 找一台机器安装MQ Server你可以修改可执行程序目录中的classes目录log4j.properties中相应地字段的值，使此接口输出的日志指向你所需要的路径 可以修改sysparamconfig.xml这个配置文件，来修改你要连接的MQ服务器的地址和名称，也可以修改这个配置文件相应地值来更改此程序的行为（如修改msgsize字段来决定发送的消息大小和修改msgpersist字段来使接口是否启用持久性消息）4.1 发
12、送测试此测试客户端可以演示网络中断，客户端进程被突然杀死，MQ服务器突然当掉这些异常情况出现的断点续传。启动startSendTest.cmd脚本1.启动后程序界面：2点击选择文件，来选择你所需要发送的文件和目录3点击开始上传按钮，程序将显示相应地信息（如进度条，速率等信息）在这个途中，你可以拔掉网线，杀死这个进程，杀掉MQ SERVER进程，来测试发送的断点上传。4.2 接收测试此测试客户端可以演示网络中断，客户端进程被突然杀死，MQ服务器突然当掉这些异常情况出现的断点下载。启动startRecvTest.cmd脚本1 启动后的界面：2点击查询按钮，来获取你能够下载的文件列表3选中某一行，点击开始下载的按钮，程序将出现一个界面，让你选择你要把下载的文件放在哪个目录中。4点击打开，程序将开始下载，如下面的界面所示：当然在sysparamconfig.xml文件中的c:temp节点所示的内容对应的路径+/RECV具有下载的相应的临时信息。
