Erupt框架中动态控制表单字段显示与编辑的技巧

背景介绍

在Erupt框架的实际开发过程中，我们经常会遇到这样的需求：在添加数据时某些字段不需要显示，但在编辑已有数据时又需要能够修改这些字段。这种场景在业务系统中非常常见，比如创建记录时自动生成的ID字段、系统默认值字段等。

解决方案

Erupt框架提供了灵活的方式来实现这种动态控制字段显示与编辑的需求，主要通过以下两种注解来实现：

1. 使用@Edit注解的readonly属性

通过在字段上添加@Edit(readonly = @Readonly)注解，可以控制字段在特定情况下的只读状态。结合Erupt的条件表达式，可以实现添加时不显示、编辑时可修改的效果。

@EruptField(
    edit = @Edit(
        readonly = @Readonly(
            add = true,
            edit = false
        )
    )
)
private String specialField;

这种配置表示：

• 添加表单时：字段为只读（实际上不会显示）
• 编辑表单时：字段可编辑

2. 使用@Edit注解的showBy属性

对于更复杂的显示逻辑，可以使用showBy属性结合条件表达式来控制字段的显示：

@EruptField(
    edit = @Edit(
        showBy = @ShowBy(
            dependField = "id",
            expr = "value != null"
        )
    )
)
private String conditionalField;

这种配置表示只有当id字段有值（即编辑已有记录）时才会显示该字段。

实际应用场景

1. 自动生成字段：如创建时间、创建人等系统字段，添加时自动生成，编辑时不可修改。

2. 业务状态字段：某些状态字段在创建时使用默认值，后续允许修改。

3. 关联字段：主从表关系中，从表的关联ID在添加时自动关联，编辑时可调整。

最佳实践建议

1. 对于简单的显示/隐藏逻辑，优先使用readonly属性，性能更好。

2. 对于复杂的条件判断，使用showBy属性结合表达式。

3. 可以通过组合使用多个注解属性来实现更精细的控制。

4. 考虑在VO层做字段的显示控制，保持领域模型的纯净。

总结

Erupt框架提供了灵活而强大的字段控制机制，开发者可以根据实际业务需求选择合适的实现方式。理解这些注解的工作原理和组合用法，可以大大提高开发效率，构建出更符合业务需求的用户界面。