属性容器

InstancePropertyContainer 和 CollectionPropertyContainer 是设计用来处理实体实例和集合，这些实体实例和集合是其他实体的属性。

在 XML 描述中可以这样定义属性容器：

<data>
    <instance id="departmentDc"
              class="ui.ex1.entity.Department"> (1)
        <fetchPlan extends="_base">
            <property name="employees" fetchPlan="_base"/>
        </fetchPlan>
        <loader/>
        <collection id="employeesDc" property="employees"/> (2)
    </instance>
</data>
1 InstanceContainer 保存 Department 的一个实例，实体具有 employee 属性。
2 CollectionPropertyContainer 保存 Employee 的实例集合，而 Employee 实体是 Department 实体的属性。

另外，还可以通过编程的方式创建属性容器：

@Autowired
private DataComponents dataComponents;

private InstanceContainer<Department> departmentDc;
private CollectionPropertyContainer<Employee> employeesDc;


private void createPropertyContainer() {
    employeesDc = dataComponents.createCollectionContainer(
            Employee.class, departmentDc, "employee");
}

方法

属性容器实现了 Nested 接口，这个接口定义了获取主容器方法，以及获取此属性容器绑定的主容器属性名称的方法。在 Department 和 Employee 实体的例子中，主容器是用来存储 Department 实例的容器。

InstancePropertyContainer 可以直接跟主实体的属性交互。也就是说，如果调用 setItem() 方法，这个值会直接设置到相应主实体的属性，同时主实体的 ItemPropertyChangeEvent 监听器会被触发。

CollectionPropertyContainer 包含主集合的拷贝，它的方法行为如下：

  • getMutableItems() 返回实体的可变列表，对列表的改动都会反映到主实体的属性。也就是说，如果从列表中删除了一项，主实体的属性也会更改，主容器的 ItemPropertyChangeEvent 监听器会触发。

  • getDisconnectedItems() 返回实体的可变列表，但是这个列表内的改动不会反映到主实体的属性。也就是说如果从这个列表中删除了一项，主实体属性不变。

  • setItems() 为容器设置实体集合，同时也设置给了关联的主属性。因此，主容器的 ItemPropertyChangeEvent 监听器会被触发。

  • setDisconnectedItems() 为容器设置实体集合，但是底层关联的主属性不变。

getDisconnectedItems() 和 setDisconnectedItems() 方法可以用来暂时改变集合在 UI 的展示，比如对表格做过滤：

@Autowired
private CollectionPropertyContainer<Employee> employeesDc;

private void filterByPosition(Position position) {
    List<Employee> filtered = getEditedEntity().getEmployees().stream()
            .filter(employee -> employee.getPosition().equals(position))
            .collect(Collectors.toList());
    employeesDc.setDisconnectedItems(filtered);
}

private void resetFilter() {
    employeesDc.setDisconnectedItems(getEditedEntity().getEmployees());
}