DelegateProxy - 优雅地处理代理事件

DelegateProxy - 优雅地处理代理事件

DelegateProxy 是一款强大的 Swift 库，它允许你以订阅者模式接收委托事件，使其在各种场景下更加实用。这个库是 RxSwift 版本的通用实现，因此可以与其他反应式框架如 ReactiveCocoa 或 SwiftBond 等完美结合。

项目简介

DelegateProxy 提供了一种优雅的方式，让你能够通过定义自定义的代理中间类，轻松订阅并处理来自原生委托的事件。这使得代码更清晰，易于维护，并且可以避免因过度复杂的委托结构导致的问题。

技术分析

DelegateProxy 的核心是 DelegateProxy 类和 Receivable 协议。当你创建一个继承自 DelegateProxy 并遵循所需协议（如 UIScrollViewDelegate）的类时，你可以重写 resetDelegateProxy 方法来设置原始对象的代理为自定义的代理中间件。

Receivable 协议让接收到的事件可以通过任何实现了该协议的对象进行分发。这意味着你不仅可以使用 DelegateProxy 自身提供的方法，还可以利用第三方反应式库扩展其功能。

应用场景

DelegateProxy 可广泛应用于各类需要处理委托事件的情况，尤其是在有多个组件需要监听同一委托事件，或者希望将事件处理逻辑解耦时。例如：

• 在滚动视图中，多个模块可能都需要关注 scrollViewDidScroll 事件。
• 当你的应用需要动态调整 UI 布局，而这些布局依赖于某个协议中的事件时。

项目特点

• 灵活订阅 - 无需修改原有代码，即可通过调用 receive 方法订阅事件处理。
• 跨框架兼容 - 支持与 ReactiveCocoa 和 SwiftBond 等框架无缝对接，你可以选择最适合项目需求的工具。
• 易用性 - 通过简单的扩展或方法调用即可启用 DelegateProxy 功能。
• 测试友好 - 鼓励编写测试用例确保新功能的正确性，使得代码质量更高。

安装指南

支持 CocoaPods 和 Carthage 安装。

• 使用 CocoaPods，请在 Podfile 中添加以下行：

  pod 'DelegateProxy'
  

• 如果你是 Carthage 用户，在 Cartfile 文件中添加：

  github "ra1028/DelegateProxy"
  

示例代码

以下是一个简单的示例，展示如何接收和处理 UIScrollView 的 scrollViewDidScroll 事件：

final class ScrollViewDelegateProxy: DelegateProxy, UIScrollViewDelegate, DelegateProxyType {
    func resetDelegateProxy(owner: UIScrollView) {
        owner.delegate = self
    }
}

// 扩展 UIScrollView 来方便使用 DelegateProxy
extension UIScrollView {
    var delegateProxy: ScrollViewDelegateProxy {
        return .proxy(for: self)
    }
}

// 订阅并处理事件
scrollView.delegateProxy
    .receive(#selector(UIScrollViewDelegate.scrollViewDidScroll(_:))) { args in
        guard let scrollView: UIScrollView = args.value(at: 0) else { return }
        print(scrollView.contentOffset)
}

DelegateProxy 还提供了一些定制化的例子，例如使用 ReactiveCocoa 和 SwiftBond 处理事件流，这使得你在复杂的应用环境中也能保持代码的简洁。

DelegateProxy 是一个开源项目，欢迎任何形式的贡献和反馈。它的许可协议采用的是 MIT 许可证，这意味着你可以自由地使用和修改源码，只需保留原有的版权信息即可。

立即试用 DelegateProxy，让委托事件处理变得更加便捷和优雅！