前端微服务化解决方案2 - Single-SPA

2018-09-02

技术选型

经过各种技术调研我们最终选择的方案是基于 Single-SPA 来实现我们的前端微服务化.

Single-SPA

一个用于前端微服务化的 JavaScript 前端解决方案

使用 Single-SPA 之后,你可以这样做:

(兼容各种技术栈)在同一个页面中使用多种技术框架(React, Vue, AngularJS, Angular, Ember 等任意技术框架),并且不需要刷新页面.
(无需重构现有代码)使用新的技术框架编写代码,现有项目中的代码无需重构.
(更优的性能)每个独立模块的代码可做到按需加载,不浪费额外资源.
每个独立模块可独立运行.

下面是一个微前端的演示页面 (你可能需要科学的上网) https://single-spa.surge.sh/

以上是官方例子,但是官方例子中并没有解决一个问题.就是各种技术栈的路由实现方式大相径庭,如何做到路由之间的协同? 后续文章会讲解,如何解决这样的问题.

单体应用对比前端微服务化

普通的前端单体应用

微前端架构

Single-SPA 的简单用法

1.创建一个 HTML 文件

<html>
  <body>
    <div id="root"></div>
    <script src="single-spa-config.js"></script>
  </body>
</html>

2.创建 single-spa-config.js 文件

// single-spa-config.js
import * as singleSpa from "single-spa";

// 加载react 项目的入口js文件 (模块加载)
const loadingFunction = () => import("./react/app.js");

// 当url前缀为 /react的时候.返回 true (底层路由)
const activityFunction = (location) => location.pathname.startsWith("/react");

// 注册应用
singleSpa.registerApplication("react", loadingFunction, activityFunction);

//singleSpa 启动
singleSpa.start();

封装 React 项目的渲染出口文件

我们把渲染 react 的入口文件修改成这样,便可接入到 single-spa

import React from 'react'
import ReactDOM from 'react-dom'
import singleSpaReact from 'single-spa-react'
import RootComponent from './root.component'

if (process.env.NODE_ENV === 'development') {
  // 开发环境直接渲染
  ReactDOM.render(<RootComponent />, document.getElementById('root'))
}

//创建生命周期实例
const reactLifecycles = singleSpaReact({
  React,
  ReactDOM,
  rootComponent: RootComponent
  domElementGetter: () => document.getElementById('root')
})

// 项目启动的钩子
export const bootstrap = [
  reactLifecycles.bootstrap,
]
// 项目启动后的钩子
export const mount = [
  reactLifecycles.mount,
]
// 项目卸载的钩子
export const unmount = [
  reactLifecycles.unmount,
]