Swift — 链式编程实现(适配 Objc)
使用 Swift 实现链式编程,并且兼容 Objc
链式编程是面向对象编程中同一个对象多个方法被调用的常用语法,可读性比较好。链式编程一般通过小数点.
链接各个方法,使之成为一句代码,方法被依次调用。
Swift 实现简单的链式编程
Swift 实现链式编程比较简单,只需要让每个方法返回实例本身即可。例如:
@discardableResult
func A() -> Self {
// do some thing...
print("A method called")
return self
}
关键字 @discardableResult
让编译器忽略返回值未使用的警告,因为链式方法末尾的返回值大部分情况下是不会被接受/使用的。
如法炮制,多写几个类似的方法,就能实现链式调用了:
@discardableResult
func B(param: String) -> Self {
// do some thing...
print("B method called, param: \(param)")
return self
}
@discardableResult
func C(param: String, param2: Int) -> Self {
// do some thing...
print("C method called, param: \(param), param2: \(param2)")
return self
}
链式调用:
SwiftDSL.defaultConfig.A().B(param: "123").C(param: "456", param2: 789)
// output
// A method called
// B method called, param: 123
// C method called, param: 456, param2: 789
适配 Objc
使用 Objc 语言也能实现链式调用,但肯定不是像 Swift 那样通过返回实例本身的方法实现,而是通过 block 属性实现。例如:
@property (nonatomic, copy, readonly) __kindof MyClass * (^chainA)(void);
- (__kindof MyClass * _Nonnull (^)(void))chainA {
return ^__kindof MyClass *(void) {
// to do sth...
return self;
};
}
这是因为 Objc 中是通过中括号[]
调用方法的,并不是小数点。如果用一大串的[]
一个一个调用方法,就违背了链式思想的本意了。
下面介绍一下如何将 Swift 的链式代码适配 Objc。
使用 Swift 代码编写 Objc 能够使用的链式方法,同样需要借助属性来实现。不过这里的属性是不需要存储的(只读),只是一个计算的媒介。
@objc(A)
var dsl_A: (() -> SwiftDSL) {
return A
}
上面代码给对象添加了一个计算属性 dsl_A
,返回值为方法A
,或者叫A
的签名。这个计算属性本身的类型是一个 block,返回值为对象本身的类型。属性之所以命名为dsl_A
,是为了避免和A
存在命名冲突,因为二者存在于同一个 Swift 代码中。并且使用@objc(A)
为这个属性在 Objc 里改名为 A,有点绕……
Swift 链式方法A
本身是设置了对 Objc 不可见的,因为 Objc 并不能通过方法的形式实现链式调用,只能通过属性实现。因此借助了一个dsl_A
属性实现 Objc 的适配。
整个一套下来,代码如下:
public extension SwiftDSL {
@discardableResult
func A() -> Self {
// do some thing...
print("A method called")
return self
}
@discardableResult
func B(param: String) -> Self {
// do some thing...
print("B method called, param: \(param)")
return self
}
@discardableResult
func C(param: String, param2: Int) -> Self {
// do some thing...
print("C method called, param: \(param), param2: \(param2)")
return self
}
}
// MARK: - For Objc
@available(swift, obsoleted: 1.0)
public extension SwiftDSL {
@objc(A)
var dsl_A: (() -> SwiftDSL) {
return A
}
@objc(B)
var dsl_B: ((_ string: String) -> SwiftDSL) {
return B(param:)
}
@objc(C)
var dsl_C: ((_ string: String, _ param2: Int) -> SwiftDSL) {
return C(param:param2:)
}
}
关键字@available(swift, obsoleted: 1.0)
是为了将dsl_A
,dsl_B
,dsl_C
这些专门给 Objc 用的属性只暴露给 Objc,Swift 无法调用。
在 Unit Test 里测试一下:
- (void)testAPI {
SwiftDSL.defaultConfig.A().B(@"123").C(@"456", 789);
}
// output
// Test Case '-[SwiftDSLTests testAPI]' started.
// A method called
// B method called, param: 123
// C method called, param: 456, param2: 789
方法调用顺序以及输出结果是符合预期的🎉。
完整代码见 SwiftDSL
本作品为作者原创文章,采用 CC BY-NC-SA 4.0 进行许可。普通转载请附上原文出处链接及本许可声明;如有商业转载需求,请联系作者。