跳至主要内容

仓库 24.00

在 ChatGPT 中打开

Repository模式在webforJ中提供了一种标准化的方式来管理和查询实体集合。它作为UI组件和数据之间的抽象层，使得在维护一致性行为的同时，轻松处理不同的数据源。

为什么使用仓库​

Repository消除了手动更新，同时保持原始数据不变：

// 没有仓库 - 手动更新
List<Customer> customers = loadCustomers();
Table<Customer> table = new Table<>();
table.setItems(customers);

// 添加需要完全重新加载
customers.add(newCustomer);
table.setItems(customers); // 必须重新加载所有内容
// 有仓库 - 自动同步
List<Customer> customers = loadCustomers();
CollectionRepository<Customer> repository = new CollectionRepository<>(customers);
Table<Customer> table = new Table<>();
table.setRepository(repository);

// 添加自动同步
customers.add(newCustomer);
repository.commit(newCustomer); // 只更新已更改的内容

集合仓库​

CollectionRepository是最常见的实现，包装任何Java集合：

// 来自ArrayList
List<Customer> customers = new ArrayList<>();
CollectionRepository<Customer> customerRepo = new CollectionRepository<>(customers);

// 来自HashSet
Set<String> tags = new HashSet<>();
CollectionRepository<String> tagRepo = new CollectionRepository<>(tags);

// 来自任何集合
Collection<Employee> employees = getEmployeesFromHR();
CollectionRepository<Employee> employeeRepo = new CollectionRepository<>(employees);

数据同步​

Repository充当您的数据和UI组件之间的桥梁。当数据发生变化时，您通过commit()方法通知仓库：

List<Product> products = new ArrayList<>();
CollectionRepository<Product> repository = new CollectionRepository<>(products);

// 添加新产品
Product newProduct = new Product("P4", "Gizmo", 79.99, 15);
products.add(newProduct);
repository.commit(); // 所有关联组件更新

// 更新现有产品
products.get(0).setPrice(89.99);
repository.commit(products.get(0)); // 只更新这一特定行

// 删除产品
products.remove(2);
repository.commit(); // 刷新视图

commit方法有两个签名：

  • commit() - 告诉仓库刷新所有内容。它会触发一个RepositoryCommitEvent，包含所有当前数据
  • commit(entity) - 目标是特定实体。仓库通过其关键字查找该实体，仅更新受影响的UI元素
提交单个实体

这一区分对于性能很重要。当您在一个1000行的表中更新一个字段时，commit(entity)只会更新该单元格，而commit()将刷新所有行。

数据过滤​

仓库的过滤器控制传递到连接组件的数据。您的基础集合保持不变，因为过滤器充当透镜：

// 按库存可用性过滤
repository.setBaseFilter(product -> product.getStock() > 0);

// 按类别过滤
repository.setBaseFilter(product -> "Electronics".equals(product.getCategory()));

// 组合多个条件
repository.setBaseFilter(product ->
  product.getCategory().equals("Electronics") &&
  product.getStock() > 0 &&
  product.getPrice() < 100.0
);

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

当您设置过滤器时，Repository：

  1. 将谓词应用于集合中的每个项目
  2. 创建一个匹配项目的过滤流
  3. 通知连接的组件更新其显示

过滤器在您更改之前将持续有效。添加到集合中的新项目会自动根据当前过滤器进行测试。

处理实体键​

仓库需要唯一标识实体以支持find()和commit(entity)等操作。定义实体如何被识别有两种方法：

使用HasEntityKey接口​

在您的实体类上实现HasEntityKey：

public class Customer implements HasEntityKey {
  private String customerId;
  private String name;
  private String email;

  @Override
  public Object getEntityKey() {
    return customerId;
  }

  // 构造函数和getter/setter...
}

// 根据键查找
Optional<Customer> customer = repository.find("C001");

// 更新特定客户
customer.ifPresent(c -> {
  c.setEmail("newemail@example.com");
  repository.commit(c); // 只更新该客户的行
});

使用自定义键提供程序 25.10​

对于您无法或不想实现HasEntityKey的实体（如JPA实体），请使用setKeyProvider()：

@Entity
public class Product {
  @Id
  private Long id;
  private String name;
  private double price;

  // JPA管理的实体
}

// 配置仓库使用getId()方法
CollectionRepository<Product> repository = new CollectionRepository<>(products);
repository.setKeyProvider(Product::getId);

// 现在根据ID查找
Optional<Product> product = repository.find(123L);

选择一种方法​

两种方法都有效，但当：

  • 处理具有@Id字段的JPA实体时
  • 您无法修改实体类时
  • 您需要为不同的仓库使用不同的键策略时，推荐使用setKeyProvider()。

当：

  • 您控制实体类时
  • 键提取逻辑复杂时
  • 您希望实体定义自己的身份时，请使用HasEntityKey。

UI集成​

Repository与数据感知组件集成：

// 创建仓库和表
List<Customer> customers = new ArrayList<>();
CollectionRepository<Customer> repository = new CollectionRepository<>(customers);

Table<Customer> table = new Table<>();
table.setRepository(repository);
table.addColumn("ID", Customer::getId);
table.addColumn("Name", Customer::getName);
table.addColumn("Email", Customer::getEmail);

// 添加数据 - 表格自动更新
customers.add(new Customer("C001", "Alice Johnson", "alice@example.com"));
repository.commit();

下一步​