net.x52im.mobileimsdk.android.utils

类 TCPUtils

java.lang.Object

net.x52im.mobileimsdk.android.utils.TCPUtils

public class TCPUtils
extends java.lang.Object

一个本地TCP消息发送工具类。

版本:

2.0

作者:

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

构造器概要

构造器

构造器和说明
TCPUtils()

方法概要

限定符和类型	方法和说明
static java.lang.String	getSocketAdressInfo(java.net.SocketAddress s)
static boolean	send(io.netty.channel.Channel skt, byte[] d, int dataLen) 发送一条tcp消息。
static boolean	send(io.netty.channel.Channel skt, byte[] d, int dataLen, MBObserver resultObserver) 发送一条tcp消息。

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

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

TCPUtils

public TCPUtils()

方法详细资料

send

public static boolean send(io.netty.channel.Channel skt,
                           byte[] d,
                           int dataLen)

发送一条tcp消息。

关于本方法的更多说明，请参见方法：send(Channel, byte[], int, MBObserver)的详细说明。

参数:

skt - netty中的Channel对象，相当于传统BIO中的socket对象

d - 要发送的数据内容

dataLen - 要发送的数据内容byte长度

返回:

false表示数据发送时出错了（发送失败），理论上说true只代表没有发送失败但不代表一定发送成功（严格意义上的 发送成功与否的结果，请使用 send(Channel, byte[], int, MBObserver)方法中的 #resultObserver 参数设置观察者来实现结果通知，因为netty的数据发送是异步实现的）

另请参阅:

send(Channel, byte[], int, MBObserver)

send

public static boolean send(io.netty.channel.Channel skt,
                           byte[] d,
                           int dataLen,
                           MBObserver resultObserver)

发送一条tcp消息。

对于MobileIMSDK的TCP底层来说，本数据是整个TCP帧的body部分，具体的TCP帧组织方式，由netty的编码、解码 handler去自动处理了，此处应用层不需要自已处理。有关MobileIMSDK中的TCP帧定义，请见 LocalSocketProvider.TCP_FRAME_FIXED_HEADER_LENGTH

本方法中已对可能发生的异常进行了处理，调用者只会知道有否成功而不会被异常打断。
*********************************************************************************************

特别说明：如何知道本方法的数据发送成功与否？

• 1）通过 #resultObserver 参数指明的观察者接收数据发送结果，可以准确得知数据是否发送成功（准确地是说 是数据是否被成功写入tcp缓冲区）；
• 2）通过本方法的返回值，可以准确得知数据是否发送失败，但理论上无法百分百得知数据是否发送成功（准确地是 说是数据是否被成功写入tcp缓冲区），因为netty的异步特性，是否成功需通过 #resultObserver 参数指 明的观察者来得到结果。

我的建议：

• 1）当你的场景下，需要准确得知发送结果时，请使用 #resultObserver 参数来获取发送结果；
• 2）当你的场景下，不一定需要准确得到发送结果时，可以直接用返回值（代码写起来比用观察者回调的方式要简单 嘛），主流的im比如qq、微信、以及基于MobileIMSDK的im产品RainbowChat，由于存在消息送达保证机制， 所以应用层只管发送，至于能不能准确获得发送结果，没有关系，因为在没有收到对方的ACK应答时，界面上的 消息发送进度指示（菊花）会一直在转，余下的逻辑由QoS机制去判定消息被收到或没收到，不会受本方法的发 送结果影响。

参数:

skt - netty中的Channel对象，相当于传统BIO中的socket对象

d - 要发送的数据内容

dataLen - 要发送的数据内容byte长度

resultObserver - 数据发送结果回调。对于netty来说，通过此异步回调通知，可以真正知道数据发送是否成功

返回:

false表示数据发送时出错了（发送失败），理论上说true只代表没有发送失败但不代表一定发送成功（严格意 义上的发送成功与否的结果，请使用 #resultObserver 参数设置观察者来实现结果通知，因为netty的数据 发送是异步实现的）

getSocketAdressInfo

public static java.lang.String getSocketAdressInfo(java.net.SocketAddress s)