SketchK's Studio.

Swift Tips 030 - Passing self to required Objective-C dependencies

字数统计: 987阅读时长: 3 min
2019/12/16 Share

每天了解一点不一样的 Swift 小知识

代码截图

01.png

代码出处: Swift Tips 030 by John Sundell

小笔记

这段代码在说什么

像 DataLoader 和 Renderer 这样的工具类,八成是要与 Cocoa 框架打交道,例如 URLSession 的 delegate 需要继承 NSObject,CADisplayLink 的 selector 方法需要声明 @objc 关键字,这很不 Swift,为了提升使用体验,SDK 的维护者可以将其隔离在内部,就像今天的示例代码一样。

一组对比

为了让大家更好的理解今天的 tips,我们需要将示例中代码完整的呈现出来,不过由于篇幅的原因,我们只针对 DataLoader 进行详细的说明。

假设 SDK 维护者的意图是让使用者在 URL Session 的代理方法urlSession(_ session: URLSession, didBecomeInvalidWithError error: Error?)中注入自己的逻辑,

那么这里先用方案 A,也就是 Tips 里的思路来完善代码。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
// Plan A
// SDK Maintainer's Code
protocol DataLoaderADelegate: class {
func dataLoader(_ dataLoader: DataLoaderA, session: URLSession, didBecomeInvalidWithError error: Error?)
}
class DataLoaderA: NSObject {
lazy var urlSession: URLSession = self.makeURLSession()
weak var urlSessionDelegate: DataLoaderADelegate?;
private func makeURLSession() -> URLSession {
return URLSession(configuration: .default, delegate: self, delegateQueue: .main)
}
}
extension DataLoaderA: URLSessionDelegate {
internal func urlSession(_ session: URLSession, didBecomeInvalidWithError error: Error?) {
urlSessionDelegate?.dataLoader(self, session: session, didBecomeInvalidWithError: error)
}
}
// SDK User's Code
class ControllerA : DataLoaderADelegate {
lazy var dataLoader: DataLoaderA = {
return DataLoaderA()
}()
func dataLoader(_ dataLoader: DataLoaderA, session: URLSession, didBecomeInvalidWithError error: Error?) {
// do something
}
}

然后我们用另外一种方式来完成这个需求:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
// Plan B
// SDK Maintainer's Code
class DataLoaderB {
var urlSession: URLSession?
}
// SDK User's Code
class ControllerB: NSObject {
lazy var dataLoader: DataLoaderB = {
let dataLoader = DataLoaderB()
dataLoader.urlSession = URLSession(configuration: .default, delegate: self, delegateQueue: .main)
return dataLoader
}()
}
extension ControllerB: URLSessionDelegate {
internal func urlSession(_ session: URLSession, didBecomeInvalidWithError error: Error?) {
// do something
}
}

不同的视角

我们可以看到方案 A 和方案 B 在功能上是一致的,但从 SDK 使用者的角度上,体验可是不同的。

我们可以看到方案 B 的使用者,不仅需要让自身继承关系指向 NSObject,而且也需要手动实现 URLSessionDelegate 的代理方法,虽然目前代理方法看起来需要做的不多,但如果有些不痛不痒的 required 的方法(例如需要为 DataLoader 设置一个名称),其实不如将其封装在 SDK 内部。毕竟作为 SDK 的使用者,不需要一遍一遍的去写这些无用的代码。

同样是方案 B,我们换个角度,如果你是 SDK 维护者,虽然代码写的少了,但如果想禁止开发者使用某些URLSession 的代理方法时,或者想添加一些前置逻辑时,你是不是会发现有点力不从心!

接下来,我们看一下方案 A 的使用者,他需要关心的就很少了,只需要遵守对应的代理方法即可实现对应的功能,至于 NSObject 是什么,URLSession 的代理到底有哪些,他统统都不用关心,SDK 支持的能力会在协议里一览无余。代码看起来也少了点 Objective—C 的影子。

同样是方案 A,我们再次将视角换做 SDK 的维护者,虽然代码量相对方案 B 多了许多,但是可控制性变得强了。

综上所述,虽然方案 B 在代码量上有一定优势,但从代码风格和可控性上,还是方案 A 更胜一筹。

成全别人,恶心自己

在冯小刚导演的电影《私人订制》里有这么一句经典台词:

成全别人,恶心自己

我想这句话,或许是很多基础 SDK 开发者的心声,因为在实现功能的同时,怎么让使用者在调用的时候也感觉到舒适也是需要考虑的。

不管怎样,今天的这个 tips 并不是什么奇淫巧技,更多的是在 SDK 的 API 设计上如何做到更人性化,你 get 到了么?

如果你有什么好的想法,欢迎分享!

CATALOG
  1. 1. 代码截图
  2. 2. 小笔记
    1. 2.1. 这段代码在说什么
    2. 2.2. 一组对比
    3. 2.3. 不同的视角
    4. 2.4. 成全别人,恶心自己