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

《漫步华尔街(第12版)》读书笔记

《漫步华尔街(第12版)》读书笔记

股票分析 基本面分析 * 基本面分析的四个基本决定因素 * 预期增长率 * 复合增长(复利)对投资决策有很重要的意义。 * 一只股票的股利增长和盈利增长率越高,理性投资者应愿意为其支付越高的价格。 * 推论:一只股票的超常增长率持续时间越长,理性投资者应愿意为其支付越高的价格。 * 预期股利支付率 * 对于预期增长率相同的两只股票来说,持有股利支付率越高的股票,较之股利支付率低的股票,会使你的财务状况更好。 * 在其他条件相同的情况下,一家公司发放的现金股利占其盈利的比例越高,理性投资者应愿意为其股票支付越高的价格。 * 特例,很多处于强劲增长阶段的公司,往往不支付任何股利。这时候不满足「在其他条件相同的情况下」。 * 风险程度 * 在其他条件相同的情况下,一家公司的股票风险越低,理性投资者(以及厌恶风险的投资者)应愿意为其股票支付越高的价格。 * 市场利率水平 * 在其他条件相同的情况下,市场利率越低,理性投资者应愿意为股票支付越高的价格。 * 举例,银行存款利率

By Gray
2025 端午日本九日游

2025 端午日本九日游

从日本回来后就一直忙个不停,忙着搬家和工作。这周末终于有时间回顾和记录一下日本的旅游行程。 这次出国游是年初就规划好的。端午节假期三天再加上节后请假四天,以及周末,总共能休 9 天。5 月 31 号出发,6 月 9 号凌晨的航班飞回北京。 出发前的准备 机票和酒店 越临近出发日期,机票和酒店就越贵。所以我们早早地就把机票和酒店定了。 去程机票订的山航,青岛转机,5 月 31 号从北京出发抵达青岛,在青岛玩一天,翌日早上从青岛飞往关西机场。回程机票订的海南航空,从东京羽田机场直飞北京,是凌晨两三点的红眼航班。 本次行程要去关西(京都、大阪、奈良)、关东(东京、富士山)。关西三个城市很近,一直住在京都即可,从京都往返大阪和奈良。关东就住在东京。京都的酒店订在了京都站附近,出站走几步就能到,交通非常便利。东京的酒店订在了马喰町附近,附近有很多地铁线路,包括浅草线、

By Gray
2025 关税危机中学到的投资经验

2025 关税危机中学到的投资经验

充足的现金流很重要 好的买入机会不会每天都出现,但当它出现的时候,你最好还有筹码可以投入。 有些人手里握不住钱,一有闲钱就赶紧买入基金、股票,生怕错过了机会,让钱白搭手里。市场是疯狂的、充满变数的,尤其是在特朗普上台后,一句话就可能让股市涨停或跌停。那些专业的理财投资机构尚不能预测市场,何况我们这些散户呢。在不稳定的市场中,我们要学习巴菲特,备好现金,耐心等待买入(抄底)机会。 不要提前打光子弹 美股标普 500 指数从 2 月中旬到 3 月中旬累计跌了约 10%。如果这时候你觉得已经跌了很多,可以 all in 抄底了,那么你就会错过 4 月上旬的那次狂跌——一周跌了约 10%。没有人能预测市场,除了此刻的股市指挥家特朗普。散户们能学到的经验就是「永远不要提前打光子弹」,你以为的谷底其实只是个半山腰。 相信自己,保持耐心 在美股大跌的时段里,小红书、v2ex

By Gray