头图

SAP Commerce Cloud Spartacus UI 的 ActionClass 数据结构设计

JerryWang_汪子熙

以 CmsSetPageSuccessIndex 为例:

运行时该 Action 类包含三大字段:

(1) meta
(2) payload
(3) type

meta

meta 包含的 loader 字段和 meta 本身都是一个 object.

meta.entityId 和 entityType 是该 action payload 的标识位。

loader 表明该 entity 加载状况。

payload

包含的业务数据:

type

字符串类型。

从 上图 Prototype 能看出,CmsSetPageSuccessIndex 的原型链类为 EntitySuccessAction.

这一点也能从其实现代码看出:

export class CmsSetPageSuccessIndex extends StateUtils.EntitySuccessAction {
  readonly type = CMS_SET_PAGE_SUCCESS_INDEX;
  constructor(pageContext: PageContext, payload: Page) {
    super(pageContext.type, pageContext.id, payload);
  }
}

查看 EntitySuccessAction 的实现:

属性1,meta 属性,定义在该类里。
属性2,payload,通过构造函数参数定义。
属性3,type,定义在上图81行,然后被 CmsSetPageSuccessIndex 重载。

EntitySuccessAction 构造函数接收三个参数:entityType,id 和 payload.

通过 entityType 和 id,生产出 meta 字段。

entitySuccessMeta 可以看成一个构造器或者工厂函数:

根据 entityType 和 id,生产出 EntityLoaderMeta, 后者是 EntityMeta 和 LoaderMeta 的联合。


export interface EntityMeta {
  entityType: string;
  entityId: string | string[];
  entityRemove?: boolean;
}

export interface LoaderMeta {
  entityType: string;
  loader: {
    load?: boolean;
    error?: any;
    success?: boolean;
  };
}

采用三个点的语法,是因为这两个 interface,都有同名字段:entityType

LoaderMeta 的运行时数据,通过构造器 loadMeta 制造:

export function loadMeta(entityType: string): LoaderMeta {
  return {
    entityType: entityType,
    loader: {
      load: true,
    },
  };
}

EntityMeta 字段的值,通过 entityMeta 构造:


export function entityMeta(type: string, id: string | string[]): EntityMeta {
  return {
    entityType: type,
    entityId: id,
  };
}

运行时通过 PageEffect 从 Commerce Cloud 后台读取 CMS 数据成功后,新建 ActionClass,将负载通过构造函数参数传入。

更多Jerry的原创文章,尽在:"汪子熙":

阅读 138

Jerry Wang的SAP技术专栏
SAP成都研究院开发专家,SAP社区导师,SAP中国技术大使

Jerry 2007年从电子科技大学计算机专业硕士毕业后进入SAP成都研究院工作至今, SAP社区导师,SAP中国技术...

743 声望
997 粉丝
0 条评论
你知道吗?

Jerry 2007年从电子科技大学计算机专业硕士毕业后进入SAP成都研究院工作至今, SAP社区导师,SAP中国技术...

743 声望
997 粉丝
宣传栏