iOS_RxSwift使用(文档整理)

iOS_RxSwift使用(文档整理)_第1张图片

整理总结了一下文档内容,方便自己查阅~

一、RxSwift可以做什么?

  1. 点击方法TargetAction

    button.rx.tap.subscrible(onNext:{...})
    
  2. 代理Delegate

    scrollView.rx.contentOffset
    .subscrible(onNext:{ contentOffset in ...})
    
  3. 闭包回调Block

    URLSession.shared.rx.data(request:URLRequest(url:url))
    .subscrible(onNext{ data in ...})
    .onError{ error in ...})
    
  4. 通知Notify

    NotificationCenter.default.rx
    .notification(.UIApplicationiWillEnterForeground)
    .subscrible(onNext:{ notification in ...})
    
  5. 多个任务之间有依赖关系:依次执行(用例见文档)

  6. 等待多个并发任务完成后处理:合并网络请求

    Observable.zip(API.1(...), API.2(...))
    .subscrible(onNext:{(res1, res2) in ...})
    

例如:

valid = field.rx.text.orEmpty.map{$0.count >= 6}
.share(replay:1) // 多个地方使用时共享(而不是另外创建)
valid.bind(to: button.rx.isEnable)
valid3 = Observable.combineLatest(valid1, valid2){$0 && $1} // 合并
.share(replay:1)
.disposed(by: disposBag) // disposBag管理绑定的生命周期

二、RxSwift核心

iOS_RxSwift使用(文档整理)_第2张图片

例如:

text = field.rx.text.orEmpty.asObservable() // text是Observable
valid = text.map{ $0.characters.count >= 6} // valid是Observable、map是Operator
observer = tipsLb.rx.isHidden // Observer
disposable = valid
						.subscribleOn(MainScheduler.instance) // Scheduler
						.observeOn(MainSchedule.instance)
						.bind(to: observer)
disposable.dispose() // 解绑

三、Observable序列

所有事物皆序列:

Observable<Double> // 温度
Observable<onePieceEpisode> // 海贼王
Observable<JSON> // json
Observable<void> // 回调

最直接的创建方式:Observable.create

number: Observable<Int> = 
Observable.create{ observer -> Disposable in // 参数 -> 返回类型
                  observer.onNext(0)
                  ...
                  observer.onNext(n)
                  observer.onCompleted() // 表示已经全部生产,没有更多元素了
                  return Disposable.creat()
                 }

四、Observable特征序列

  1. Single = Observable.asSignle():只发出一个元素/Error

  2. Completable:一个Completed/Error

  3. Maybe = Observable.asMaybe():一个元素/completed/Error

    以上3不像Observable可发出多个元素,也不共享

  4. Driver:不会Error 且 mainThread监听 (可简化UI层代码,解决失败不能try again,后台返回,多次请求)

  5. Signal:与Driver相反,但不会对新观察者回放上一个元素(Driver会,不适用于点击事件)

  6. ControlEvent:UI控件产生事件,无Error,mainThread订阅监听

    以上3共享

五、Observer观察者

响应事件的都是观察者

RxSwift已实现的:

  • view.isHidden
  • button.isEnable
  • label.text
  • imageView.image

最基本的创建方式:Observable.subscrible

tap.subscribe(onNext: { [weak self] in
    self?.showAlert()
}, onError: { error in
    print("发生错误: \(error.localizedDescription)")
}, onCompleted: {
    print("任务完成")
})

特征观察者:

  1. AnyObservable:可描述任意一种观察者(定义一个回调,在subscrible中执行)详情
  2. Binder:详情
    • 不处理Error(测试环境:执行fataError,发布环境:打印ErrorLog)
    • 确保绑定都在给定Scheduler上执行(默认:MainScheduler)

注:Observer监听到error事件(onError:)就会停止监听!!!

六、Observable & Observer

既是可监听序列 也是 观察者,如:field.text/switch.on/segmentedControl选中/datePick选中/…

