SAP Spartacus Site Context 实现专题页面(上)

简介: SAP Spartacus Site Context 实现专题页面

Site Context 的实现位于 core\src\ 文件夹之下。

实现总共分下列八大部分:

每个子文件夹内都有一个 barrel fileindex.ts.

site-context.module.ts

绝大多数 import 都是 site-context 文件夹自身的子文件夹提供的:

上图第一行,从 @angular/core 导入 ModuleWithProviders,这是一个包装器:

将 NgModule 与provider关联的 NgModule 的包装器。不推荐使用没有泛型类型的用法。

该 Module 对外只暴露了两个方法:

initSiteContextConfig

注入值:

  • SiteContextConfigInitializer
  • SiteContextConfig

如果 context 的 context 值被填充,那么就返回 SiteContextConfigInitializer 实例,否则返回 null.

第 27 行的 | 代表联合类型。

forRoot

提供 global provider:

这个 forRoot 方法在 base-core.module.ts 的 imports 区域被调用。

config

先查看 index.ts,从三个 TypeScript 文件导入:

export * from './config-loader/site-context-config-initializer';
export * from './context-config-utils';
export * from './site-context-config';

config-loader/site-context-config-initializer.js

还是先看其 import 部分,从 site-context 的上层目录,即 core/src 里导入了:

  • ConfigInitializer
  • BaseSite
  • JavaRegExpConverter
  • WindowRef

实现了 configInitializer 接口。

这个接口定义在 config 文件夹里,包含了字符串数组类型的 scopes 属性,以及 configFactory,后者是一个函数,返回 Config 的 Promise.

Config 是一个纯虚 class:

export abstract class Config {}

所以为了实现该接口,依次定义了 scopes 值为 context 字符串常量,以及调用自己的 resolveConfig 方法,返回一个 promise 对象。

构造函数里注入的三个属性,都是从 config 里导入的。

resolveConfig

调用 baseSiteService,取得所有的 baseSite,然后调用第 40 行的 find 方法,返回满足 predicate 函数的 单个 site 实例:

从错误消息 Error: Cannot get base site config! Current url (${this.currentUrl}) doesn't match any of url patterns of any base sites. 似乎能看出,第 40 行代码根据当前 url 来判断是否能 match 到某个定义好的 base site.


最后,在第 50 行的 map 里,执行 projection,将 baseSite 映射成其配置信息。


getConfig

就是把输入的 source 变量,类型为 BaseSite, 的对应属性返回。

isCurrentBaseSite

将第 79 行通过依赖注入得到的当前 url,currentUrl 同 site 的 urlPatterns 数组做比较,通过正则表达式实现。如果匹配,说明当前 url 代表的就是一个 base site.




getUrlParams

将 OCC 里用的 Storefront 字面量,映射成 Spartacus 里使用的常量 baseSite:

getUrlParams

将 OCC 里用的 Storefront 字面量,映射成 Spartacus 里使用的常量 baseSite

site-context-config.ts (SiteContextConfig 类)

导入了 core/config 文件夹里的 Config 类,这个类是一个纯虚类,源代码 export abstract class Config {}。给其增添了 context 字段。下图第 15 行是 TypeScript 的 Module Argumentation 语法,参考笔者这篇文章。

context-config-utils.ts (两个工具函数)

getContextParameterValues

工具方法,返回 string[], 避免出现 null

getContextParameterDefault

由此可知,返回 Context Parameter 默认参数的逻辑就是,数组里 index 为 0 的元素,就是默认参数。

default-site-context-config (defaultSiteContextConfigFactory)

只有一个 function,负责返回默认的 site context,全是硬编码的 currency 和 language:

这是一个工厂函数,用于 SiteContextModuleforRoot 静态方法里,返回 global providers 定义:

使用工厂函数返回默认 site context 配置:

base-site-config-validator.ts

这个文件比较简单,就包含一个 validator 校验器,没什么复杂逻辑:

export function baseSiteConfigValidator(config: SiteContextConfig) {
  if (getContextParameterDefault(config, BASE_SITE_CONTEXT_ID) === undefined) {
    return 'Please configure context.parameters.baseSite before using storefront library!';
  }
}

检查是否配置了默认的 baseSite.

connectors

包含:

  • site.connector..ts
  • site.adapter.ts
  • converters.ts

converters.ts

还是从 site-context 平级目录导入:

创建几个 normalizer 的 injection token:

convertor 负责把数据模型从后台格式转换成 UI 模式:

site.adapter.ts ( SiteAdapter)

是一个纯虚函数:

在 core 的 occ 文件夹里,SiteAdapter 被 OCCSiteAdapter 实现:

site.connector.ts (SiteConnector)

使用了通过构造函数注入的 SiteAdapter 对应的方法。

events

这里出现了第二个 module:

site-context-event.module.ts

空的 module:

site-context-event.builder.ts (SiteContextEventBuilder)

全部的导入信息:

这里注入了标准的 ActionSubject,来自 @ngrx/store

register 方法

  protected register(): void {
    this.registerSetLanguage();
    this.registerSetCurrency();
  }

registerSetLanguage

相关文章
|
5月前
|
JavaScript 前端开发 数据库
如何在 SAP CRM 里通过 navigation framework 跳转到 ABAP Webdynpro 页面
如何在 SAP CRM 里通过 navigation framework 跳转到 ABAP Webdynpro 页面
|
5月前
|
搜索推荐 UED
Spartacus demo site 选择关键字激活 product variant configuration
Spartacus demo site 选择关键字激活 product variant configuration
|
5月前
|
前端开发
SAP UI5 应用如何使用 iframe 嵌入其他 HTML 页面试读版
SAP UI5 应用如何使用 iframe 嵌入其他 HTML 页面试读版
|
5月前
|
JSON 开发者 数据格式
关于 SAP Spartacus LandingPage2Template 区域的 layout 设计实现
关于 SAP Spartacus LandingPage2Template 区域的 layout 设计实现
|
5月前
|
搜索推荐 开发者 UED
关于 SAP Spartacus 层的 UI 设计
关于 SAP Spartacus 层的 UI 设计
|
5月前
|
开发者 UED
SAP Spartacus BREAKPOINT 枚举类型在 Spartacus layout 实现中的作用
SAP Spartacus BREAKPOINT 枚举类型在 Spartacus layout 实现中的作用
|
5月前
|
前端开发 搜索推荐 开发者
SAP UI5 sap.m.Column 控件的 minScreenWidth 属性介绍
SAP UI5 sap.m.Column 控件的 minScreenWidth 属性介绍
|
5月前
|
JavaScript 前端开发 开发者
SAP UI5 控件 sap.m.ListBase 的 inset 属性的作用介绍
SAP UI5 控件 sap.m.ListBase 的 inset 属性的作用介绍
|
5月前
|
Web App开发 数据采集 前端开发
纯技术讨论:如何让 SAP UI5 应用无法被别人在浏览器里调试 - 这种做法不推荐试读版
纯技术讨论:如何让 SAP UI5 应用无法被别人在浏览器里调试 - 这种做法不推荐试读版
|
5月前
|
XML 存储 数据格式
SAP UI5 控件 customData 属性的应用介绍
SAP UI5 控件 customData 属性的应用介绍