6.3. 数据访问检查

下面的表格解释框架中不同的机制如何使用数据访问权限约束

实体操作

实体属性

读约束
在数据库检查 (1)

读约束
在内存中检查 (2)

创建/更新/删除
约束

EntityManager

DataManager 在中间件层


(3) (4)


(5)


(4)


(4)

DataManager.secure 在中间件层

DataManager 在客户端层

(3)


(5)

通用 UI 数据感知组件

- (6)

- (6)

- (6)

REST API /entities

REST API /queries

- (7)

REST API /services

- (8)

- (8)

- (8)

注:

1) 在数据库检查的读约束只影响根实体

  1. // 只有在满足 Order 实体的约束情况下才会加载 order
  2. Order order = dataManager.load(Order.class).viewProperties("date", "amount", "customer.name").one();
  3. // 关联的 customer 会被加载,忽略 Customer 实体在数据库检查的约束
  4. assert order.getCustomer() != null;

2) 读约束 checked in memory affects the root entity and all linked entities in the loaded graph.

  1. // 只有在满足 Order 实体的约束情况下才会加载 order
  2. Order order = dataManager.load(Order.class).viewProperties("date", "amount", "customer.name").one();
  3. // 关联的 customer 非空,只有满足了 Customer 实体在内存中检查的约束
  4. if (order.getCustomer() != null) ...

3) DataManager 中的实体操作检查只对根实体生效。

  1. // 加载 Order
  2. Order order = dataManager.load(Order.class).viewProperties("date", "amount", "customer.name").one();
  3. // 关联 customer 会被加载,即便用户没有权限读取 Customer 实体
  4. assert order.getCustomer() != null;

4) 只有在设置了 cuba.dataManagerChecksSecurityOnMiddleware 应用程序属性为 true 时,DataManager 才会在中间件层检查实体操作权限和内存中约束。

5) 只有在设置了 cuba.entityAttributePermissionChecking 应用程序属性为 true 时,DataManager 才检查实体属性权限。

6) UI 组件本身不检查约束,但是当数据是通过标准机制加载时,DataManager 会使用约束。所以,如果实体实例受到某些约束的限制被过滤掉了,相应的 UI 组件还是会显示,但是内容为空。另外,可以将基于 ItemTrackingAction 类的操作与特定的约束相关联,这样只有在选中的实体通过了关联的约束检查之后这个操作才会启用。

7) REST 查询都是只读的。

8) REST 服务方法参数和结果不会被检查,因为要与访问组约束一致。服务中与约束相关的定义是由服务如何加载和保存数据决定的,比如是否使用 DataManagerDataManager.secure()