//
|
// Catch.swift
|
// RxSwift
|
//
|
// Created by Krunoslav Zaher on 4/19/15.
|
// Copyright © 2015 Krunoslav Zaher. All rights reserved.
|
//
|
|
extension ObservableType {
|
|
/**
|
Continues an observable sequence that is terminated by an error with the observable sequence produced by the handler.
|
|
- seealso: [catch operator on reactivex.io](http://reactivex.io/documentation/operators/catch.html)
|
|
- parameter handler: Error handler function, producing another observable sequence.
|
- returns: An observable sequence containing the source sequence's elements, followed by the elements produced by the handler's resulting observable sequence in case an error occurred.
|
*/
|
public func `catch`(_ handler: @escaping (Swift.Error) throws -> Observable<Element>)
|
-> Observable<Element> {
|
Catch(source: self.asObservable(), handler: handler)
|
}
|
|
/**
|
Continues an observable sequence that is terminated by an error with the observable sequence produced by the handler.
|
|
- seealso: [catch operator on reactivex.io](http://reactivex.io/documentation/operators/catch.html)
|
|
- parameter handler: Error handler function, producing another observable sequence.
|
- returns: An observable sequence containing the source sequence's elements, followed by the elements produced by the handler's resulting observable sequence in case an error occurred.
|
*/
|
@available(*, deprecated, renamed: "catch(_:)")
|
public func catchError(_ handler: @escaping (Swift.Error) throws -> Observable<Element>)
|
-> Observable<Element> {
|
`catch`(handler)
|
}
|
|
/**
|
Continues an observable sequence that is terminated by an error with a single element.
|
|
- seealso: [catch operator on reactivex.io](http://reactivex.io/documentation/operators/catch.html)
|
|
- parameter element: Last element in an observable sequence in case error occurs.
|
- returns: An observable sequence containing the source sequence's elements, followed by the `element` in case an error occurred.
|
*/
|
public func catchAndReturn(_ element: Element)
|
-> Observable<Element> {
|
Catch(source: self.asObservable(), handler: { _ in Observable.just(element) })
|
}
|
|
/**
|
Continues an observable sequence that is terminated by an error with a single element.
|
|
- seealso: [catch operator on reactivex.io](http://reactivex.io/documentation/operators/catch.html)
|
|
- parameter element: Last element in an observable sequence in case error occurs.
|
- returns: An observable sequence containing the source sequence's elements, followed by the `element` in case an error occurred.
|
*/
|
@available(*, deprecated, renamed: "catchAndReturn(_:)")
|
public func catchErrorJustReturn(_ element: Element)
|
-> Observable<Element> {
|
catchAndReturn(element)
|
}
|
}
|
|
extension ObservableType {
|
/**
|
Continues an observable sequence that is terminated by an error with the next observable sequence.
|
|
- seealso: [catch operator on reactivex.io](http://reactivex.io/documentation/operators/catch.html)
|
|
- returns: An observable sequence containing elements from consecutive source sequences until a source sequence terminates successfully.
|
*/
|
@available(*, deprecated, renamed: "catch(onSuccess:onFailure:onDisposed:)")
|
public static func catchError<Sequence: Swift.Sequence>(_ sequence: Sequence) -> Observable<Element>
|
where Sequence.Element == Observable<Element> {
|
`catch`(sequence: sequence)
|
}
|
|
/**
|
Continues an observable sequence that is terminated by an error with the next observable sequence.
|
|
- seealso: [catch operator on reactivex.io](http://reactivex.io/documentation/operators/catch.html)
|
|
- returns: An observable sequence containing elements from consecutive source sequences until a source sequence terminates successfully.
|
*/
|
public static func `catch`<Sequence: Swift.Sequence>(sequence: Sequence) -> Observable<Element>
|
where Sequence.Element == Observable<Element> {
|
CatchSequence(sources: sequence)
|
}
|
}
|
|
extension ObservableType {
|
|
/**
|
Repeats the source observable sequence until it successfully terminates.
|
|
**This could potentially create an infinite sequence.**
|
|
- seealso: [retry operator on reactivex.io](http://reactivex.io/documentation/operators/retry.html)
|
|
- returns: Observable sequence to repeat until it successfully terminates.
|
*/
|
public func retry() -> Observable<Element> {
|
CatchSequence(sources: InfiniteSequence(repeatedValue: self.asObservable()))
|
}
|
|
/**
|
Repeats the source observable sequence the specified number of times in case of an error or until it successfully terminates.
|
|
If you encounter an error and want it to retry once, then you must use `retry(2)`
|
|
- seealso: [retry operator on reactivex.io](http://reactivex.io/documentation/operators/retry.html)
|
|
- parameter maxAttemptCount: Maximum number of times to repeat the sequence.
|
- returns: An observable sequence producing the elements of the given sequence repeatedly until it terminates successfully.
|
*/
|
public func retry(_ maxAttemptCount: Int)
|
-> Observable<Element> {
|
CatchSequence(sources: Swift.repeatElement(self.asObservable(), count: maxAttemptCount))
|
}
|
}
|
|
// catch with callback
|
|
final private class CatchSinkProxy<Observer: ObserverType>: ObserverType {
|
typealias Element = Observer.Element
|
typealias Parent = CatchSink<Observer>
|
|
private let parent: Parent
|
|
init(parent: Parent) {
|
self.parent = parent
|
}
|
|
func on(_ event: Event<Element>) {
|
self.parent.forwardOn(event)
|
|
switch event {
|
case .next:
|
break
|
case .error, .completed:
|
self.parent.dispose()
|
}
|
}
|
}
|
|
final private class CatchSink<Observer: ObserverType>: Sink<Observer>, ObserverType {
|
typealias Element = Observer.Element
|
typealias Parent = Catch<Element>
|
|
private let parent: Parent
|
private let subscription = SerialDisposable()
|
|
init(parent: Parent, observer: Observer, cancel: Cancelable) {
|
self.parent = parent
|
super.init(observer: observer, cancel: cancel)
|
}
|
|
func run() -> Disposable {
|
let d1 = SingleAssignmentDisposable()
|
self.subscription.disposable = d1
|
d1.setDisposable(self.parent.source.subscribe(self))
|
|
return self.subscription
|
}
|
|
func on(_ event: Event<Element>) {
|
switch event {
|
case .next:
|
self.forwardOn(event)
|
case .completed:
|
self.forwardOn(event)
|
self.dispose()
|
case .error(let error):
|
do {
|
let catchSequence = try self.parent.handler(error)
|
|
let observer = CatchSinkProxy(parent: self)
|
|
self.subscription.disposable = catchSequence.subscribe(observer)
|
}
|
catch let e {
|
self.forwardOn(.error(e))
|
self.dispose()
|
}
|
}
|
}
|
}
|
|
final private class Catch<Element>: Producer<Element> {
|
typealias Handler = (Swift.Error) throws -> Observable<Element>
|
|
fileprivate let source: Observable<Element>
|
fileprivate let handler: Handler
|
|
init(source: Observable<Element>, handler: @escaping Handler) {
|
self.source = source
|
self.handler = handler
|
}
|
|
override func run<Observer: ObserverType>(_ observer: Observer, cancel: Cancelable) -> (sink: Disposable, subscription: Disposable) where Observer.Element == Element {
|
let sink = CatchSink(parent: self, observer: observer, cancel: cancel)
|
let subscription = sink.run()
|
return (sink: sink, subscription: subscription)
|
}
|
}
|
|
// catch enumerable
|
|
final private class CatchSequenceSink<Sequence: Swift.Sequence, Observer: ObserverType>
|
: TailRecursiveSink<Sequence, Observer>
|
, ObserverType where Sequence.Element: ObservableConvertibleType, Sequence.Element.Element == Observer.Element {
|
typealias Element = Observer.Element
|
typealias Parent = CatchSequence<Sequence>
|
|
private var lastError: Swift.Error?
|
|
override init(observer: Observer, cancel: Cancelable) {
|
super.init(observer: observer, cancel: cancel)
|
}
|
|
func on(_ event: Event<Element>) {
|
switch event {
|
case .next:
|
self.forwardOn(event)
|
case .error(let error):
|
self.lastError = error
|
self.schedule(.moveNext)
|
case .completed:
|
self.forwardOn(event)
|
self.dispose()
|
}
|
}
|
|
override func subscribeToNext(_ source: Observable<Element>) -> Disposable {
|
source.subscribe(self)
|
}
|
|
override func done() {
|
if let lastError = self.lastError {
|
self.forwardOn(.error(lastError))
|
}
|
else {
|
self.forwardOn(.completed)
|
}
|
|
self.dispose()
|
}
|
|
override func extract(_ observable: Observable<Element>) -> SequenceGenerator? {
|
if let onError = observable as? CatchSequence<Sequence> {
|
return (onError.sources.makeIterator(), nil)
|
}
|
else {
|
return nil
|
}
|
}
|
}
|
|
final private class CatchSequence<Sequence: Swift.Sequence>: Producer<Sequence.Element.Element> where Sequence.Element: ObservableConvertibleType {
|
typealias Element = Sequence.Element.Element
|
|
let sources: Sequence
|
|
init(sources: Sequence) {
|
self.sources = sources
|
}
|
|
override func run<Observer: ObserverType>(_ observer: Observer, cancel: Cancelable) -> (sink: Disposable, subscription: Disposable) where Observer.Element == Element {
|
let sink = CatchSequenceSink<Sequence, Observer>(observer: observer, cancel: cancel)
|
let subscription = sink.run((self.sources.makeIterator(), nil))
|
return (sink: sink, subscription: subscription)
|
}
|
}
|