RxSwift已定义的辅助类型,它们既是可监听序列也是观察者

  1. AsyncSubject:事件完成后只发出最后一个元素/Error(即使是先订阅后产生的)
  2. PblishSubject:只收订阅后的元素
  3. ReplaySubject:会发送订阅前的元素,可以设置前n个/前一段时间的
  4. BehaviorSubject:订阅时,发送最新的元素/Error
  5. ControlProperty:UI控件属性,无Error,mainThread订阅监听(同ControlEvent

七、Operator操作符

创建序列/组合原有序列

filter过滤:filter{ age in age >= 18 }

map转换:map{ Model.init } (JSON -> Model)

Zip配对:Zip{ hamburg, frechFries } (As, Bs -> {A, B})

forEach遍历:同for in

sorted排序:sorted{ student1, student2 in student1.score > student2.score}
。。。

Rx提供了充分的操作符来帮我们创建序列(操作符列表),当然如果内置的无法满足也可以自定义。选择操作符可以参考决策树

如何使用操作符:直接调用实例方法/静态方法

// 1.温度过滤
// 温度
let rxTemperature: Observable<Double> = ...
// filter 操作符
rxTemperature.filter { temperature in temperature > 33 }
    .subscribe(onNext: { temperature in
        print("高温:\(temperature)度")
    })
    .disposed(by: disposeBag)

// 2.解析JSON
// JSON
let json: Observable<JSON> = ...
// map 操作符
json.map(Model.init)
    .subscribe(onNext: { model in
        print("取得 Model: \(model)")
    })
    .disposed(by: disposeBag)

// 3.成套餐
// 汉堡
let rxHamburg: Observable<Hamburg> = ...
// 薯条
let rxFrenchFries: Observable<FrenchFries> = ...
// zip 操作符
Observable.zip(rxHamburg, rxFrenchFries)
    .subscribe(onNext: { (hamburg, frenchFries) in
        print("取得汉堡: \(hamburg) 和薯条:\(frenchFries)")
    })
    .disposed(by: disposeBag)

八、Disposable可被清除的资源

Disposable可被清除的资源

  1. 单独清除

    var disposable: Disposable? // 属性
    self.disposable = field.rx.text.subscrible{ onNext:{...} }
    self.disposable.dispose() // 如:dismiss时
    
  2. 清除包

    var disposeBag: DisposableBag() // 属性
    ....disposed(by: disposeBag) // 通过包清除
    self.disposeBag = DisposBag() // 如:dealloc时
    
  3. takeUntil

    ....takeUnitl{ self.rx.deallocated } // dealloc时清除
    

例:

九、Scheduler调度器

控制任务在哪个线程或队列运行

iOS_RxSwift使用(文档整理)_第3张图片

如:

let rxData: Observable<Data> = ...
rxData 
.subscribleOn(ConcurrentDispatchQueueScheduler(qos: .userInitiated)) // subscribleOn 设置`序列构建函数`在哪执行
// observeOn 设置在哪个线程监听 
.observeOn(MainScheduler.asyncInstance) // 异步事件
//.observeOn(MianScheduler.instance) // 异步事件
.subscrible(onNext:{ [weak self] data in
                    self?.data = data
                   })
.disposed(by: disposeBag)

派发队列DispatchQueue

  • 主线程:MainScheduler
  • 串行:SerialDsipatchQueueScheduler
  • 并行:ConcurrentDispatchQueueScheduler
  • OperationQueueScheduler抽象了NSOperationQueue,具备其一些特点,如:可以设置maxConcurrentOperationCount 控制同时执行并发任务的最大数量

十、防止Error后序列终止

ErrorHanding错误处理:

  • retry重试:

    1. 重试n次:

      let rxJson: Observable<JSON> = ...
      rxJson
      .retry(3) // 重试3次
      .subscribe(onNext: { json in
          print("取得 JSON 成功: \(json)")
      }, onError: { error in
          print("取得 JSON 失败: \(error)") // 3次后仍失败,将错误抛出
      })
      .disposed(by: disposeBag)
      
    2. n秒后重试:

        let retryDelay: Double = 5  // 延时 5 秒后重试
        rxJson
        .retryWhen { (rxError: Observable<Error>) -> Observable<Int> in
            return Observable.timer(retryDelay, scheduler: MainScheduler.instance)
        }
        .subscribe(...)
        .disposed(by: disposeBag)
      
    3. 结合1.2.:失败后n秒重试,最多重试n次

      let maxRetryCount = 4       // 最多重试 4 次
      let retryDelay: Double = 5  // 重试延时 5 秒
      rxJson
      .retryWhen { (rxError: Observable<Error>) -> Observable<Int> in
        return rxError.flatMapWithIndex { (error, index) -> Observable<Int> in
          guard index < maxRetryCount else {
              return Observable.error(error)
          }
          return Observable<Int>.timer(retryDelay, scheduler: MainScheduler.instance)
        }
      }
      .subscribe(...)
      .disposed(by: disposeBag)
      
  • catchError恢复:Error时,用1或n个备用元素代替

    return network(query).catchErrorJustReturn([])
    
  • Return包装结果:

    public enum Result<Success, Failure> where Failure : Error {
        case success(Success)
        case failure(Failure)
    }
    return network(query)
    .map(Result.success)
    .cathError( error in
               // 将错误事件被包装成了 Result.failure(Error) 元素
               Observable.just(Result.failure(error))
              )
    
  • materialize操作符进行处理:详情

十一、冷热信号

建议将其视为序列的属性,而不是单独的类型,因为它们是用同样的抽象来表示的,完全符合它们,可观察的序列Observable sequence

热信号 冷信号
是序列 是序列
无论是否有观察者订阅,都使用资源(产生热能) 观察者订阅之前,不使用资源(不产生热能)
变量/属性/常量,点击坐标,鼠标坐标,UI控件值,当前时间… 异步操作,HTTP连接,TCP连接,流…
通常包含N个元素 通常包含1个元素
无论是否有观察者订阅,都会生成序列元素 晋档有订阅的观察者时才产生序列元素
序列计算资源通常在所有订阅的观察者之间共享 通常为每个订阅的观察者分配计算资源
通常有状态 通常无状态

参考:

RxSwift中文文档

Hot and Cold Observables

你可能感兴趣的:(Read+Tidy,swift,ios,xcode)