首页
/ Zenstack中实现只读字段的两种方案解析

Zenstack中实现只读字段的两种方案解析

2025-07-01 14:14:17作者:魏献源Searcher

在数据库模型设计中,有时我们需要确保某些字段在创建后不能被修改,这类字段通常被称为"只读字段"。Zenstack作为Prisma的扩展工具,提供了两种不同的方式来实现这一需求。

只读字段的应用场景

只读字段在数据库设计中十分常见,典型的应用场景包括:

  1. 系统自动生成的标识符(如UUID)
  2. 记录创建时间戳
  3. 由系统计算得出的汇总值
  4. 业务上不允许修改的关键数据
  5. 作为分类或类型的固定值字段

方案一:使用字段级策略

Zenstack通过@deny属性提供了细粒度的访问控制。要实现只读字段,可以使用以下语法:

model Product {
  id        Int     @id @default(autoincrement())
  name      String
  category  String  @deny('update', true) @default("electronics")
}

这种方式的优势在于:

  • 明确表达了字段的不可更新性
  • 与Zenstack的权限系统无缝集成
  • 可以与其他策略组合使用
  • 保持了Prisma语法的简洁性

方案二:结合默认值使用

@deny策略可以与@default属性完美配合,实现创建时赋值但禁止后续修改的效果:

model User {
  id          Int     @id @default(autoincrement())
  username    String
  accountType String  @deny('update', true) @default("standard")
}

这种组合特别适合需要初始默认值但又禁止用户修改的场景。

两种方案的比较

特性 @deny('update', true) 潜在@readonly属性
表达性 明确但略显冗长 更简洁直观
灵活性 可组合其他策略 单一功能
学习成本 需理解策略系统 更易理解
兼容性 现有版本支持 需新版本支持

最佳实践建议

  1. 对于简单项目,直接使用@deny('update', true)即可满足需求
  2. 在复杂权限系统中,保持使用策略语法以确保一致性
  3. 如果团队特别需要更简洁的语法,可以考虑向Zenstack提交@readonly属性的功能请求
  4. 重要业务字段建议显式使用@deny策略,提高代码可读性

Zenstack的当前方案已经能够很好地满足只读字段的需求,而是否引入@readonly这样的语法糖则取决于社区的需求和项目的演进方向。

登录后查看全文
热门项目推荐
相关项目推荐