Sailing 之 业务逻辑模型

Sailing

EntityPath

EntityPath一个从当前上下文实体出发, 指向某个或某组字段的路径说明.
EntityPath有两大应用场景.
1. 作用在实体对象时, 用来访问具体的某个或某组字段, 数组, 对象. 主要用于脚本中的对象访问;
2. 作用在实体元数据时, 用来指向元数据中的某个位置. 主要用于UI和字段的绑定;

以下分这两种应用场景来说明使用方法

作用于对象 对象路径

• 空字符串: 表示当前上下文代表的实体. 上下文只能是字段(已经是终结点, 只能再次应用空字符串), 对象, 数组中的一种.
• 属性名: 表示当前上下文中的某个属性字段.
  如果这个字段是基本类型, 就表示该基本类型值; 如果字段是对象, 就表示该对象; 如果是数组, 就表示该数组;
• 属性名[索引号]: 如果属性名指向的值是数组, 那么可以通过索引号来指向数组元素;
• 属性名A.属性名B: 路径的含义需要视属性名A指向的值的类型而定:
  
  • 如果属性名A指向的值是基本类型: 则路径非法;
  • 如果属性名A指向的值是对象: 那么相当于将后续路径的上下文切换到该对象上;
  • 如果属性名A指向的值是数组: 那么相当于遍历每个数组元素, 并以当前元素为上下文对后续路径求值, 结果再合并成一个数组;
• 属性名A[索引号].属性名B: 属性名A指向的值必须为数组, 否则路径非法;
  含义相当于将属性名B的求值上下文切换到属性名A[索引号]指向的数组元素;

也就是说, 实体路径一定代表着某个值, 这个值可以是基本类型, 对象和数组; 其中数组也可能是多级flatten而来.

作用于元数据 元数据路径

• 空字符串: 表示当前上下文代表的元数据. 上下文只能是Entity, Element中的一种;
• 属性名: 表示当前上下文中的某个属性.

• 属性名A.属性名B: 首先将上下文切换到属性名A指向的属性背后的实体, 具体来说:

  • Field: 非法的切换;
  • Element: 切换到Element中;
  • Sibling: 切换到Entity中;
  • Parent: 切换到Entity中;
  • Children: 切换到集合元素的Entity中;

  然后在切换后的上下文中对属性名B求值;

也就是说, 实体元数据路径包含了两层含义:
1. 指向的属性位置(空字符串除外).
2. 指向的属性位置背后对应的类型, 只有三种可能性: Field, Element, Entity.

由上可知, 对象路径和元数据路径的区别有:
- 对象路径代表值; 元数据路径代表属性(或者空路径代表的Entity, Element);
- 对待数组时, 对象路径可以指明数组中的某个元素, 也可以指明元素中更深的路径的flatten;
而元数据路径只能指定children实体中的路径;

两种路径的转换

• 对象路径 -> 元数据路径: 对象路径中, 去除所有的索引表达式后剩下的, 就是对象值对应的元数据路径;
• 元数据路径 -> 对象路径: 元数据路径直接应用于对象, 相当于:
  
  1. 遇到对象, 则深入切换上下文;
  2. 遇到数组, 则flatten;