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（增删查改）视图。

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

视图创建向导的第一步中，选择 Entity list and detail screen（实体浏览和编辑视图）模板：

点击 Next。

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

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

下一步中，可以设置视图的一些选项：

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

然后，可以为实体列表视图设置 fetch plan：

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

点击 Next。

这里为实体详情视图设置 fetch plan：

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

点击 Next。

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

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

Studio 会生成两个视图：Step.list 和 Step.detail，并打开相应的源代码。

Studio 视图设计器会展示生成的 Step.list 视图的 XML 描述文件：

设计器的主要部分已经在上图中重点提示了。在本向导的后面部分，我们会进一步详细了解。

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

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

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

点击 Save and run。

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

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

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

点击主菜单的 Application → Steps，打开 Step.list 视图：

点击 Create，打开 Step.detail 视图：

我们使用列表和详情视图创建一些入职步骤，参数如下：

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

学习内容：