// // Copyright (c) 2018 Touch Instinct // // Permission is hereby granted, free of charge, to any person obtaining a copy // of this software and associated documentation files (the Software), to deal // in the Software without restriction, including without limitation the rights // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell // copies of the Software, and to permit persons to whom the Software is // furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN // THE SOFTWARE. // import RxSwift import RxCocoa /// ViewModel that loads data from given data source with loading state tracking. open class GeneralDataLoadingViewModel: BaseViewModel, GeneralDataLoadingHandler, DisposeBagHolder { public typealias LoadingModel = GeneralDataLoadingModel public typealias DataSourceType = Single public typealias LoadingState = GeneralDataLoadingState private let loadingModel: LoadingModel private let loadingStateRelay = BehaviorRelay(value: .initial) // MARK: - DisposeBagHolder public let disposeBag = DisposeBag() /// Initializer with single result sequence and empty result checker closure. /// /// - Parameters: /// - dataSource: A single element sequence. /// - customErrorHandler: Custom error handler for state update. Pass nil for default error handling. /// - emptyResultChecker: Closure for checking result on empty state. public init(dataSource: DataSourceType, customErrorHandler: LoadingModel.ErrorHandler? = nil, emptyResultChecker: @escaping LoadingModel.EmptyResultChecker = { _ in false }) { loadingModel = LoadingModel(dataSource: dataSource, customErrorHandler: customErrorHandler, emptyResultChecker: emptyResultChecker) loadingModel.stateDriver .drive(loadingStateRelay) .disposed(by: disposeBag) bindLoadingState(from: loadingStateDriver) loadingModel.reload() } /// Returns observable that emits current loading state. open var loadingStateObservable: Observable { loadingStateRelay.asObservable() } /// Returns driver that emits current loading state. open var loadingStateDriver: Driver { loadingStateRelay.asDriver() } /// By default returns true if loading state == .result. open var hasContent: Bool { currentLoadingState.hasResult } /// Returns current result if it exists. public var currentResult: ResultType? { currentLoadingState.result } /// Current state of loading process. private(set) public var currentLoadingState: LoadingState { get { loadingStateRelay.value } set { loadingStateRelay.accept(newValue) } } /// Manually update loading state. /// Should be used only in specific situations on your own risk! /// /// - Parameter newState: New loading state. public func updateStateManually(to newState: LoadingState) { currentLoadingState = newState } /// Replaces current data source of loading model with new one. /// /// - Parameter dataSource: A single element sequence. public func replaceDataSource(with newDataSource: DataSourceType) { loadingModel.replaceDataSource(with: newDataSource) } /// Reload data. public func reload() { loadingModel.reload() } // MARK: - GeneralDataLoadingHandler open func onLoadingState() { // override in subclass } open func onResultsState(result: ResultType) { // override in subclass } open func onEmptyState() { // override in subclass } open func onErrorState(error: Error) { // override in subclass } }