第 13 章：最佳实践与设计模式

数据模型设计的考虑因素

1. 明确业务需求

• 领域驱动设计 (DDD)：根据业务逻辑划分实体和关系
• 最小化冗余：避免重复数据存储，通过关系引用实现数据共享
• 示例场景分析：

  // 电商应用模型示例
  @Model class Product {
      var name: String
      var price: Double
      @Relationship(deleteRule: .nullify) var category: Category?
  }
  

2. 性能优化设计

• 索引的合理使用：

  @Model class User {
      @Attribute(.unique) var id: UUID  // 自动创建索引
      @Attribute(indexed: true) var email: String  // 手动添加索引
  }
  
• 批量操作考虑：
  • 使用 autosaveEnabled 配置减少频繁保存开销
  • 大批量数据导入时考虑临时关闭关系验证

3. 关系设计原则

4. 版本兼容性设计

• 向前兼容策略：
  • 新添加属性设为可选类型
  • 弃用属性保留而非立即删除

  @Model class LegacyModel {
      @Attribute(.transient) var deprecatedField: String?  // 标记为临时属性
  }
  

5. 安全与隐私

• 敏感数据处理：
  • 使用 Data 类型存储加密内容
  • 实现 Transformable 进行自动加解密

  @Model class SecureNote {
      @Attribute(.transformable(transformer: CryptoTransformer.self)) 
      var encryptedContent: Data
  }
  

6. 跨平台一致性

• CloudKit 同步注意事项：
  • 避免使用平台特有类型（如 NSImage）
  • 关系深度限制在 3 层以内
  • 单个实体属性不超过 1MB

7. 调试友好设计

• 诊断属性添加：

  @Model class DebuggableModel {
      var createdAt = Date()  // 自动记录创建时间
      var lastModified = Date()  // 跟踪修改时间
  }
  
• 实现自定义描述：

  @Model class CustomDebugModel {
      func modelDescription() -> String {
          return "\(name) (ID: \(id))"
      }
  }
  

8. 文档化规范

• 模型注释模板：

  /// 用户核心数据模型
  /// - 关系: 1对多关联订单(Order)
  /// - 版本: 自v1.2起添加lastLoginDate
  @Model final class User {
      //...
  }
  

最佳实践提示：定期使用 ModelContext.rollback() 测试模型在失败场景下的行为，确保数据一致性。