QoS4SendDaemon (MobileIMSDK_UDP 6.5(Java平台) API文档)

java.lang.Object
- net.x52im.mobileimsdk.java.core.QoS4SendDaemon

```
public class QoS4SendDaemon
extends java.lang.Object
```
QoS机制中提供消息送达质量保证的守护线程。
本类是QoS机制的核心，极端情况下将弥补因UDP协议天生的不可靠性而带来的丢包情况。
当前MobileIMSDK的QoS机制支持全部的C2C、C2S、S2C共3种消息交互场景下的消息送达质量保证.
本线程的启停，目前属于MobileIMSDK算法的一部分，暂时无需也不建议由应用层自行调用。

从以下版本开始:

2.0

版本:

1.1

作者:

Jack Jiang(http://www.52im.net/thread-2792-1-1.html)

字段概要

字段
限定符和类型	字段和说明
`static int`	`CHECH_INTERVAL` QoS质量保证线程心跳间隔（单位：毫秒），默认5000ms.
`static int`	`MESSAGES_JUST$NOW_TIME` “刚刚”发出的消息阀值定义（单位：毫秒），默认3000毫秒。
`static int`	`QOS_TRY_COUNT` 一个包允许的最大重发次数，默认2次。

方法概要

所有方法静态方法实例方法具体方法
限定符和类型	方法和说明
`void`	`clear()` 清空缓存队列。
`static QoS4SendDaemon`	`getInstance()`
`boolean`	`isRunning()` 线程是否正在运行中。
`protected void`	`notifyMessageLost(java.util.ArrayList<net.x52im.mobileimsdk.server.protocal.Protocal> lostMessages)` 将未送达信息反馈给消息监听者。
`void`	`put(net.x52im.mobileimsdk.server.protocal.Protocal p)` 推入一个消息包的指纹特征码.
`void`	`remove(java.lang.String fingerPrint)` 移除一个消息包.
`void`	`run()`
`int`	`size()` 队列大小.
`void`	`startup(boolean immediately)` 启动线程。
`void`	`stop()` 无条件中断本线程的运行。

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - CHECH_INTERVAL
```
public static final int CHECH_INTERVAL
```
    QoS质量保证线程心跳间隔（单位：毫秒），默认5000ms.
    间隔越短则为用户重发越即时，但将使得重复发送的可能性增大（因为可能在应答包尚在途中时就判定丢包了的错误情况），当然，即使真存在重复发送的可能也是无害的，因为MobileIMSDK的QoS机制本身就有防重能力。请根据您的应用所处的网络延迟情况进行权衡，本参数为非关键参数，如无特殊情况则建议无需调整本参数。
    
    另请参阅:
    
    常量字段值
  - MESSAGES_JUST$NOW_TIME
```
public static final int MESSAGES_JUST$NOW_TIME
```
    “刚刚”发出的消息阀值定义（单位：毫秒），默认3000毫秒。 注意：此值通常无需由开发者自行设定，保持默认即可。
    此阀值的作用在于：在QoS=true的情况下，一条刚刚发出的消息会同时保存到本类中的QoS保证队列，在接收方的应答包还未被发出方收到时（已经发出但因为存在数十毫秒的网络延迟，应答包正在路上），恰好遇到本次QoS质量保证心跳间隔的到来，因为之前的QoS队列罗辑是只要存在本队列中还未被去掉的包，就意味着是要重传的——那么此逻辑在我们本次讨论的情况下就存在漏洞而导致没有必要的重传了。如果有本阀值存在，则即使刚刚发出的消息刚放到QoS队列就遇到QoS 心跳到来，则只要当前放入队列的时间小于或等于本值，就可以被认为是刚刚放入，那么也就避免被误重传了。
    基于以上考虑，本值的定义，只要设定为大于一条消息的发出起到收到它应答包为止这样一个时间间隔即可（其实就相于一个客户端到服务端的网络延迟时间4倍多一点点即可）。此处定为3秒其实是为了保守起见哦。
    本参数将决定真正因为UDP丢包而重传的即时性问题，即当MobileIMSDK的UDP丢包时，QoS首次重传的响应时间为> MESSAGES_JUST$NOW_TIME(即3000毫秒) 而 <= CHECH_INTERVAL(即5000毫秒)。
    
    从以下版本开始:
    
    2.1.1
    
    另请参阅:
    
    常量字段值
  - QOS_TRY_COUNT
```
public static final int QOS_TRY_COUNT
```
    一个包允许的最大重发次数，默认2次。
    次数越多，则整个UDP的可靠性越好，但在网络确实很烂的情况下可能会导致重传的泛滥而失去 “即时”的意义。请根据网络状况和应用体验来权衡设定，本参数为0表示不重传，建议使用1到5 之间的数字。
    
    另请参阅:
    
    常量字段值
- 方法详细资料
  - getInstance
```
public static QoS4SendDaemon getInstance()
```
  - run
```
public void run()
```
  - notifyMessageLost
```
protected void notifyMessageLost(java.util.ArrayList<net.x52im.mobileimsdk.server.protocal.Protocal> lostMessages)
```
    将未送达信息反馈给消息监听者。
    
    参数:
    
    lostMessages - 已被判定为“消息未送达”的消息列表
    
    另请参阅:
    
    ClientCoreSDK.getMessageQoSEvent()
  - startup
```
public void startup(boolean immediately)
```
    启动线程。
    无论本方法调用前线程是否已经在运行中，都会尝试首先调用 stop()方法，以便确保线程被启动前是真正处于停止状态，这也意味着可无害调用本方法。
    本线程的启停，目前属于MobileIMSDK算法的一部分，暂时无需也不建议由应用层自行调用。
    
    参数:
    
    immediately - true表示立即执行线程作业，否则直到 CHECH_INTERVAL 执行间隔的到来才进行首次作业的执行
  - stop
```
public void stop()
```
    无条件中断本线程的运行。
    本线程的启停，目前属于MobileIMSDK算法的一部分，暂时无需也不建议由应用层自行调用。
  - isRunning
```
public boolean isRunning()
```
    线程是否正在运行中。
    
    返回:
    
    true表示是，否则线路处于停止状态
  - put
```
public void put(net.x52im.mobileimsdk.server.protocal.Protocal p)
```
    推入一个消息包的指纹特征码.
    注意：本方法只会将指纹码推入，而不是将整个Protocal对象放入列表中。
    
    参数:
    
    p -
  - remove
```
public void remove(java.lang.String fingerPrint)
```
    移除一个消息包.
    此操作是在步异线程中完成，目的是尽一切可能避免可能存在的阻塞本类中的守望护线程.
    
    参数:
    
    fingerPrint - 消息包的特纹特征码（理论上是唯一的）
  - clear
```
public void clear()
```
    清空缓存队列。
    调用此方法可以防止在APP不退出的情况下退出登陆MobileIMSDK时没有清除队列缓存，导致此时换用另一账号时发生数据交叉。
    
    从以下版本开始:
    
    3.2
  - size
```
public int size()
```
    队列大小.
    
    返回:
    
    另请参阅:
    
    HashMap.size()

类 QoS4SendDaemon

字段概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

CHECH_INTERVAL

MESSAGES_JUST$NOW_TIME

QOS_TRY_COUNT

方法详细资料

getInstance

run

notifyMessageLost

startup

stop

isRunning

put

remove

clear

size