MQ客戶端使用手册.docx

1.Release NotesDEMO程序（Java）Version 4.2.0（当前支持版本）大大简化配置，连接工厂类、消费监听器容器，发送模板都共享，不用为每个消息类型单独配置升级了SAF版本和Zookeeper客户端版本，解决了重连Zookeeper异常及其可能造成的内存溢出提供了发送者和消费者的接口消费者容器增加了一些API，增加和删除消费者，暂停和恢复消费，检查是否暂停消费等等消费方，如果配置了异常处理器，则会自动创建过滤器，提供过滤数据和暂停功能，需要zookeeper支持消费者默认延迟5秒启动并发数，默认1-5，根据消息数量自动调整消费会话线程每个消息类型，单独的连接，避免互相影响异步关闭连接，解决某些场景，关闭时间过长，会阻塞进程一段时间解决管理端暂停消费，应用重启后继续消费的问题管理端移除消息类型的消费者，应用自动停止该消息类型的消费，需要zookeeper支持增加TextMessageListener类，建议文本消息监听器都从该类继承升级说明：大量重构调整了相关API和配置文件，请按照Demo重新配置和测试Version 4.1.0增加暂停消费消息功能增加在日志中记录发送或消费缓慢的功能修复客户端无法正常关闭的bug修复集群切换连接无法完全断开的问题Version 4.0.0增加批量消费接口增加发送异常重试功能增加消息拦截器功能增加消费线程智能调整功能Version 3.0.1修复zookeeper重启造成Leader选举问题，建议3.0.0升级为该版本Version 3.0.0增加消息批量发送接口大幅度优化消息发送和接收速度Version 2.5.4修复zookeeper重启造成Leader选举问题，建议2.5.3升级为该版本Version 2.5.3修复一个重试服务相关bugVersion 2.5.1修复saf版本获取错误的问题Version 2.5.0增加mq命名空间配置功能，简化客户端配置Version 2.0.2修改API调用Close程序不能正常退出情况ClusterMessageListenerContainer增加sessionTransacted和sessionAcknowledgeMode读取方法Version 2.0.1ClusterMessageListenerContainer增加MessageListenerAdapter兼容Version 2.0消费者增加重试服务Version 1.0.1修改concurrency配置Version 1.0集群客户端发布，支持动态扩容，Failover，LoadBalance2.MQ报警信息说明短信信息邮件type说明解决方案MQ积压backlog消费方未能及时消费完发送来的消息，积压在MQ服务端检测消费者连接是否断开，消费速度是否存在问题MQ连接connection客户端与MQ服务端连接断开是否正在上线，如果未在上线检测消费者进程是否存活，网络是否存在问题MQ重试retry发送消息失败或是消费方消费出现错误数据检查消息内容或消费逻辑是否存在问题，解决后消息会自动重试成功，如无法解决3天后消息会过期MQ死信dlq消费方消费出现错误数据，重试服务未开启或是调用失败检查消息内容或消费逻辑是否存在问题，解决后需手动在管理端进行move操作，移动回正常队列3.接入规范3.1.应用规范规范说明监听模式保证消息的及时性消息持久化避免消息丢失VirtualTopic替换Topic支持同一个消费者集群负载均衡发布订阅关系需要提前申请，通过管理控制台在系统中维护好messageId字符串，业务消息的唯一ID，存放在JMS消息Properties中自定义属性中，便于归档查询systemId字符串，业务系统编码，和管理控制台中维护的值一致，存放在JMS消息Properties中自定义属性中，便于归档查询compressType字符串，自定义压缩算法，存放在JMS消息Properties中自定义属性中，1为zip压缩Queue命名规范系统代码_消息类型代码VirtualTopic生产者命名规范VirtualTopic.消息类型代码VirtualTopic消费者命名规范Consumer.系统代码.VirtualTopic.消息类型代码消息重发MQ为了保证消息的可靠，可能造成消息重发，消费者必须对重复消息的进行判断处理3.2.客户端异常的处理客户端必须对如下异常进行处理：确保异常后数据能重新发送接收和与MQ重连消费者发生异常，应该优先考虑本地持久化重试，如果抛出了异常，造成消息没有消费，则会保留在MQ中一段时间，这时可能会阻塞新消息的处理。消费者如果发生逻辑业务异常，例如某个信息错误，造成业务无法处理，也应该消费该条消息，记录下日志。3.3.数据包大小消息大小的约束：推荐