视图创建向导

Studio 提供一个向导,可以使用模板创建 视图。使用 Jmix 工具窗口 内的 New → View 菜单可以创建新视图。

wizard create view

向导可以为视图生成基本的代码,包括必要的组件和配置,能节省不少时间。向导提供不同类型视图的模板,包括:

  • 基于实体的视图:展示或编辑与特定 实体 相关的数据

  • 基于 DTO 的视图:展示或编辑 DTO 的数据

  • 其他类型的视图:向导可以创建不关联任何实体的空视图、fragments、带 顶部菜单 的主视图等等。

wizard templates

创建基于实体的视图

如需为一个实体创建 CRUD 视图,可以在树节点中选择实体,然后用右键菜单的 New → View

wizard entity

另一个方式是通过实体设计器 操作面板Views → Create View 进行创建。

create view from entity designer

在向导的 Create Jmix View 页中,选择一个合适的模板。

下一步中,可以修改自动生成的视图属性。

wizard properties

如果勾选 Advanced 中的 Use Data Repositories,并选择了一个已有的 data repository,向导会自动生成 load 和 save 代理,并调用合适的 repository 方法。

Entity list and detail options 步骤中,可以配置视图如何显示并与实体数据交互。

例如,可以配置 DataGrid 的 操作,在列表视图中显示。还可以配置 DataGrid 的多选、列重排列宽修改 等。

wizard view options

点击 Next

Entity list view fetch planEntity detail view fetch plan 步骤中,可以设置视图展示的数据字段。可以使用 内置 的 fetch plan 或创建新的 fetch plan,支持通过 Fetch Plan 设计器编程式 创建。

wizard fetch

点击 Next

向导的最后一步中,可以设置视图的标题。

wizard titles

点击 Create 按钮后,会生成视图的 XML 和 Java 控制器。并更新 消息包 文件。如果是创建了列表视图,还会在主菜单添加一个菜单项。

之后可以使用 视图设计器 进一步配置视图。

创建基于 DTO 的视图

创建基于 DTO 视图的步骤与 创建基于实体的视图 类似。

创建空视图

Blank View 模板可以作为自定义视图的起点。这个模板提供了视图的基本结构,包含最少的组件和逻辑。

当需要完全控制视图的设计和行为时,可以使用此模板。所有必需的组件、布局、数据绑定和事件处理都需要手动添加。

blank view template

之后可以使用 视图设计器 进一步配置视图。

创建空 fragment

Blank Fragment 模板可以创建一个可重用的视图 fragment,fragment 能嵌入到其他视图或 fragment 中。

blank fragment template

点击 Create 按钮后,会生成 fragment 的 XML 和类文件。

之后可以使用 视图设计器 进一步配置 fragment。

创建带顶部菜单的主视图

Jmix 默认提供带列表菜单的主视图。

Studio 的视图创建向导提供了一个带顶部菜单的主视图模板。

如果想用新的主视图替换原来的主视图,需要勾选向导第一步的 Use as default main view

main view top menu template

Studio 会替换所有视图中的 @Route 注解的 layout 属性,并在 jmix.ui.main-view-id 应用程序属性中设置新视图的 id。