GRDB.swift 中记录时间戳自动更新的正确实现方式

在使用 GRDB.swift 进行数据库操作时，开发者经常需要实现记录时间戳的自动更新功能。本文将通过一个典型场景，深入解析如何正确实现记录插入和更新时的时间戳自动更新机制。

常见误区

许多开发者会尝试使用类似以下代码来实现时间戳自动更新：

struct Person: Codable, FetchableRecord, MutablePersistableRecord {
    var id: Int?
    var modified: Date = Date()
    var name: String
    
    // 错误实现：使用了 mutating 修饰符
    mutating func willInsert(_ db: Database) throws {
        modified = Date()
    }
    
    // 错误实现：使用了 mutating 修饰符
    mutating func willUpdate(_ db: Database, columns: Set<String>) throws {
        modified = Date()
    }
}

这种实现方式存在两个关键问题：

1. willUpdate 方法被错误地声明为 mutating，导致协议要求未被满足
2. 直接修改属性的方式不够优雅且容易出错

正确实现方式

GRDB.swift 提供了更优雅的方式来实现时间戳自动更新：

struct Person: Codable, FetchableRecord, MutablePersistableRecord {
    var id: Int?
    var modified: Date = Date()
    var name: String
    
    // 正确的 willInsert 实现
    func willInsert(_ db: Database) throws {
        modified = Date()
    }
    
    // 正确的 willUpdate 实现
    func willUpdate(_ db: Database, columns: Set<String>) throws {
        modified = Date()
    }
}

关键点在于：

• 移除 mutating 修饰符
• 直接赋值而非修改属性

高级实现方案

对于更复杂的场景，GRDB.swift 推荐使用 Timestamped 协议：

protocol Timestamped {
    var createdAt: Date? { get set }
    var updatedAt: Date? { get set }
}

extension Timestamped where Self: MutablePersistableRecord {
    mutating func didInsert(_ inserted: InsertionSuccess) {
        createdAt = Date()
        updatedAt = Date()
    }
    
    func willUpdate(_ db: Database, columns: Set<String>) throws {
        updatedAt = Date()
    }
}

这种方式提供了更清晰的语义和更好的可维护性。

最佳实践建议

1. 对于简单场景，直接使用 willInsert 和 willUpdate 方法
2. 对于需要跟踪创建时间和修改时间的场景，实现 Timestamped 协议
3. 避免在时间戳更新逻辑中包含复杂业务逻辑
4. 考虑使用数据库触发器作为替代方案，特别是需要跨平台一致性的场景

通过遵循这些实践，可以确保在 GRDB.swift 中实现可靠且高效的时间戳自动更新机制。