swift 中 Combine框架技术点汇总表

Combine框架思维导图。Apple Combine 官方文档

mindmap root(Combine框架) 核心协议 Publisher Subscriber Subscription Subject Scheduler ObservableObject 发布者(Publishers) 基础发布者 AnyPublisher Future Just Deferred Empty Fail Record 可连接发布者 ConnectablePublisher 操作符发布者 Map TryMap Filter CombineLatest Merge Catch Retry 订阅者(Subscribers) AnySubscriber Sink Assign 订阅管理 Subscriptions AnyCancellable 主体(Subjects) PassthroughSubject CurrentValueSubject 调度器(Schedulers) ImmediateScheduler DispatchQueue RunLoop OperationQueue 观察对象(ObservableObject) ObservableObjectPublisher 异步发布者 AsyncPublisher AsyncThrowingPublisher 编解码器 TopLevelEncoder TopLevelDecoder 调试标识 CustomCombineIdentifierConvertible CombineIdentifier 迁移工具 NotificationCenter.Publisher Timer.TimerPublisher KVO发布者

一、Combine 框架核心结构

scss 复制代码
├── 核心协议
│   ├── Publisher
│   ├── Subscriber
│   ├── Subscription
│   ├── Subject
│   ├── Scheduler
│   ├── ObservableObject
│   ├── TopLevelEncoder
│   ├── TopLevelDecoder
│   └── CustomCombineIdentifierConvertible
│
├── 发布者(Publishers)
│   ├── 基础发布者
│   │   ├── AnyPublisher
│   │   ├── Future
│   │   ├── Just
│   │   ├── Deferred
│   │   ├── Empty
│   │   ├── Fail
│   │   └── Record
│   │
│   ├── 可连接发布者
│   │   └── ConnectablePublisher
│   │
│   └── 操作符发布者
│       ├── Map
│       ├── Filter
│       ├── CombineLatest
│       ├── Merge
│       ├── Zip
│       ├── Catch
│       ├── Retry
│       └── Debounce
│
├── 订阅者(Subscribers)
│   ├── AnySubscriber
│   ├── Sink
│   ├── Assign
│   └── Demand
│
├── 订阅管理
│   ├── AnyCancellable
│   ├── Subscriptions
│   └── CombineIdentifier
│
├── 主体(Subjects)
│   ├── PassthroughSubject
│   └── CurrentValueSubject
│
├── 调度器(Schedulers)
│   ├── ImmediateScheduler
│   ├── DispatchQueue
│   ├── RunLoop
│   └── OperationQueue
│
├── 观察对象系统
│   ├── ObservableObject
│   ├── ObservableObjectPublisher
│   └── Published
│
├── 异步序列支持
│   ├── AsyncPublisher
│   └── AsyncThrowingPublisher
│
└── Foundation集成
    ├── NotificationCenter.Publisher
    ├── Timer.TimerPublisher
    ├── URLSession.DataTaskPublisher
    └── KVO发布者

二、关键组件说明

  1. 核心协议

    • Publisher: 定义值序列提供者的基本协议
    • Subscriber: 接收和处理值的协议
    • Subscription: 管理发布者-订阅者生命周期的协议
  2. 发布者体系

    • 基础发布者 : 直接创建数据流的类型
      • Just(值): 发送单个值后立即完成
      • Future { 承诺 in ... }: 异步操作结果发布者
    • 操作符发布者 : 转换数据流的类型(通过操作符创建)
      • .map(转换函数) → Map
      • .filter(条件) → Filter
  3. 订阅系统

    • sink { 值 in ... }: 通过闭包接收值
    • .assign(to: \.属性, on: 对象): 绑定到属性
    • AnyCancellable: 自动管理订阅生命周期
  4. Subject 特殊发布者

    • PassthroughSubject(): 无初始值的管道
    • CurrentValueSubject(初始值): 带当前值的管道
  5. 调度器

    • DispatchQueue.main: 主线程调度
    • .subscribe(on: 后台队列): 指定订阅执行位置
    • .receive(on: 主队列): 指定值接收位置
  6. SwiftUI 集成

    swift 复制代码
    class ViewModel: ObservableObject {
        @Published var username = ""  // 自动发布变化
        let objectWillChange = ObservableObjectPublisher()
    }

