SAP Spartacus SSR 中的 shimming 实现的一个例子

Angular 开发人员使用 HttpClient 与后台服务器交互。SAP Spartacus Storefront 支持服务器端渲染即 SSR，那么工作在 SSR 模式下的 Spartacus，又是通过什么方式调用的 OCC API 呢？

通用应用程序(Universal applications)使用 Angular 平台服务器包(platform-server)（与平台浏览器 platform-browser相对），它提供 DOM、XMLHttpRequest 和其他不依赖浏览器的底层特性的服务器端实现。

服务器（在 Angular 官网例子中使用的是 Node.js Express）将客户端对应用程序页面的请求传递给 NgUniversal ngExpressEngine。 在底层，该引擎调用 Universal 的 renderModule() 函数，同时提供缓存和其他有用的实用程序。

renderModule() 函数将模板 HTML 页面（通常是 index.html）、包含组件的 Angular 模块和确定要显示哪些组件的路由作为输入。路由来自客户端对服务器的请求。

下图是 SAP Spartacus AppServerModule，我们可以看到他导入了来自 @angular/platform-server 开发包的 ServerModule 和 ServerTransferStateModule 这两个 NgModule：

在 Spartacus 源代码里，虽然从 @angular/platform-server 导入了 renderModule 函数，但是没有在我们的代码里显式调用它。

renderModule() 函数将模板 HTML 页面（通常是 index.html）、包含 Component 的 Angular modules 和确定要显示哪些组件的路由作为输入。路由来自客户端对服务器的请求。

每个请求都会为请求的路由生成适当的视图。renderModule() 函数在模板的 标记内渲染视图，为客户端创建一个完整的 HTML 页面。

由于通用应用程序不在浏览器中执行，因此服务器上可能缺少某些浏览器 API 和功能。

例如，服务器端应用程序不能引用仅限浏览器的全局对象，例如窗口、文档、导航器或位置。

Angular 为这些对象提供了一些可注入的抽象，例如 Location 或 DOCUMENT； 它可能会充分替代这些 API。 如果 Angular 不提供它，则可以编写新的抽象，在浏览器中委派给浏览器 API，在服务器上委派给替代实现（也称为 shimming）。

下面是 SAP Spartacus 使用可注入抽象的一个例子：

1. 从 @angular/common 包中导入 DOCUMENT:

2. 通过构造函数进入注入：

3. 在应用代码中使用：