Spring Data JPA

在 ChatGPT 中打开

Spring Data JPA 是 Spring 应用程序中数据访问的事实标准，提供了存储库抽象、查询方法以及复杂查询的规范。webforJ 的 SpringDataRepository 适配器将 Spring Data 存储库与 webforJ 的 UI 组件连接起来，使您能够将 JPA 实体直接绑定到 UI 组件，实现动态过滤 JPA 规范，并处理分页。

该适配器检测您的存储库实现了哪些 Spring Data 接口——无论是 CrudRepository、PagingAndSortingRepository 还是 JpaSpecificationExecutor——并自动在您的 UI 中提供相应的功能。这意味着您现有的 Spring Data 存储库可以在不修改的情况下与 webforJ 组件一起工作，同时保持类型安全，并使用您现有的域模型。

了解更多关于 Spring Data JPA 的信息

要全面理解 Spring Data JPA 的功能和查询方法，请参见 Spring Data JPA 文档。

使用 SpringDataRepository

SpringDataRepository 类将 Spring Data JPA 存储库与 webforJ 的 Repository 接口连接起来，使其与 Table 等 UI 组件兼容，同时保留所有 Spring Data 功能。

// 您的 Spring Data 存储库
@Autowired
private PersonRepository personRepository;

// 使用 SpringDataRepository 包装它
SpringDataRepository<Person, Long> adapter = new SpringDataRepository<>(personRepository);

// 与 webforJ 表一起使用
Table<Person> table = new Table<>();
table.setRepository(adapter);

接口检测

Spring Data 存储库使用接口继承来添加功能。您可以从基本 CRUD 操作开始，并添加用于分页或规范的接口：

// 仅基本 CRUD
public interface CustomerRepository extends CrudRepository<Customer, Long> {}

// CRUD + 分页 + 排序
public interface CustomerRepository extends PagingAndSortingRepository<Customer, Long> {}

// 全功能存储库
public interface CustomerRepository extends JpaRepository<Customer, Long>, JpaSpecificationExecutor<Customer> {}

SpringDataRepository 检查您的存储库实现了哪些接口，并相应地调整其行为。如果您的存储库支持分页，则适配器启用分页查询。如果它实现了 JpaSpecificationExecutor，您可以使用规范进行动态过滤。

存储库功能

每个 Spring Data 接口添加特定功能，SpringDataRepository 可以使用这些功能：

• CrudRepository - 基本操作：save、delete、findById、findAll
• PagingAndSortingRepository - 添加分页查询和排序
• JpaRepository - 将 CRUD 和分页/排序与批量操作结合
• JpaSpecificationExecutor - 使用 JPA 规格进行动态查询

创建 Spring Data 存储库

为了与 webforJ 组件最大程度的兼容，请创建同时实现 JpaRepository 和 JpaSpecificationExecutor 的存储库：

PersonRepository.java

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.JpaSpecificationExecutor;
import org.springframework.stereotype.Repository;

@Repository
public interface PersonRepository
  extends JpaRepository<Person, Long>,
      JpaSpecificationExecutor<Person> {
  // 自定义查询方法可以放在这里
}

这种组合提供：

• 按 ID 查找操作
• 最优性能的分页
• 排序能力
• Java 持久化 API 规格过滤
• 有和没有过滤器的计数操作

与 Table 一起工作

以下示例使用扩展了 JpaRepository 和 JpaSpecificationExecutor 的 PersonRepository。这种组合使得通过列头进行排序和使用规格进行动态过滤成为可能。

TableView.java

@Route
public class TableView extends Composite<Div> {
  private SpringDataRepository<Person, Long> repository;
  private Table<Person> table = new Table<>();

  public TableView(PersonRepository personRepository) {
    // 为 webforJ 包装 Spring Data 存储库
    repository = new SpringDataRepository<>(personRepository);

    // 连接到表
    table.setRepository(repository);

    // 定义列
    table.addColumn("name", Person::getFullName)
          .setPropertyName("firstName"); // 按实际 JPA 属性排序
    table.addColumn("email", Person::getEmail);
    table.addColumn("age", person ->
          person.getAge() != null ? person.getAge().toString() : "");
    table.addColumn("city", Person::getCity);
    table.addColumn("profession", Person::getProfession);

    // 启用排序
    table.getColumns().forEach(column -> column.setSortable(true));
  }
}

setPropertyName() 方法对于排序非常重要——它告诉适配器在按该列排序时在 ORDER BY 子句中使用哪个 JPA 属性。如果没有它，基于计算的属性如 getFullName() 的排序将无法正常工作。

使用 JPA 规格进行过滤

SpringDataRepository 使用 JPA 规格进行动态查询，并将其应用于存储库的 findBy 和 count 操作。

了解更多关于过滤的信息

要理解使用 webforJ 存储库的过滤工作原理，包括基本过滤器和过滤器组成，请参见 Repository 文档。

// 按城市过滤
Specification<Person> cityFilter = (root, query, cb) ->
  cb.equal(root.get("city"), "New York");
repository.setFilter(cityFilter);

// 多个条件
Specification<Person> complexFilter = (root, query, cb) ->
  cb.and(
    cb.equal(root.get("profession"), "Engineer"),
    cb.greaterThanOrEqualTo(root.get("age"), 25)
  );
repository.setFilter(complexFilter);

// 清除过滤器
repository.setFilter(null);