Swift — 链式编程实现(适配 Objc)

使用 Swift 实现链式编程,并且兼容 Objc

Swift — 链式编程实现(适配 Objc)
Photo by Karine Avetisyan / Unsplash

链式编程是面向对象编程中同一个对象多个方法被调用的常用语法,可读性比较好。链式编程一般通过小数点.链接各个方法,使之成为一句代码,方法被依次调用。

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 进行许可。普通转载请附上原文出处链接及本许可声明;如有商业转载需求,请联系作者。

Read more

2025 年度总结

2025 年度总结

今天是 2026 年 1 月 1 号,又是新的一年。这个元旦没有安排出行任务,就在家里休息休息,或者出门溜达溜达。昨天休了一天全薪病假,做了体检,写了年终绩效总结,晚上干了一顿烤肉,没有时间写个人的年度总结。今天起早写写总结。 以下「今年」指 2025 年。 职业发展 算起来,我已经毕业工作四年多了。职业发展整体上还算稳定,没有碰到过糟心事,遇到的领导们也都对我关怀有加。今年又晋升一次,薪资迈上新的台阶。越往上升,越觉得离职业生涯的终点越近,逼迫自己赶紧找个靠谱稳定的副业,到 35 岁没人要的时候能养活自己。 最近两年 AI 大模型的崛起,提高了许多行业的可替代性。码农虽然不是首当其冲的,但危机感已经弥漫在各个论坛博客公共平台上面。没有人能准确预测到未来发展,但做好两手准备是很有必要的。码农不能再只低着头守着自己的键盘和屏幕,也要往外看,接触社会上的各种信息,打破信息壁垒。掌握的信息越多,出路就越多。

By Gray
联通 FTTR 宽带从路由器设置自动重启和穿墙功率

联通 FTTR 宽带从路由器设置自动重启和穿墙功率

几个月前把家里宽带换成了联通的千兆 FTTR 宽带,包含一主一从两个点位。配套光猫设备是华为的星光 F50 尊享版。 主点位放置在客厅茶几上,方便连接电视。从点位放在卧室门口,那里恰好有一个不耽误过路的小拐角可以放路由器。平常我们基本不在客厅活动,其他区域最近的 Wi-Fi 信号源是从路由器,因此我们大多数的设备连接的都是从路由器。从路由器的工作负荷很大。 从路由器个头小主路由器很多,散热不咋地。工作时间久了发热就容易发生数据包堵塞,丢包延迟高。需要把它电源拔掉重启。从宽带开通到现在,数据包堵塞影响网络的情况每个月会发生一次。有一次还影响了居家办公的视频会议。宽带维修师傅也给不出有效的法子,建议就是定期插拔从路由器电源。 从路由器和书房之间隔了两堵墙。信号到我书桌那个位置时,千兆网速已经衰减到只有 400-500Mbps 了,折损将近一半。叠加路由器发热的 debuff,书桌位置的网速最差的时候几乎和百兆宽带差不多。 我尝试过在光猫后台管理将路由器功率设置到「穿墙」模式,但没有任何作用。今天在后台研究了一番发现,原来我之前设置的功率是仅对主路由器生效,从路由器还是标准功率。要修

By Gray