实体设计器

Studio 提供一个可视化设计器,用于简化 实体 的创建过程,因此,不需要记住实体创建的所有规则和注解。

此功能需要快速开发版或企业版 订阅。如果没有订阅,请尝试 试用版

使用 Jmix 工具窗口 中的菜单新建实体。

entity tree

在弹出的对话框中输入实体名称并点击 OK

entity create

Studio 为新建的实体展示实体编辑器,其中有三个标签页(底部):

  • Text 包含实体的源代码。

  • Designer 显示实体结构。这里可以为实体添加属性,设置实体名称和验证,这都是通过图形界面完成,不需要编写 Java 代码。

    entity designer
  • Indexes 展示实体的索引,可以创建新索引。

添加属性

可以点击 Designer 标签页中的 + 按钮添加属性,在弹出的对话框中配置属性。下面的示例中,添加了 Attribute typeASSOCIATIONaddresses 属性。这里,对于一对多 引用,需要在 Address 实体中创建反向关联属性。

entity association

Name 字段右侧的地球仪按钮可以支持设置属性的用户友好名称。名称保存在 messages.properties 文件中,UI 组件默认使用这里的名称。

entity message

此外,在 Text 标签页时,通过点击顶部或 Generate 弹窗中的 Add attribute 按钮打开属性创建窗口。

entity generate

创建实例名称

当为实体添加某个属性时,Studio 会自动为实体设置一个 实例名称,这个属性的名称需要是这些之一:nametitlecaptionlabelsummarydescriptionfirstNamelastNamemiddleName

entity instance auto

当需要使用其他属性生成实例名称时,可以使用可视化构建器,通过点击 Instance name 字段的小铅笔按钮打开。

entity instance editor

实例名称也可以在 Text 标签页创建。将光标放置于类的名称上,按下 Alt+Enter(⌥↩)并选择 Add instance name

entity instance text

枚举

Studio 提供一组操作和可视化设计器,能帮助使用枚举。通过 Jmix 工具窗口 中的菜单项创建枚举。

entity tree

当枚举创建完成后,会在编辑器打开枚举类,其中有两个标签页。

entity enum editor
  • Text 包含源代码。

  • Designer 展示枚举设计器,可以配置枚举类型和枚举值,使用图形化界面而无需编写 Java 代码。

Values 表格使用相关按钮设置枚举值常量。

  • Name 列可以输入代码中使用的枚举常量名称。后续可以修改名称而不影响数据库已经存在的值。

  • Value 列可以输入枚举常量的 id。这是存储在数据的实际值。

地球仪按钮可以用来为选中的枚举常量设置本地化名称。

设计器也支持修改枚举使用的 Id 类型,可以在 StringInteger 之间切换。Studio 会自动修复代码中使用的地方。然后,你可以修改枚举常量的值。

这种自动迁移过程不会修改数据库表中已经保存的枚举值,需要手动修改。