支持 Data Repositories

Data Repository 向导

Studio 提供了一个用于创建和管理 data repositories 的向导。

如需创建一个 repository,点击 Jmix 工具窗口的 New → Data Repository

data repository create

New Jmix Data Repository 对话框中,选择一个实体并点击 OK。Studio 会创建 repository 接口,扩展自 JmixDataRepository,并在主应用程序类上添加 @EnableJmixDataRepositories 注解。

data repository wizard

当在编辑器打开 data repository 时,Studio 在顶部展示带两个按钮的操作面板。Add Derived Method 按钮可以用来创建一个从方法名引申查询语句的方法。Add Query Method 按钮可以用来创建一个带显式指定 JPQL 的方法。

data repository methods

两个方法都会打开特定的对话框,可以进一步配置查询语句和参数。

find method create

对 Repository 中已有的方法,Studio 在侧边栏显示一个 “齿轮” 图标。可以用于调整方法参数,比如添加排序或 fetch plan。也可以将查询语句抽取到 @Query 注解中,并按需修改方法名。

data repository methods gear

工具窗口中的 Data Repository

为特定实体创建的 Data repositories 显示在 Jmix 工具窗口的 Data Repositories 部分。位于实体节点中。

data repository tool window

视图中的 Data Repository

在视图中可以非常便捷地将数据的读写过程代理给 Spring Data repositories。

创建 实体列表视图或详情视图 时,在向导第一步的 Advanced 中,勾选 Use Data Repositories,然后可以从下拉列表中选择一个已有的 data repository。向导会自动生成 load 和 save 的代理,并调用适当的 repository 方法。