三、官方文档结构详解

1. 核心协议 (Core Protocols)

协议 描述 关键方法
Publisher 值序列提供者 receive(subscriber:)
Subscriber 值序列消费者 receive(subscription:), receive(_:), receive(completion:)
Subscription 发布者-订阅者契约 request(_:), cancel()
Subject 既是发布者又是订阅者 send(_:), send(completion:)
Scheduler 执行调度策略 schedule(options:_:)
ObservableObject 可观察对象协议 自动生成 objectWillChange 发布者

2. 发布者类型 (Publishers)

类型 类别 特点
AnyPublisher 类型擦除 隐藏具体发布者类型
Future 异步单值 执行异步操作后发出单个值
Just 立即单值 立即发出预设值并完成
Deferred 延迟创建 直到订阅时才创建发布者
Empty 空序列 可选择立即完成或永不完成
Fail 立即失败 立即发出错误并终止
Record 录制回放 记录预设序列用于测试
URLSession.DataTaskPublisher 网络请求 封装 URLSession 的数据任务
NotificationCenter.Publisher 通知中心 观察系统通知

3. 订阅管理 (Subscription Management)

类型 作用
AnyCancellable 自动取消订阅的包装器
Subscriptions 订阅相关的命名空间
Set<AnyCancellable> 管理多个订阅的标准模式

4. 调度系统 (Schedulers)

调度器 使用场景
ImmediateScheduler 同步执行,无延迟
DispatchQueue 多线程管理,支持 QoS
RunLoop 主线程 UI 更新
OperationQueue 任务依赖管理

5. 特殊组件

组件 描述
AsyncPublisher 将 Combine 发布者转换为 AsyncSequence
AsyncThrowingPublisher 可能抛出错误的异步序列
TopLevelEncoder 通用编码协议 (如 JSONEncoder)
TopLevelDecoder 通用解码协议 (如 JSONDecoder)
CombineIdentifier 调试用唯一标识符

四、完整文档结构对应表

文档章节 包含主要类型
Publishers AnyPublisher, Future, Just, Deferred, Empty, Fail, Record
Subscribers AnySubscriber, sink, assign
Subjects PassthroughSubject, CurrentValueSubject
Schedulers ImmediateScheduler, DispatchQueue
Observable Objects ObservableObject, ObservableObjectPublisher
Asynchronous Publishers AsyncPublisher, AsyncThrowingPublisher
Encoders and Decoders TopLevelEncoder, TopLevelDecoder
Debugging Identifiers CustomCombineIdentifierConvertible, CombineIdentifier
相关推荐
敲代码的鱼哇15 小时前
跳转原生系统设置插件 支持安卓/iOS/鸿蒙UTS组件
android·ios·harmonyos
在下历飞雨16 小时前
Kuikly基础之状态管理与数据绑定:让“孤寡”计数器动起来
ios·harmonyos
在下历飞雨16 小时前
Kuikly基础之Kuikly DSL基础组件实战:构建青蛙主界面
ios·harmonyos
鹏多多.17 小时前
flutter-使用fluttertoast制作丰富的高颜值toast
android·前端·flutter·ios
他们都不看好你,偏偏你最不争气20 小时前
【iOS】多界面传值
ios
MaoJiu2 天前
Flutter混合开发:在iOS工程中嵌入Flutter Module
flutter·ios
2501_915921432 天前
小团队如何高效完成 uni-app iOS 上架,从分工到工具组合的实战经验
android·ios·小程序·uni-app·cocoa·iphone·webview
2501_916008892 天前
uni-app iOS 文件管理与 itools 配合实战,多工具协作的完整流程
android·ios·小程序·https·uni-app·iphone·webview
Digitally2 天前
如何将视频从 iPhone 转移到 Mac
macos·ios·iphone
2501_916007472 天前
uni-app iOS 文件调试常见问题与解决方案:结合 itools、克魔、iMazing 的实战经验
android·ios·小程序·https·uni-app·iphone·webview