开源网络库 GCDAsyncSocket 笔记

GCDAsyncSocket 地址: https://github.com/robbiehanson/CocoaAsyncSocket/

 

使用方法:

创建:

asyncsocket = [[GCDAsyncSocket alloc] initWithDelegate:self delegateQueue:dispatch_get_main_queue()];

这里我们让所有的回调执行都发生在主线程的queue里，当然我们可以传一个专用的queue.

连接 :

NSError *err = nil;if (![asyncsocket connectToHost:@"deusty.com" onPort:80 error:&err]) // Asynchronous!{    //该方法异步，返回错误是因为 delegate没设置等    NSLog(@"I goofed: %@", err);}

　该方法会立刻返回,当成功连接上，delegate 的 socket:didConnectToHost:port: 方法会被调用.

- (void)socket:(GCDAsyncSocket *)sender didConnectToHost:(NSString *)host port:(UInt16)port{    NSLog(@"Cool, I'm connected! That was easy.");}

有几种不同的连接方法,比如带超时的.。。。

虽然这个时候可能 socket 还没连接上，但是我们依然可以投递 读/写 请求:

[asyncSocket readDataToLength:LENGTH_HEADER withTimeout:-1 tag:TAG_HEADER];

这样读请求会自动进入了队列,当socket 连接上后,请求会自动出队被执行。(这里假设先读一个包头,再根据长度接收包体，这个读操作完成后 socket:didReadData:withTag: 会被调用)

当然我们可以投递多个读写操作而不必等待上一个完成.

[asyncSocket writeData:msgHeader withTimeout:-1 tag:TAG_HEADER];[asyncSocket writeData:msgBody withTimeout:-1 tag:TAG_BODY];

上面的操作均为异步。下面为操作完成的委托方法:

read:

- (void)socket:(GCDAsyncSocket *)sender didReadData:(NSData *)data withTag:(long)tag{    if (tag == TAG_HEADER)    {        int bodyLength = [self parseHeader:data];        [socket readDataToLength:bodyLength withTimeout:-1 tag:TAG_RESPONSE_BODY];    }    else if (tag == TAG_RESPONSE_BODY)    {        // Process the response        [self handleResponseBody:data];        // Start reading the next response        [socket readDataToLength:headerLength withTimeout:-1 tag:TAG_FIXED_LENGTH_HEADER];    }}//还有另一个读方法,// [asyncSocket readDataToData:msgSeparator withTimeout:TIMEOUT_NONE tag:TAG_CAPABILITIES];// 读当遇到一个指定的分隔符后操作返回。比如用作 http, 因为http 每个消息都会有一个@"\r\n\r\n" 结尾标志.

//如果想跟踪进度 socket: didReadPartialDataOfLength: tag: 用这个

write:

- (void)socket:(GCDAsyncSocket *)sock didWriteDataWithTag:(long)tag{    if (tag ==TAG_HEADER) 　　　　NSLog(@"TAG_HEADER request sent"); 

　　else if (tag ==TAG_BODY) 　　　　NSLog(@"TAG_BODY request sent");

}

断开释放一个连接实例

[asyncSocket setDelegate:nil delegateQueue:NULL];[asyncSocket disconnect];[asyncSocket release];

　　

相关的delegate 方法(回调)

socket: didConnectToHost: port:socket: didReadData: withTag:socket: didReadPartialDataOfLength: tag:socket: shouldTimeoutReadWithTag: elapsed: bytesDone:socket: didWriteDataWithTag:socket: didWritePartialDataOfLength: tag:socket: shouldTimeoutWriteWithTag: elapsed: bytesDone:socketDidSecure:socket: didAcceptNewSocket:newSocketQueueForConnectionFromAddress: onSocket:socketDidCloseReadStream:socketDidDisconnect: withError: