深入解析 PocketSocket用 Objective-C 打造符合 RFC6455 的 WebSocket 客户端与服务端【免费下载链接】hammerspoonStaggeringly powerful macOS desktop automation with Lua项目地址: https://gitcode.com/gh_mirrors/ha/hammerspoon导读PocketSocket 是一个用 Objective-C 编写、面向 iOS 与 macOS 的 WebSocket 库目标是让开发者用原生的 NSStream / CFSocket 技术栈构建实时通信应用。本篇文章围绕仓库内 Pods/PocketSocket/README.md 展开完整讲解它的核心特性、三大组件PSWebSocketDriver、PSWebSocket、PSWebSocketServer、客户端与服务端实战用法、permessage-deflate 压缩扩展的实现原理以及它作为 Hammerspoon 项目依赖被集成的方式。读完本文你将掌握在 iOS/OS X 应用中以纯 Objective-C 代码完成 WebSocket 握手、收发消息、关闭连接和自定义 TLS 证书校验的完整方案并理解这套“网络层与协议层解耦”的架构为什么比传统单文件实现更容易扩展。项目概览PocketSocket 是什么PocketSocket 由 Zwopple Limited 开发作者为 Robert Payne是一个完全遵循 RFC6455 规范的 Objective-C WebSocket 库。它的设计目标非常明确在 iOS 和 OS X 上用系统自带的网络基础设施CFNetwork、Foundation、Security、libz构建一个同时覆盖客户端与服务端、并且支持压缩扩展的实时通信工具箱。在 Hammerspoon 仓库中PocketSocket 通过 CocoaPods 以pod PocketSocket/Client, 1.0.1的形式被引入见 Podfile并且和 SocketRocket、CocoaAsyncSocket 等一起为 Hammerspoon 的自动化能力提供底层网络支持。也就是说这篇文档所讲解的组件实际已经作为依赖被打包进了这个桌面自动化工具的实时通信链路中。核心特性根据 README 的原始描述PocketSocket 具备以下能力完全符合 RFC6455 WebSocket 协议从握手到帧解析都遵循规范支持 permessage-deflate 压缩扩展对应 RFC 7692 草案可以在单个消息级别压缩 payload通过 Autobahn 测试套件约 519 个客户端与服务端用例声明 100% 合规其中少量服务端测试因收到畸形 payload 会提前断连属于非严格模式下的正常表现同时提供客户端与服务端两种模式TLS/SSL 支持客户端可自动协商证书链也支持自定义证书校验与证书锁定异步 IO基于 NSInputStream / NSOutputStream 与 CFSocket 的非阻塞读写提供独立的PSWebSocketDriver让开发者可以“自带网络 IO”把协议处理嵌入任何现有的 IO 架构中。依赖框架库的运行依赖以下系统框架见 README 的 Dependencies 一节CFNetwork.framework —— 服务端 CFSocket、CFStream 等底层网络设施Foundation.framework —— NSURLRequest、NSStream 等基础类型Security.framework —— TLS/SSL 证书校验SecTrustReflibSystem.dylib —— 系统 C 运行时与 socket 接口libz.dylib —— zlib 压缩供 permessage-deflate 的 deflate/inflate 使用。三大组件架构协议与网络彻底解耦PocketSocket 最核心的架构思想是把“协议处理”和“网络 IO”分离成两个独立的层。README 明确列出了三个主要组件组件定位职责PSWebSocketDriver无网络依赖的协议引擎把原始字节解析成事件把发送事件编码成原始字节负责握手请求/响应的生成与校验PSWebSocket网络化 Socket 封装基于 NSInputStream / NSOutputStream 维持连接内部通过 Driver 处理输入输出PSWebSocketServer基于 CFSocket 的服务器绑定地址与端口接受连接每个入站请求创建一个 PSWebSocket 实例这种分层设计带来的直接好处是如果你已经有了一套自有的网络栈比如自定义的异步 socket 层、或者要嵌进游戏引擎可以不使用PSWebSocket直接把PSWebSocketDriver接在自己的 IO 上——README 称之为 “Bring your own networking IO”。从源码看PSWebSocket内部确实持有PSWebSocketDriver *_driver、PSWebSocketBuffer *_inputBuffer、_outputBuffer以及输入输出流见 PSWebSocket.m它只是负责把流上读到的字节喂给 Driver、把 Driver 写出的字节交给输出流业务逻辑全部收敛在 Driver 层。PSWebSocketDriver协议引擎的源码级解析PSWebSocketDriver是整套库的心脏。根据 PSWebSocketDriver.h 和 PSWebSocketDriver.m它处理以下完整生命周期握手请求/响应client 模式写出 GET Upgrade 头server 模式校验并写出响应把消息打包成 WebSocket 帧含 FIN/RSV/opcode/mask/payload 各字段写往对端把收到的帧逐字节解析并还原成消息通过内部状态机在PSWebSocketDriverStateHandshakeRequest / HandshakeResponse / FrameHeader / FrameHeaderExtra / FramePayload之间迁移见 PSWebSocketDriver.m。创建 Driver客户端与服务端两个工厂方法 (instancetype)clientDriverWithRequest:(NSURLRequest *)request; (instancetype)serverDriverWithRequest:(NSURLRequest *)request;客户端模式传入一个NSURLRequeststart后 Driver 会把它作为握手请求发出源码中start在 client 模式调用writeHandshakeRequest见 PSWebSocketDriver.m服务端模式传入对端发来的握手NSURLRequestDriver 负责校验请求头如 Upgrade、Sec-WebSocket-Key 等并生成规范的握手响应。两种模式共享完全一致的 API这正是 README 强调的“identical API for each mode”。Driver 的对外动作 APIDriver 暴露了极简的操作接口- (void)start; - (void)sendText:(NSString *)text; - (void)sendBinary:(NSData *)binary; - (void)sendCloseCode:(NSInteger)code reason:(NSString *)reason; - (void)sendPing:(NSData *)data; - (void)sendPong:(NSData *)data; - (NSUInteger)execute:(void *)bytes maxLength:(NSUInteger)maxLength;其中execute:maxLength:是网络层喂入原始字节的入口每收到一段字节就调用一次Driver 内部返回本次消费的字节数。同时通过PSWebSocketDriverDelegate的driver:write:回调把需要发出的字节交还给调用方。这个双向字节通道就是“自带网络 IO”的全部接口。消息类型与状态码与协议相关的枚举定义在 PSWebSocketTypes.h错误码PSWebSocketErrorCodesUnknown、TimedOut、HandshakeFailed、ConnectionFailed关闭状态码PSWebSocketStatusCodeNormal 1000、GoingAway 1001、ProtocolError 1002、UnhandledType 1003、NoStatusReceived 1005、InvalidUTF8 1007、PolicyViolated 1008、MessageTooBig 1009常量PSWebSocketGUID258EAFA5-E914-47DA-95CA-C5AB0DC85B11是 RFC6455 规定的 Sec-WebSocket-Accept 计算密钥PSWebSocketErrorDomain是统一错误域。另外握手失败产生的NSError会在 userInfo 中携带PSHTTPStatusErrorKeyHTTP 状态码和PSHTTPResponseErrorKey完整的 CFHTTPMessageRef 响应方便服务端排查 404 之类的握手拒绝原因。客户端实战PSWebSocket 的使用README 给出了一个完整的 iOS AppDelegate 示例。客户端支持ws://与wss://两种协议核心流程分三步创建请求 → 创建 socket → open。#import PSWebSocket/PSWebSocket.h interface AppDelegate() PSWebSocketDelegate property (nonatomic, strong) PSWebSocket *socket; end implementation AppDelegate - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { self.window [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]]; self.window.backgroundColor [UIColor whiteColor]; [self.window makeKeyAndVisible]; // create the NSURLRequest that will be sent as the handshake NSURLRequest *request [NSURLRequest requestWithURL:[NSURL URLWithString:wss://example.com]]; // create the socket and assign delegate self.socket [PSWebSocket clientSocketWithRequest:request]; self.socket.delegate self; // open socket [self.socket open]; return YES; } #pragma mark - PSWebSocketDelegate - (void)webSocketDidOpen:(PSWebSocket *)webSocket { NSLog(The websocket handshake completed and is now open!); [webSocket send:Hello world!]; } - (void)webSocket:(PSWebSocket *)webSocket didReceiveMessage:(id)message { NSLog(The websocket received a message: %, message); } - (void)webSocket:(PSWebSocket *)webSocket didFailWithError:(NSError *)error { NSLog(The websocket handshake/connection failed with an error: %, error); } - (void)webSocket:(PSWebSocket *)webSocket didCloseWithCode:(NSInteger)code reason:(NSString *)reason wasClean:(BOOL)wasClean { NSLog(The websocket closed with code: %, reason: %, wasClean: %, (code), reason, (wasClean) ? YES : NO); } end客户端行为细节README 对客户端行为做了三点补充这些细节直接决定了生产环境的可靠性自动证书协商wss连接默认会从设备上的证书链自动协商证书需要自定义 SSL 证书或做证书锁定pinning时实现PSWebSocketDelegate的可选方法webSocket:evaluateServerTrust:即可见 PSWebSocket.h。源码中在 TLS 握手完成后会取出kCFStreamPropertySSLPeerTrust对应的SecTrustRef先走系统默认评估若 delegate 实现了该方法则把决策权交给 delegate见 PSWebSocket.m。默认请求压缩客户端发出的握手请求总会携带 permessage-deflate 扩展声明若服务端接受整个连接期间所有消息都启用压缩。超时语义若初始NSURLRequest设置了大于 0 的 timeoutInterval则连接在该时间内未能建立就会被判定超时失败对应错误码PSWebSocketErrorCodeTimedOut若未设置连接可能因系统行为一直等待。PSWebSocket 完整 API 一览结合 PSWebSocket.h客户端可用能力还包括readyState只读反映Connecting(0) / Open(1) / Closing(2) / Closed(3)四态delegateQueuedelegate 回调所在的 dispatch queueinputPaused / outputPaused暂停/恢复输入输出流配合webSocketDidFlushInput:与webSocketDidFlushOutput:可选回调可实现背压控制send:发送消息接受 NSString 或 NSData 实例ping:handler:发送 Ping 帧并注册收到对应 Pong 时的回调close/closeWithCode:reason:默认以 1000 关闭也可指定关闭码与原因serverSocketWithRequest:inputStream:outputStream:服务端模式初始化直接接管两条已打开的流copyStreamPropertyForKey:/setStreamProperty:forKey:读写底层流的属性如 kCFStreamProperty 常量用于在打开前配置 TLS 等打开后再调用 setter 会抛异常remoteAddress/remoteHost读取对端地址与主机名见 PSWebSocket.m。服务端实战PSWebSocketServer服务端目前只支持ws://协议。它绑定到指定的 host 与端口接受入站连接解析每个连接中的首个 HTTP 请求然后通过 delegate 询问是否接受并完成 WebSocket 握手。README 特别提醒Server 必须是它创建的每个 PSWebSocket 实例的 delegate不要自己接管或把这些 socket 从 Server 上摘除否则会破坏内部状态管理。完整示例#import PSWebSocket/PSWebSocketServer.h interface AppDelegate() PSWebSocketServerDelegate property (nonatomic, strong) PSWebSocketServer *server; end implementation AppDelegate - (void)applicationDidFinishLaunching:(NSNotification *)notification { _server [PSWebSocketServer serverWithHost:nil port:9001]; _server.delegate self; [_server start]; } #pragma mark - PSWebSocketServerDelegate - (void)serverDidStart:(PSWebSocketServer *)server { NSLog(Server did start…); } - (void)serverDidStop:(PSWebSocketServer *)server { NSLog(Server did stop…); } - (BOOL)server:(PSWebSocketServer *)server acceptWebSocketWithRequest:(NSURLRequest *)request { NSLog(Server should accept request: %, request); return YES; } - (void)server:(PSWebSocketServer *)server webSocket:(PSWebSocket *)webSocket didReceiveMessage:(id)message { NSLog(Server websocket did receive message: %, message); } - (void)server:(PSWebSocketServer *)server webSocketDidOpen:(PSWebSocket *)webSocket { NSLog(Server websocket did open); } - (void)server:(PSWebSocketServer *)server webSocket:(PSWebSocket *)webSocket didCloseWithCode:(NSInteger)code reason:(NSString *)reason wasClean:(BOOL)wasClean { NSLog(Server websocket did close with code: %, reason: %, wasClean: %, (code), reason, (wasClean)); } - (void)server:(PSWebSocketServer *)server webSocket:(PSWebSocket *)webSocket didFailWithError:(NSError *)error { NSLog(Server websocket did fail with error: %, error); } end要点拆解serverWithHost:nil port:9001host 传 nil 表示绑定到本机所有可用地址端口 9001 为监听端口acceptWebSocketWithRequest:是接入控制点返回 YES 才完成握手可以在这一层做鉴权、路径白名单等策略连接生命周期事件open / message / close / fail通过 delegate 回调暴露和客户端侧的回调语义一一对应。permessage-deflate消息级压缩的实现内幕这是 PocketSocket 相对大多数早期 Objective-C WebSocket 库的最大差异化能力。源码中PSWebSocketDeflater与PSWebSocketInflater分别封装 zlib 的 deflate / inflate并挂在 PSWebSocketDriver.m 的_deflater/_inflater上。关键实现细节从源码可以确认Driver 默认启用压缩_pmdEnabled YES客户端与服务端的滑动窗口位数初始值均为-11对应 2KB 窗口见 PSWebSocketDriver.m发送时对非控制帧且 payload 非空的消息先执行 deflate并根据是否协商了no_context_takeover决定是否在每条消息前重置压缩上下文见 PSWebSocketDriver.m接收时只有rsv1位被置位且压缩已启用的帧才做 inflate若压缩未协商却出现 rsv1 数据帧会直接以PSWebSocketStatusCodeProtocolError拒绝见 PSWebSocketDriver.m握手阶段若 permessage-deflate 扩展参数协商失败参数非法会以PSWebSocketErrorCodeHandshakeFailed失败并注明原因相关错误字符串为 “invalid permessage-deflate extension parameters”见 PSWebSocketDriver.m。对开发者而言使用该特性是零成本的客户端默认在握手时声明支持压缩只要服务端无论是否 PocketSocket 实现在响应中确认该扩展整条连接就自动启用无需额外的 API 调用。安装、测试与运行通过 CocoaPods 安装README 推荐的安装方式是 CocoaPods。在 Podfile 中加入依赖并执行安装pod PocketSocket pod installHammerspoon 项目实际使用的是子系统化写法pod PocketSocket/Client, 1.0.1见 Podfile对应 Podfile.lock 中的PocketSocket/ClientPocketSocket/Core两个子模块。仓库内 PocketSocket 相关源码位于 Pods/PocketSocket/PocketSocket/共包含PSWebSocket.m、PSWebSocketDriver.m、PSWebSocketBuffer.m、PSWebSocketDeflater.m、PSWebSocketInflater.m、PSWebSocketNetworkThread.m、PSWebSocketUTF8Decoder.m以及各自的头文件。运行 Autobahn 测试Autobahn Test Suite 是 WebSocket 实现的行业标准合规测试。README 给出的步骤安装测试套件sudo pip install autobahntestsuite启动 Autobahn 模糊测试服务端wstest -m fuzzingserver在 Xcode 中运行测试用例由于 README 声明通过了约 519 个客户端与服务端测试用例其中部分服务端测试为非严格模式遇到畸形 payload 会提前断开这套测试流程正是验证协议合规性的标准做法。为什么重写一个库与 SocketRocket 的对比README 的 “Why a new library?” 一节解释了 PocketSocket 的诞生动机。当时 Objective-C 生态中 WebSocket 客户端选择有限最知名的 SocketRocket 存在两个痛点全部代码收敛在单个文件中难以在此基础上新增 permessage-deflate、连接超时等特性网络层与协议层耦合过深无法灵活适配已有工程。PocketSocket 的对策是三管齐下提供丰富且易于深入修改的工具集——把网络层与 Driver 层解耦方便把库嵌进任何现有架构持续跟进协议演进——README 承诺只要主流 WebSocket 扩展草案开始稳定就会第一时间纳入permessage-deflate 正是这一理念的产物客户端到服务端的完整图景——在一个解耦的工具包内同时覆盖 iOS 与 OS X 上的全部使用场景。值得注意的是Hammerspoon 的 Podfile 同时引入了 PocketSocket 和 SocketRocket前者用于PocketSocket/Client子模块后者则被 extensions/websocket/libwebsocket.m 的hs.websocketLua 扩展使用#import SocketRocket/SRWebSocket.h。这说明两者定位不同SocketRocket 作为 hs.websocket 模块的客户端实现PocketSocket 则服务于其他依赖方——从仓库证据看PocketSocket 在此仓库中仅以 CocoaPods 依赖形式存在源码实体位于 Pods/PocketSocket/并未被 Hammerspoon 自身代码直接引用。许可证与作者PocketSocket 采用 Apache License 2.0 授权见 Pods/PocketSocket/LICENSECopyright 2014-Present Zwopple Limited。作者为 Robert Payne贡献者包括 Jens AlfkeCouchbase Lite 与 MacRuby 的作者主要贡献了 TLS 相关的webSocket:evaluateServerTrust:支持。Apache 2.0 允许自由使用、修改与再分发只需保留版权声明与许可证文本这使它非常适合嵌入商业应用。结语从 README 的完整论述到 PSWebSocketDriver.m 的状态机实现PocketSocket 展示了“协议内核与网络 IO 解耦”这一架构思想在 WebSocket 场景下的实践价值客户端、服务端与可插拔 Driver 三位一体permessage-deflate 默认启用TLS 证书可自定义校验Autobahn 全量合规——这些能力让它成为 iOS/OS X 原生实时通信场景中一个值得深入研究的参考实现。如果你正在评估或维护 Objective-C 代码库中的 WebSocket 方案可以从 PSWebSocket.h 与 PSWebSocketTypes.h 入手沿着 Driver 的状态机逐层阅读很快就能建立对 RFC6455 各帧类型与握手流程的完整认知。【免费下载链接】hammerspoonStaggeringly powerful macOS desktop automation with Lua项目地址: https://gitcode.com/gh_mirrors/ha/hammerspoon创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
深入解析 PocketSocket：用 Objective-C 打造符合 RFC6455 的 WebSocket 客户端与服务端
深入解析 PocketSocket用 Objective-C 打造符合 RFC6455 的 WebSocket 客户端与服务端【免费下载链接】hammerspoonStaggeringly powerful macOS desktop automation with Lua项目地址: https://gitcode.com/gh_mirrors/ha/hammerspoon导读PocketSocket 是一个用 Objective-C 编写、面向 iOS 与 macOS 的 WebSocket 库目标是让开发者用原生的 NSStream / CFSocket 技术栈构建实时通信应用。本篇文章围绕仓库内 Pods/PocketSocket/README.md 展开完整讲解它的核心特性、三大组件PSWebSocketDriver、PSWebSocket、PSWebSocketServer、客户端与服务端实战用法、permessage-deflate 压缩扩展的实现原理以及它作为 Hammerspoon 项目依赖被集成的方式。读完本文你将掌握在 iOS/OS X 应用中以纯 Objective-C 代码完成 WebSocket 握手、收发消息、关闭连接和自定义 TLS 证书校验的完整方案并理解这套“网络层与协议层解耦”的架构为什么比传统单文件实现更容易扩展。项目概览PocketSocket 是什么PocketSocket 由 Zwopple Limited 开发作者为 Robert Payne是一个完全遵循 RFC6455 规范的 Objective-C WebSocket 库。它的设计目标非常明确在 iOS 和 OS X 上用系统自带的网络基础设施CFNetwork、Foundation、Security、libz构建一个同时覆盖客户端与服务端、并且支持压缩扩展的实时通信工具箱。在 Hammerspoon 仓库中PocketSocket 通过 CocoaPods 以pod PocketSocket/Client, 1.0.1的形式被引入见 Podfile并且和 SocketRocket、CocoaAsyncSocket 等一起为 Hammerspoon 的自动化能力提供底层网络支持。也就是说这篇文档所讲解的组件实际已经作为依赖被打包进了这个桌面自动化工具的实时通信链路中。核心特性根据 README 的原始描述PocketSocket 具备以下能力完全符合 RFC6455 WebSocket 协议从握手到帧解析都遵循规范支持 permessage-deflate 压缩扩展对应 RFC 7692 草案可以在单个消息级别压缩 payload通过 Autobahn 测试套件约 519 个客户端与服务端用例声明 100% 合规其中少量服务端测试因收到畸形 payload 会提前断连属于非严格模式下的正常表现同时提供客户端与服务端两种模式TLS/SSL 支持客户端可自动协商证书链也支持自定义证书校验与证书锁定异步 IO基于 NSInputStream / NSOutputStream 与 CFSocket 的非阻塞读写提供独立的PSWebSocketDriver让开发者可以“自带网络 IO”把协议处理嵌入任何现有的 IO 架构中。依赖框架库的运行依赖以下系统框架见 README 的 Dependencies 一节CFNetwork.framework —— 服务端 CFSocket、CFStream 等底层网络设施Foundation.framework —— NSURLRequest、NSStream 等基础类型Security.framework —— TLS/SSL 证书校验SecTrustReflibSystem.dylib —— 系统 C 运行时与 socket 接口libz.dylib —— zlib 压缩供 permessage-deflate 的 deflate/inflate 使用。三大组件架构协议与网络彻底解耦PocketSocket 最核心的架构思想是把“协议处理”和“网络 IO”分离成两个独立的层。README 明确列出了三个主要组件组件定位职责PSWebSocketDriver无网络依赖的协议引擎把原始字节解析成事件把发送事件编码成原始字节负责握手请求/响应的生成与校验PSWebSocket网络化 Socket 封装基于 NSInputStream / NSOutputStream 维持连接内部通过 Driver 处理输入输出PSWebSocketServer基于 CFSocket 的服务器绑定地址与端口接受连接每个入站请求创建一个 PSWebSocket 实例这种分层设计带来的直接好处是如果你已经有了一套自有的网络栈比如自定义的异步 socket 层、或者要嵌进游戏引擎可以不使用PSWebSocket直接把PSWebSocketDriver接在自己的 IO 上——README 称之为 “Bring your own networking IO”。从源码看PSWebSocket内部确实持有PSWebSocketDriver *_driver、PSWebSocketBuffer *_inputBuffer、_outputBuffer以及输入输出流见 PSWebSocket.m它只是负责把流上读到的字节喂给 Driver、把 Driver 写出的字节交给输出流业务逻辑全部收敛在 Driver 层。PSWebSocketDriver协议引擎的源码级解析PSWebSocketDriver是整套库的心脏。根据 PSWebSocketDriver.h 和 PSWebSocketDriver.m它处理以下完整生命周期握手请求/响应client 模式写出 GET Upgrade 头server 模式校验并写出响应把消息打包成 WebSocket 帧含 FIN/RSV/opcode/mask/payload 各字段写往对端把收到的帧逐字节解析并还原成消息通过内部状态机在PSWebSocketDriverStateHandshakeRequest / HandshakeResponse / FrameHeader / FrameHeaderExtra / FramePayload之间迁移见 PSWebSocketDriver.m。创建 Driver客户端与服务端两个工厂方法 (instancetype)clientDriverWithRequest:(NSURLRequest *)request; (instancetype)serverDriverWithRequest:(NSURLRequest *)request;客户端模式传入一个NSURLRequeststart后 Driver 会把它作为握手请求发出源码中start在 client 模式调用writeHandshakeRequest见 PSWebSocketDriver.m服务端模式传入对端发来的握手NSURLRequestDriver 负责校验请求头如 Upgrade、Sec-WebSocket-Key 等并生成规范的握手响应。两种模式共享完全一致的 API这正是 README 强调的“identical API for each mode”。Driver 的对外动作 APIDriver 暴露了极简的操作接口- (void)start; - (void)sendText:(NSString *)text; - (void)sendBinary:(NSData *)binary; - (void)sendCloseCode:(NSInteger)code reason:(NSString *)reason; - (void)sendPing:(NSData *)data; - (void)sendPong:(NSData *)data; - (NSUInteger)execute:(void *)bytes maxLength:(NSUInteger)maxLength;其中execute:maxLength:是网络层喂入原始字节的入口每收到一段字节就调用一次Driver 内部返回本次消费的字节数。同时通过PSWebSocketDriverDelegate的driver:write:回调把需要发出的字节交还给调用方。这个双向字节通道就是“自带网络 IO”的全部接口。消息类型与状态码与协议相关的枚举定义在 PSWebSocketTypes.h错误码PSWebSocketErrorCodesUnknown、TimedOut、HandshakeFailed、ConnectionFailed关闭状态码PSWebSocketStatusCodeNormal 1000、GoingAway 1001、ProtocolError 1002、UnhandledType 1003、NoStatusReceived 1005、InvalidUTF8 1007、PolicyViolated 1008、MessageTooBig 1009常量PSWebSocketGUID258EAFA5-E914-47DA-95CA-C5AB0DC85B11是 RFC6455 规定的 Sec-WebSocket-Accept 计算密钥PSWebSocketErrorDomain是统一错误域。另外握手失败产生的NSError会在 userInfo 中携带PSHTTPStatusErrorKeyHTTP 状态码和PSHTTPResponseErrorKey完整的 CFHTTPMessageRef 响应方便服务端排查 404 之类的握手拒绝原因。客户端实战PSWebSocket 的使用README 给出了一个完整的 iOS AppDelegate 示例。客户端支持ws://与wss://两种协议核心流程分三步创建请求 → 创建 socket → open。#import PSWebSocket/PSWebSocket.h interface AppDelegate() PSWebSocketDelegate property (nonatomic, strong) PSWebSocket *socket; end implementation AppDelegate - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { self.window [[UIWindow alloc] initWithFrame:[[UIScreen mainScreen] bounds]]; self.window.backgroundColor [UIColor whiteColor]; [self.window makeKeyAndVisible]; // create the NSURLRequest that will be sent as the handshake NSURLRequest *request [NSURLRequest requestWithURL:[NSURL URLWithString:wss://example.com]]; // create the socket and assign delegate self.socket [PSWebSocket clientSocketWithRequest:request]; self.socket.delegate self; // open socket [self.socket open]; return YES; } #pragma mark - PSWebSocketDelegate - (void)webSocketDidOpen:(PSWebSocket *)webSocket { NSLog(The websocket handshake completed and is now open!); [webSocket send:Hello world!]; } - (void)webSocket:(PSWebSocket *)webSocket didReceiveMessage:(id)message { NSLog(The websocket received a message: %, message); } - (void)webSocket:(PSWebSocket *)webSocket didFailWithError:(NSError *)error { NSLog(The websocket handshake/connection failed with an error: %, error); } - (void)webSocket:(PSWebSocket *)webSocket didCloseWithCode:(NSInteger)code reason:(NSString *)reason wasClean:(BOOL)wasClean { NSLog(The websocket closed with code: %, reason: %, wasClean: %, (code), reason, (wasClean) ? YES : NO); } end客户端行为细节README 对客户端行为做了三点补充这些细节直接决定了生产环境的可靠性自动证书协商wss连接默认会从设备上的证书链自动协商证书需要自定义 SSL 证书或做证书锁定pinning时实现PSWebSocketDelegate的可选方法webSocket:evaluateServerTrust:即可见 PSWebSocket.h。源码中在 TLS 握手完成后会取出kCFStreamPropertySSLPeerTrust对应的SecTrustRef先走系统默认评估若 delegate 实现了该方法则把决策权交给 delegate见 PSWebSocket.m。默认请求压缩客户端发出的握手请求总会携带 permessage-deflate 扩展声明若服务端接受整个连接期间所有消息都启用压缩。超时语义若初始NSURLRequest设置了大于 0 的 timeoutInterval则连接在该时间内未能建立就会被判定超时失败对应错误码PSWebSocketErrorCodeTimedOut若未设置连接可能因系统行为一直等待。PSWebSocket 完整 API 一览结合 PSWebSocket.h客户端可用能力还包括readyState只读反映Connecting(0) / Open(1) / Closing(2) / Closed(3)四态delegateQueuedelegate 回调所在的 dispatch queueinputPaused / outputPaused暂停/恢复输入输出流配合webSocketDidFlushInput:与webSocketDidFlushOutput:可选回调可实现背压控制send:发送消息接受 NSString 或 NSData 实例ping:handler:发送 Ping 帧并注册收到对应 Pong 时的回调close/closeWithCode:reason:默认以 1000 关闭也可指定关闭码与原因serverSocketWithRequest:inputStream:outputStream:服务端模式初始化直接接管两条已打开的流copyStreamPropertyForKey:/setStreamProperty:forKey:读写底层流的属性如 kCFStreamProperty 常量用于在打开前配置 TLS 等打开后再调用 setter 会抛异常remoteAddress/remoteHost读取对端地址与主机名见 PSWebSocket.m。服务端实战PSWebSocketServer服务端目前只支持ws://协议。它绑定到指定的 host 与端口接受入站连接解析每个连接中的首个 HTTP 请求然后通过 delegate 询问是否接受并完成 WebSocket 握手。README 特别提醒Server 必须是它创建的每个 PSWebSocket 实例的 delegate不要自己接管或把这些 socket 从 Server 上摘除否则会破坏内部状态管理。完整示例#import PSWebSocket/PSWebSocketServer.h interface AppDelegate() PSWebSocketServerDelegate property (nonatomic, strong) PSWebSocketServer *server; end implementation AppDelegate - (void)applicationDidFinishLaunching:(NSNotification *)notification { _server [PSWebSocketServer serverWithHost:nil port:9001]; _server.delegate self; [_server start]; } #pragma mark - PSWebSocketServerDelegate - (void)serverDidStart:(PSWebSocketServer *)server { NSLog(Server did start…); } - (void)serverDidStop:(PSWebSocketServer *)server { NSLog(Server did stop…); } - (BOOL)server:(PSWebSocketServer *)server acceptWebSocketWithRequest:(NSURLRequest *)request { NSLog(Server should accept request: %, request); return YES; } - (void)server:(PSWebSocketServer *)server webSocket:(PSWebSocket *)webSocket didReceiveMessage:(id)message { NSLog(Server websocket did receive message: %, message); } - (void)server:(PSWebSocketServer *)server webSocketDidOpen:(PSWebSocket *)webSocket { NSLog(Server websocket did open); } - (void)server:(PSWebSocketServer *)server webSocket:(PSWebSocket *)webSocket didCloseWithCode:(NSInteger)code reason:(NSString *)reason wasClean:(BOOL)wasClean { NSLog(Server websocket did close with code: %, reason: %, wasClean: %, (code), reason, (wasClean)); } - (void)server:(PSWebSocketServer *)server webSocket:(PSWebSocket *)webSocket didFailWithError:(NSError *)error { NSLog(Server websocket did fail with error: %, error); } end要点拆解serverWithHost:nil port:9001host 传 nil 表示绑定到本机所有可用地址端口 9001 为监听端口acceptWebSocketWithRequest:是接入控制点返回 YES 才完成握手可以在这一层做鉴权、路径白名单等策略连接生命周期事件open / message / close / fail通过 delegate 回调暴露和客户端侧的回调语义一一对应。permessage-deflate消息级压缩的实现内幕这是 PocketSocket 相对大多数早期 Objective-C WebSocket 库的最大差异化能力。源码中PSWebSocketDeflater与PSWebSocketInflater分别封装 zlib 的 deflate / inflate并挂在 PSWebSocketDriver.m 的_deflater/_inflater上。关键实现细节从源码可以确认Driver 默认启用压缩_pmdEnabled YES客户端与服务端的滑动窗口位数初始值均为-11对应 2KB 窗口见 PSWebSocketDriver.m发送时对非控制帧且 payload 非空的消息先执行 deflate并根据是否协商了no_context_takeover决定是否在每条消息前重置压缩上下文见 PSWebSocketDriver.m接收时只有rsv1位被置位且压缩已启用的帧才做 inflate若压缩未协商却出现 rsv1 数据帧会直接以PSWebSocketStatusCodeProtocolError拒绝见 PSWebSocketDriver.m握手阶段若 permessage-deflate 扩展参数协商失败参数非法会以PSWebSocketErrorCodeHandshakeFailed失败并注明原因相关错误字符串为 “invalid permessage-deflate extension parameters”见 PSWebSocketDriver.m。对开发者而言使用该特性是零成本的客户端默认在握手时声明支持压缩只要服务端无论是否 PocketSocket 实现在响应中确认该扩展整条连接就自动启用无需额外的 API 调用。安装、测试与运行通过 CocoaPods 安装README 推荐的安装方式是 CocoaPods。在 Podfile 中加入依赖并执行安装pod PocketSocket pod installHammerspoon 项目实际使用的是子系统化写法pod PocketSocket/Client, 1.0.1见 Podfile对应 Podfile.lock 中的PocketSocket/ClientPocketSocket/Core两个子模块。仓库内 PocketSocket 相关源码位于 Pods/PocketSocket/PocketSocket/共包含PSWebSocket.m、PSWebSocketDriver.m、PSWebSocketBuffer.m、PSWebSocketDeflater.m、PSWebSocketInflater.m、PSWebSocketNetworkThread.m、PSWebSocketUTF8Decoder.m以及各自的头文件。运行 Autobahn 测试Autobahn Test Suite 是 WebSocket 实现的行业标准合规测试。README 给出的步骤安装测试套件sudo pip install autobahntestsuite启动 Autobahn 模糊测试服务端wstest -m fuzzingserver在 Xcode 中运行测试用例由于 README 声明通过了约 519 个客户端与服务端测试用例其中部分服务端测试为非严格模式遇到畸形 payload 会提前断开这套测试流程正是验证协议合规性的标准做法。为什么重写一个库与 SocketRocket 的对比README 的 “Why a new library?” 一节解释了 PocketSocket 的诞生动机。当时 Objective-C 生态中 WebSocket 客户端选择有限最知名的 SocketRocket 存在两个痛点全部代码收敛在单个文件中难以在此基础上新增 permessage-deflate、连接超时等特性网络层与协议层耦合过深无法灵活适配已有工程。PocketSocket 的对策是三管齐下提供丰富且易于深入修改的工具集——把网络层与 Driver 层解耦方便把库嵌进任何现有架构持续跟进协议演进——README 承诺只要主流 WebSocket 扩展草案开始稳定就会第一时间纳入permessage-deflate 正是这一理念的产物客户端到服务端的完整图景——在一个解耦的工具包内同时覆盖 iOS 与 OS X 上的全部使用场景。值得注意的是Hammerspoon 的 Podfile 同时引入了 PocketSocket 和 SocketRocket前者用于PocketSocket/Client子模块后者则被 extensions/websocket/libwebsocket.m 的hs.websocketLua 扩展使用#import SocketRocket/SRWebSocket.h。这说明两者定位不同SocketRocket 作为 hs.websocket 模块的客户端实现PocketSocket 则服务于其他依赖方——从仓库证据看PocketSocket 在此仓库中仅以 CocoaPods 依赖形式存在源码实体位于 Pods/PocketSocket/并未被 Hammerspoon 自身代码直接引用。许可证与作者PocketSocket 采用 Apache License 2.0 授权见 Pods/PocketSocket/LICENSECopyright 2014-Present Zwopple Limited。作者为 Robert Payne贡献者包括 Jens AlfkeCouchbase Lite 与 MacRuby 的作者主要贡献了 TLS 相关的webSocket:evaluateServerTrust:支持。Apache 2.0 允许自由使用、修改与再分发只需保留版权声明与许可证文本这使它非常适合嵌入商业应用。结语从 README 的完整论述到 PSWebSocketDriver.m 的状态机实现PocketSocket 展示了“协议内核与网络 IO 解耦”这一架构思想在 WebSocket 场景下的实践价值客户端、服务端与可插拔 Driver 三位一体permessage-deflate 默认启用TLS 证书可自定义校验Autobahn 全量合规——这些能力让它成为 iOS/OS X 原生实时通信场景中一个值得深入研究的参考实现。如果你正在评估或维护 Objective-C 代码库中的 WebSocket 方案可以从 PSWebSocket.h 与 PSWebSocketTypes.h 入手沿着 Driver 的状态机逐层阅读很快就能建立对 RFC6455 各帧类型与握手流程的完整认知。【免费下载链接】hammerspoonStaggeringly powerful macOS desktop automation with Lua项目地址: https://gitcode.com/gh_mirrors/ha/hammerspoon创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考