2. 简单的增删改查

实体仅有几个简单的属性：

如果你的应用程序正在运行，先通过主工具栏的 Stop（）按钮停止运行。

在 Jmix 工具窗口中，点击 New（）→ JPA Entity：

在弹出的 New JPA Entity 对话框中，填写 Step 类名，并选中 Traits → Versioned 复选框：

点击 OK。

Studio 会自动创建实体类，并打开实体设计器：

可以看到，新实体包含两个属性：

下面我们为实体添加 name 属性。

在 Attributes 的工具栏中点击 Add（）。

会弹出 New Attribute 对话框。在 Name 字段输入 name 并选中 Mandatory 复选框：

属性参数中最重要的几个参数如下：

点击 OK。属性列表中会添加 name 属性。

现在我们添加表示完成步骤完成时限的 duration 属性。

在 Attributes 的工具栏中点击 Add（）。在 New Attribute 对话框中，Name 字段输入 duration，Type 字段选择 Integer，并选中 Mandatory 复选框：

点击 OK。属性列表中会添加 duration 属性。

最后，我们添加用于步骤排序的 sortValue 属性。Type 字段选择 Integer，并选中 Mandatory 复选框：

实体的最终状态如下：

可以使用 Attributes 工具栏中的 Up（） / Down（）按钮调整属性的顺序。

切换底部的标签页至 Text，查看设计器生成的实体类源代码：

如果你有 JPA 的经验，可以看到熟悉的注解：@Entity、@Table、@Column 等。还有一些是 Jmix 特定的注解，其中最重要的是类上面的 @JmixEntity。一般来说，Jmix 中的任何 POJO，只要带有 @JmixEntity 注解，都可以作为实体。

实体类的源码可以手动编辑，编辑完后切换回 Designer 标签页，可以同步看到改动。例如，如果删除某个属性的 nullable = false 和 @NotNull，则设计器中会显示 Mandatory 复选框为非选中状态。

实体类完成后，可以为其创建 CRUD（增删查改）界面。

在实体设计器顶部的操作面板中，点击 Screens → Create screen：

界面创建向导的第一步中，选择 Entity browser and editor screen（实体浏览和编辑界面）模板：

Jmix 中，“browser” 表示展示实体列表的界面，“editor” 表示编辑单一实体的界面。

点击 Next。

第二步中，可以为生成的界面选择包和名称：

我们使用建议的默认值，点击 Next。

下一步中，可以设置界面的一些选项：

所有这些选项都可以后续在创建完成的界面中修改，此时，我们直接使用建议的默认值，点击 Next。

然后，可以为浏览界面设置 fetch plan：

由于 Step 实体非常简单，因此无需调整它的 fetch plan。后面我们处理稍微复杂的实体和界面时，再详细了解关于 fetch plan 的内容。

点击 Next。

这里为编辑界面设置 fetch plan：

也无需修改建议使用的 fetch plan，所有属性都已经包含。

点击 Next。

在向导的最后一步中，可以设置界面的标题：

我们直接使用建议的值，点击 Create。

Studio 会生成两个界面：Step.browse 和 Step.edit，并打开相应的源代码。

Studio 界面设计器会展示生成的 Step.browse 界面的 XML 描述文件：

在创建了实体的 CRUD 界面后，你可以运行应用程序查看我们添加的新功能。

与 前一节 一样，点击主工具栏中的 Debug（）按钮启动应用程序。

在运行应用程序之前，Studio 会检查项目数据模型和数据库表结构的差异。由于我们创建了新的实体，Studio 会为对应的改动生成一个 Liquibase 变更日志（创建 STEP 表）：

点击 Save and run。

Studio 会自动在数据库执行这个变更日志：

然后，Studio 会构建并运行应用程序：

应用程序准备好后，在浏览器打开 http://localhost:8080 并使用 admin / admin 凭证登录。

点击主菜单的 Application → Steps，打开 Step.browse 界面：

点击 Create，打开 Step.edit 界面：

我们使用浏览和编辑界面创建一些入职步骤，参数如下：

在本节中，我们创建了应用程序中最简单的功能：入职步骤管理。

学习内容：