SAP Spartacus module 层级结构设计的一种实践

Reference App Structure

这个推荐的 Spartacus 应用程序结构旨在作为您设置自己的 Spartacus 应用程序时的参考。

Spartacus 是一个 Angular 库,这意味着它可以在 Angular 应用程序中单独使用,也可以集成到现有的 Angular 项目中。相反,您可以将任何其他 Angular 解决方案或库添加到您的 Spartacus 项目中。

Spartacus 本身带有多个层和概念,以及一些可以延迟加载开箱即用的较小特征库。自定义和第三方代码进一步增加了复杂性,您最终可能会得到难以维护的模块,因为它们将太多这些元素混合在一起。

这可以通过定义和遵守标准化结构来解决,例如 Spartacus 参考应用程序结构。拥有标准化结构还可以更轻松地将新开发人员纳入您的项目、处理外部支持案例以及进行审计。

通过使用 Spartacus 参考应用程序结构,您可以从每个主要 Spartacus 版本提供的自动迁移中获益最多,同时还保持添加自定义的灵活性,并在这些自定义之上构建新功能。使用参考应用程序结构还可以为 3.0 版本后移入单独库的功能利用代码拆分。

要查看使用参考应用程序结构的工作示例,请参阅此存储库

Spartacus Module

该 module 导入 B2C 或者 B2B 配置 module,以及 BaseStorefrontModule 和 SpartacusFeaturesModule:

SAP Spartacus module 层级结构设计的一种实践

导出 BaseStorefrontModule.

注意,虽然 Angular Router 和 NgRx 都是 Spartacus 使用的,但是这些都会影响全局应用,所以它们被保存在 SpartacusModule 之外,直接导入到 AppModule 中。

SpartacusModule 由以下部分组成:

  • BaseStorefrontModule,它封装了大多数 Spartacus 应用程序通常需要的核心 Spartacus 导入。

BaseStorefrontModule 直接从@spartacus/storefront 导入。

  • SpartacusFeaturesModule,它封装了 Spartacus 功能。
  • SpartacusConfigurationModule,它封装了通用的 Spartacus 配置。

在大多数情况下,Spartacus 模块不会被修改,因为更改通常封装在配置模块或功能模块中。

下面是 SpartacusModule 的实现:

import { NgModule } from '@angular/core';
import { BaseStorefrontModule } from '@spartacus/storefront';
import { SpartacusConfigurationModule } from './spartacus-configuration.module';
import { SpartacusFeaturesModule } from './spartacus-features.module';

@NgModule({
  imports: [
    BaseStorefrontModule,
    SpartacusFeaturesModule,
    SpartacusConfigurationModule,
  ],
  exports: [BaseStorefrontModule],
})
export class SpartacusModule {}

Spartacus Configuration Module

该 Module 包含所有全局的配置元素。

特性特定的配置可以保存在特性模块中,也可以保存在 SpartacusConfigurationModule 中。 将它们保存在功能模块中有助于保持良好的关注点分离,因此通常建议这样做,但如果有助于解决特定问题(例如,通过使用 env 更改配置)。

Spartacus Features Module

SpartacusFeaturesModule 旨在轻松管理所有非核心 Spartacus 功能,包括静态加载和延迟加载。 它充当所有功能的入口点,理想情况下,这些功能被包装到自己的独立功能模块中。

在早期的 3.x 次要版本中,SpartacusFeaturesModule 可能看起来臃肿而忙碌,但随着每个连续的发布,它应该变得更加简洁,因为努力将大部分功能移到单独的库中。

例子:

SAP Spartacus module 层级结构设计的一种实践

SAP Spartacus module 层级结构设计的一种实践

Specific Feature Modules

理想情况下,可以将一个完整的功能封装到一个特定的功能模块中。该模块可以包含与功能相关的配置以及自定义。

以下是具有延迟加载配置的功能模块的示例:

SAP Spartacus module 层级结构设计的一种实践

FeatureModule eager 加载轻量级的 QuickOrderRootModule,然后使用延迟加载,去处理包含了重量级的 Service 和 Component 实现的 QuickOrderModule.

某些 feature module 的启用与否,通过环境变量来决定:

SAP Spartacus module 层级结构设计的一种实践

更多Jerry的原创文章,尽在:"汪子熙":
SAP Spartacus module 层级结构设计的一种实践

上一篇:如何在 SAP Commerce Cloud Portal 构建和部署 SAP Spartacus Storefront


下一篇:使用wkhtmltopdf在JavaScript中嵌入JavaScript