Skip to content

自动推测 AUTO ​

不指定 type 时,Erupt 会根据 Java 字段类型自动推断使用哪种编辑组件。

auto

字段类型映射组件
Integer / Float / Double 等数值类型EditType.NUMBER
BooleanEditType.BOOLEAN
Date / LocalDate / LocalDateTime / LocalTimeEditType.DATE,子类型由 Java 类型决定(2.4.0+)
Java 枚举EditType.CHOICE,选项为枚举常量(2.4.0+)
@Erupt 实体目标声明了树 pid 则 REFERENCE_TREE,否则 REFERENCE_TABLE(2.4.0+)
Collection<@Erupt 实体>@ManyToMany 则 TAB_TABLE_REFER,否则 TAB_TABLE_ADD(2.4.0+)
Collection<枚举>EditType.MULTI_CHOICE,选项为枚举常量(2.4.0+)
MapEditType.KEY_VALUE(2.4.0+)
其他EditType.INPUT

基础用法 ​

java
@EruptField(
    edit = @Edit(title = "文本输入") // 相当于 type = EditType.INPUT
)
private String input;

@EruptField(
    edit = @Edit(title = "数值输入") // 相当于 type = EditType.NUMBER
)
private Integer number;

@EruptField(
    edit = @Edit(title = "布尔选择") // 相当于 type = EditType.BOOLEAN
)
private Boolean bool;

@EruptField(
    edit = @Edit(title = "时间选择") // 相当于 type = EditType.DATE
)
private Date date;

按 Java 类型推断 v2.4.0+ ​

2.4.0 起 AUTO 只看字段的 Java 类型,引用、子表、枚举、键值对都不再需要写 type:

Java 类型推断结果
@Erupt 实体目标 @Erupt(tree = @Tree(pid = ...)) 声明了 pid → REFERENCE_TREE,否则 REFERENCE_TABLE
Collection<@Erupt 实体>字段标了 @ManyToMany → TAB_TABLE_REFER,否则 TAB_TABLE_ADD
Collection<枚举>MULTI_CHOICE,选项为枚举常量
MapKEY_VALUE
Java 枚举CHOICE,选项为枚举常量(按常量名,经 i18n 翻译后作为显示文本)
LocalDate / LocalDateTime / LocalTime / DateDATE,并由 DateType.Type.AUTO 进一步决定日期、日期时间或时间,见 日期选择

枚举字段在 @ChoiceType 既没有 vl 也没有 fetchHandler 时,才用枚举常量作为选项;显式声明了选项则以声明为准。

一个没有写任何 type 的模型:

java
@Erupt(name = "订单")
public class Order extends BaseModel {

    @EruptField(edit = @Edit(title = "下单时间"))
    private LocalDateTime created;          // DATE,日期时间

    @EruptField(edit = @Edit(title = "状态"))
    private OrderStatus status;             // CHOICE,选项为 OrderStatus 的常量

    @ManyToOne
    @EruptField(edit = @Edit(title = "客户"))
    private Customer customer;              // REFERENCE_TABLE

    @ManyToOne
    @EruptField(edit = @Edit(title = "所属部门"))
    private Dept dept;                      // REFERENCE_TREE,Dept 声明了 tree.pid

    @OneToMany
    @EruptField(edit = @Edit(title = "明细"))
    private List<OrderItem> items;          // TAB_TABLE_ADD

    @ManyToMany
    @EruptField(edit = @Edit(title = "标签"))
    private List<Tag> tags;                 // TAB_TABLE_REFER

    @JdbcTypeCode(SqlTypes.JSON)
    @EruptField(edit = @Edit(title = "渠道"))
    private Set<Channel> channels;          // MULTI_CHOICE,选项为 Channel 的常量

    @JdbcTypeCode(SqlTypes.JSON)
    @EruptField(edit = @Edit(title = "扩展属性"))
    private Map<String, String> attrs;      // KEY_VALUE

}

TIP

推断只决定 type,referenceTableType / choiceType 等子注解仍可按需追加;显式写了 type 的字段不受推断影响。

贡献者

The avatar of contributor named as YuePeng YuePeng

页面历史

Released under the Apache-2.0 License.