socket编程 - Asyncsocket使用大全
原文连接http://qk13warcraft.blog.163.com/blog/static/1575493442012778524173/
主要特性有：
队列的非阻塞的读和写，而且可选超时。你可以调用它读取和写入，它会当完成后告知你
自动的 socket接收。如果你调用它接收连接，它将为每个连接启动新的实例，当然，也可以立即关闭这些连接
委托（delegate）支持。错误、连接、接收、完整的读取、完整的写入、进度以及断开连接，都可以通过委托模式调用
基于run loop的，而不是线程的。虽然可以在主线程或者工作线程中使用它，但你不需要这样做。它异步的调用委托方法，使用NSRunLoop。委托方法包括 socket的参数，可让你在多个实例中区分
自包含在一个类中。你无需操作流或者 socket，这个类帮你做了全部
支持基于IPV4和IPV6的TCP流
加入：AsynSocket.h .m与AsynUdpSocket.h .m四个文件 及CFNetwork.framework
TCP客户端
复制代码
|
在需要联接地方使用connectToHost联接服务器
其中initWithDelegate的参数中self是必须。这个对象指针中的各个 Socket响应的函数将被ASyncSocket所调用.initWithDelegate把将当前对象传递进去，这样只要在当前对象方法实现相应方法
复制代码
|
关于NSData对象
无论 SOCKET收发都采用NSData对象.它的定义是 http://developer.apple.com/library/mac /#documentation/Cocoa/Reference/Foundation/Classes/NSData_Class/Reference/Reference.html
NSData主要是带一个(id)data指向的数据空间和长度 length.
NSString 转换成NSData 对象
复制代码
|
NSData 转换成NSString对象
复制代码
|
发送数据
AsyncSocket writeData 方法来发送数据，它有如下定义
复制代码
|
以下是一个实例语句.
复制代码
|
在onSocket重载函数，有如定义采用是专门用来处理 SOCKET的发送数据的：
复制代码
|
接收 Socket数据.
在onSocket重载函数，有如定义采用是专门用来处理 SOCKET的接收数据的.
复制代码
|
在中间将其转换成NSString进行显示.
复制代码
|
6、TCP连接读取制定长度的数据
socket连接，可能会读取固定长度的字节
复制代码
|
各方法的解析
复制代码
|
发生错误， socket关闭，可以在call-back过程调用"unreadData"去取得 socket的最后的数据字节，当连接的时候，该委托方法在 onSocket:didAcceptNewSocket: 或者 onSocket:didConnectToHost： 之前调用
复制代码
|
当 socket由于或没有错误而断开连接，如果你想要在断开连接后release socket，在此方法工作，而在onSocket:willDisconnectWithError 释放则不安全
复制代码
|
当产生一个 socket去处理连接时调用，此方法会返回 线程上的run-loop 的新的 socket和其应处理的委托，如果省略，则使用[NSRunLoop cunrrentRunLoop]
复制代码
|
当 socket连接正准备读和写的时候调用，host属性是一个IP地址，而不是一个DNS 名称
复制代码
|
当 socket已完成所要求的数据读入内存时调用，如果有错误则不调用
复制代码
|
当一个 socket读取数据，但尚未完成读操作的时候调用，如果使用 readToData: or readToLength: 方法 会发生,可以被用来更新进度条等东西
复制代码
|
当一个 socket已完成请求数据的写入时候调用
复制代码
|
当一个 socket写入一些数据，但还没有完成整个写入时调用，它可以用来更新进度条等东西
复制代码
|
使用读操作已超时但还没完成时调用，此方法允许随意延迟超时，如果返回一个正的时间间隔，读取的超时将有一定量的扩展，如果不实现这个方法，或会像往常一样返回一个负的时间间隔，elapsed参数是 原超时的总和，加上先前通过这种方法添加的任何补充， length参数是 读操作到目前为止已读取的字节数， 注意，如果返回正数的话，这个方法可能被一个单独的读取多次调用
复制代码
|
如果一个写操作已达到其超时但还没完成时调用，同上
复制代码
|
在 socket成功完成ssl/tls协商时调用，此方法除非你使用提供startTLS方法时候才调用，
如果ssl/tls是无效的证书， socket将会立即关闭，onSocket:willDisconnectWithError:代理方法竟会与特定的ssl错误代码一起调用
复制代码
|
用来查看在改变它之前，是否带有与当前的委托有悬而未决的业务(读/写)。当然，应在安全连接或接受委托之前改变委托
一旦接收或连接方法之一被调用，AsyncSocket实例会被锁定，其他接收/连接方法在没有先断开 socket不会被调用
如果尝试失败或超时，这些方法要么返回NO 要么调用 onSocket:willDisconnectWithError: 或 onSockedDidDisconnect
当传入的连接被接受，AsyncSocket调用多个委托方法。这些方法按照时间顺序排列：
1.onSocket:didAcceptNewSocket:
2.onSocket:wantsRunLoopForNewSocket:
3. onSocketWillConnect:
你的服务器的代码将需要保留公认的 socket(如果要接受它)，最好的地方是要做到这一点可能在onSocket:didAcceptNewSocket:方法
在读和写流已经为新接受的 socket设置，onSocket:didConnectToHost:port 方法将在适当的运行循环调用
多线程注意，如果要想通过实施onSocket：wantsRunLoopForNewSocket：，移动另一个新接收的 socket去到另一个循环的 socket。然后，应该在调用读和写或者startTLS方法前，等待直到onSocket:didConnectToHost:port:方法。否则读和写时间原定于不正确的runloop，会发生混乱
复制代码
|
告诉 socket开始听取和接受指定端口上的连接，当一个连接到来的时候，AsyncSocket实例将调用各种委托方法， socket将听取所有可用的接口(wifi,以太网等)
复制代码
|
连接给定的主机和端口，主机hostname可以是域名或者是Ip地址
复制代码
|
连接到一个给定的地址，指定一个sockaddr结构包裹住一个NSData对象,例如，NSData对象从NSNetService的地址方法返回,如果有一个现有的sockaddr结构，可以将它转换到一个NSData对象，像这样：
struct sockaddr sa -> NSData *dsa = [NSData dataWithBytes:&remoteAddr length:remoteAddr.sa_len];
struct sockaddr *sa -> NSData *dsa = [NSData dataWithBytes:remoteAddr length:remoteAddr->sa_len];
复制代码
|
立即断开，任何未处理的读或写都将被丢弃
如果 socket还没有断开，在这个方法返回之前，onSocketDidDisconnect 委托方法将会被立即调用
注意推荐释放AsyncSocket实例的方式：
[asyncSocket setDelegate:nil];
[asyncSocket disconnect];
[asyncSocket release];
复制代码
|
在已经完成了所有悬而未决的读取时 断开,在调用之后，读取和写入方法将无用,socket将断开 即使仍有写入的东西
复制代码
|
返回本地和远程主机和端口给连接的 socket，如果没有连接会返回nil或0,主机将会是一个IP地址
复制代码
|
返回本地和远程的地址给连接的 socket，指定一个socketaddr结构包裹在一个NSData对象
readData和writeData方法不会是block(它们是异步的)
当读完成 onSocket:didReadData:withTag: 委托方法时调用
当写完成 onSocket:didWriteDataWithTag: 委托方法时调用
可以选择任何读/写操作的超时设置(为了不超时，使用负时间间隔。）
如果读/写操作超时，相应的 onSocket:shouldTimeout...委托方法被调用去选择性地允许我们去延长超时
超时后，onSocket:willDisconnectWithError: 方法被调用,紧接着是 onSocketDidDisconnect
tag是为了方便，可以使用它作为数组的索引、步数、state id 、指针等
复制代码
|
读取 socket上第一次成为可用的字节,如果timeout值是负数的，读操作将不使用timeout
复制代码
|
读取 socket上第一次成为可用的字节
字节将被追加到给定的字节缓冲区，从给定的偏移量开始
如果需要，给定的缓冲区大小将会自动增加
如果timeout值是负数的，读操作将不使用timeout
如果缓冲区为空， socket会为我们创建一个缓冲区
如果bufferOffset是大于给定的缓冲区的长度，该方法将无用，委托将不会被调用
如果你传递一个缓冲区，当AsyncSocket在使用它的时候你不能以任何方式改变它
完成之后，onSocket:didReadData:withTag 返回的数据将是一个给定的缓冲区的子集
也就是说，它将会被引用到被追加的给定的缓冲区的字节
复制代码
|
读取给定的字节数，如果length为0，方法将无用，委托将不会被调用
复制代码
|
读取给定的字节数,在给定的偏移开始，字节将被追加到给定的字节缓冲区
复制代码
|
读取字节直到(包括)传入的作为分隔的"data"参数
如果传递0或者0长度的数据，"data"参数，该方法将无用，委托将不会被调用
从 socket读取一行，使用"data"参数作为行的分隔符 (如HTTP的CRLF)
注意，此方法不是字符集，因此，如果一个分隔符出现，它自然可以作为进行编码的一部分，读取将提前结束
复制代码
|
读取字节直到(包括)传入的作为分隔的“data”参数，在给定的偏移量开始，字节将被追加到给定的字节缓冲区。
从 socket读取一行，使用"data"参数作为行的分隔符(如HTTP的CRLF)
复制代码
|
将data写入 socket，当完成的时候委托被调用
复制代码
|
返回当前读或写的进度，从0.0 到 1.0 或者 如果没有读/写的时候返回Nan(使用isNan来检查)
tag、done、total如果不为空的话，它们将会被填补
复制代码
|
确保使用ssl/tls连接
这方法可被随时调用，tls握手将会发生在所有悬而未决的读/写完成之后。这紧跟着一个发送依赖 StartTLS消息的协议选项，在排队升级到TLS的同一时间，而不必等待写入完成。在这个方法被调用后,任何读写计划 将会发生在安全链接
对于可能的keys和TLS设置的值是有据可查的
一些可能的keys是:
* - kCFStreamSSLLevel
* - kCFStreamSSLAllowsExpiredCertificates
* - kCFStreamSSLAllowsExpiredRoots
* - kCFStreamSSLAllowsAnyRoot
* - kCFStreamSSLValidatesCertificateChain
* - kCFStreamSSLPeerName
* - kCFStreamSSLCertificates
* - kCFStreamSSLIsServer
如果你传递空或者空字典，将使用默认的字典
默认设置将检查以确保由签署可信的第三方证书机构和没有过期的远程连接的证书
然而，它不会验证证书上的名字，除非你给它一个名字，通过kCFStreamSSLPeerName键去验证
这对安全的影响是重要的理解
想象一下你正试图创建一个到MySecureServer.com的安全连接，但因为一个被攻击的DNS服务器，所以你的 socket被定向到MaliciousServer.com
如果你只是使用默认设置，MaliciousServer.com 有一个有效的证书
默认设置将无法监测到任何问题，因为证书是有效的
在这个特殊的情况下，要妥善保护你的连接，应设置kCFStreamSSLPeerName性质为MySecureServer.com.
如果事前你不知道对等的名字的远程主机(例如，你不确认它是domain.com" or "www.domain.com")，那么你可以使用默认设置来验证证书，然后在获得验证的发行后使用X509Certificate类来验证,X509Certificate类的CocoaAsyncSocket开源项目的一部分
复制代码
|
对于处理readDataToData请求，数据是必须从 socket以小增量的方式读取出来的
性能通过允许AsyncSocket去一次性读大块的数据和存储任何一个小的内部缓冲区溢出的东西来大大提高
这被称为预缓冲，就好像一些数据在你要求它之前就可能被读取出来
如果你经常使用readDataToData，使用预缓冲会有更好的性能，尤其是在iphone上
默认的预缓冲状态是由DEFAULT_PREBUFFERING 定义控制的，强烈建议设置其为yes
这方法存在一些预缓冲需要一些不可预见的原因被默认禁用的情况，这时，这种方法存在允许当就绪时，可轻松启用预缓冲
复制代码
|
当你创建一个AsyncSocket，它被添加到当前线程runloop
对于手动创建的 socket，在线程上你打算使用它，它是最容易简单的创建的线程上的 socket
当一个新的 socket被接受，委托方法 onSocket:wantsRunLoopForNewSocket 会被调用 允许你在一个单独的线程上放置 socket，这个工作最好结合在同一个线程池设计
如果，但是，在一个单独的线程上，在之后的时间，你需要移动一个 socket，这个方法可以用来完成任务
此方法必须从 当前运行的 线程/runloop 的 socket 调用
注意：此方法调用后，所有进一步的方法应该从给定的runloop上调用这个对象
此外，所有委托调用将会发送到给定的runloop
复制代码
|
允许你配置 socket 使用的 运行循环模式
运行循环模式设置默认是NSRunLoopCommonModes
如果你想你的 socket 在其他模式下继续操作，你可能需要添加模式 NSModalPanelRunLoopMode 或者 NSEventTrackingRunLoopMode ,或者你可能只想使用 NSRunLoopCommonModes
可接受的 socket将自动 继承相同的运行循环模式就像侦听 socket
注意：NSRunLoopCommonModes 定义在10.5，对于之前的版本可使用 kCFRunLoopCommonModes
复制代码
|
返回当前正在运行的循环模式的AsyncSocket实例， run loop modes的默认设置是NSDefaultRunLoopMode
复制代码
|
一个错误的事件，在 onSocket:willDisconnectWithError: 将会被调用 去读取留在 socket上的任何数据
复制代码
|
一些常见的分隔符，为了去使用 readDataToData:.. 方法