ARTSPConnection::receive

1.recv函数介绍

　　int recv( SOCKET s, char FAR *buf, int len, int flags );
　　不论是客户端还是服务器端应用程序都用recv函数从TCP连接的另一端接收数据。
　　参数解释：
　　　　1.参数s指定接收端套接字描述符；
　　　　2.参数buf指明一个缓冲区，该缓冲区用来存放recv函数接收到的数据
　　　　3.参数len指明buf的长度；
　　　　4.参数flags一般置0。

　　这里只描述同步Socket的recv函数的执行流程：
　　　　1.当应用程序调用recv函数时，recv先等待s的发送缓冲中的数据被协议传送完毕
　　　　2.如果协议在传送s的发送缓冲中的数据时出现网络错误，那么recv函数返回SOCKET_ERROR
　　　　3.如果s的发送缓冲中没有数据或者数据被协议成功发送完毕后，recv先检查套接字s的接收缓冲区
　　　　4.如果s接收缓冲区中没有数据或者协议正在接收数据，那么recv就一直等待，只到协议把数据接收完毕。
　　　　5.当协议把数据接收完毕，recv函数就把s的接收缓冲中的数据copy到buf中
　　
　　注意：
　　协议接收到的数据可能大于buf的长度，所以在这种情况下要调用几次recv函数才能把s的接收缓冲中的数据copy完。recv函数仅仅是copy数据，真正的接收数据是协议来完成的，recv函数返回其实际copy的字节数。如果recv在copy时出错，那么它返回SOCKET_ERROR。如果recv函数在等待协议接收数据时网络中断了，那么它返回0。

　　注意：
　　在Unix系统下，如果recv函数在等待协议接收数据时网络断开了，那么调用recv的进程会接收到一个SIGPIPE信号，进程对该信号的默认处理是进程终止。

　　默认情况下socket是阻塞的。阻塞与非阻塞recv返回值没有区别，都是：
　　　　1. <0 出错
　　　　2. =0 对方调用了close API来关闭连接
　　　　3. >0 接收到的数据大小
　　　　
　　特别地：
　　返回值<0时并且(errno == EINTR || errno == EWOULDBLOCK || errno == EAGAIN)的情况下认为连接是正常的，继续接收。只是阻塞模式下recv会一直阻塞直到接收到数据，非阻塞模式下如果没有数据就会返回，不会阻塞着读，因此需要循环读取。
　　
　　返回说明：
　　　　（1）成功执行时，返回接收到的字节数。
　　　　（2）若另一端已关闭连接则返回0，这种关闭是对方主动且正常的关闭
　　　　（3）失败返回-1，errno被设为以下的某个值
　　　　　　EAGAIN：套接字已标记为非阻塞，而接收操作被阻塞或者接收超时
　　　　　　EBADF：sock不是有效的描述词
　　　　　　ECONNREFUSE：远程主机阻绝网络连接
　　　　　　EFAULT：内存空间访问出错
　　　　　　EINTR：操作被信号中断
　　　　　　EINVAL：参数无效
　　　　　　ENOMEM：内存不足
　　　　　　ENOTCONN：与面向连接关联的套接字尚未被连接上
　　　　　　ENOTSOCK：sock索引的不是套接字

2.安卓N版本ARTSPConnection::receive

status_t ARTSPConnection::receive(void *data, size_t size) {    //该receive函数是对系统函数recv的封装，作用是从创建的套接口读取指定的数据长度    //从mSocket套接口读取的数据是服务端的响应(response)    size_t offset = 0;    while (offset < size) {        ssize_t n = recv(mSocket, (uint8_t *)data + offset, size - offset, 0);        if (n < 0 && errno == EINTR) {            //当n < 0并且errno为EINTR的时候说明连接是正常的，继续接收            continue;        }        if (n <= 0) {            performDisconnect();            if (n == 0) {                //当n == 0说明是对方主动且正常的关闭                // Server closed the connection.                ALOGE("Server unexpectedly closed the connection.");                return ERROR_IO;            } else {                //当n < 0说明返回失败，错误码存放在errno中                ALOGE("Error reading rtsp response. (%s)", strerror(errno));                return -errno;            }        }        offset += (size_t)n;    }    return OK;}