【手写 Vuex 源码】第十篇 - Vuex 命名空间的实现

news2024/12/28 5:33:29

一，前言

上一篇，主要介绍了 Vuex 响应式数据和缓存的实现，主要涉及以下几个点：

Vuex 的响应式实现原理；
响应式核心方法 resetStoreVM；
commit 和 dispatch 的处理；

本篇，继续介绍 Vuex-namespaced 命名空间的实现；

二，前文梳理

之前几篇，完成了 Vuex 的模块收集、模块安装、响应式数据和缓存；

模块收集：通过 ModuleCollection 类，对 options 选项进行处理，构建“模块树”；
模块安装：处理“模块树”，将各模块中 mutation、action、getter，注册到 store 实例上：_actions、_mutations、_wrappedGetters；将各模块的 State 状态通过 Vue.set 注册到根状态；
响应式数据和缓存：通过resetStoreVM在 store 实例中创建一个 Vue 实例，借助 Vue 能力将 state、getter 通过 data、computed 进行定义，实现数据的响应式和缓存；

接下来，继续实现 namespaced 命名空间功能；

三，命名空间的使用

1，命名空间介绍

前面已经简单介绍过：在子模块对象中添加 namespaced：true，为模块开启命名空间功能；

开启命名空间功能，相当于为每个模块添加独立的作用域，实现模块间状态和事件的隔离；

2，命名空间的使用

使用官方的 Vuex 插件，以“根模块->模块 A->模块 C”的父子模块关系为例，测试多种使用场景：

1）模块 A 和模块 C 都启用了 namespaced 命名空间：

此时，模块 C 的 changeNum：moduleA/moduleC/changeNum；

2）模块 A 启用了命名空间，但模块 C 没启用命名空间：

此时，模块 C 的 changeNum：moduleA/changeNum；

3）模块 C 启用了命名空间，但模块 A 没启用命名空间：

此时，模块 C 的 changeNum：moduleＣ/changeNum；

三，命名空间的实现

1，命名空间的逻辑分析

根据测试情况分析命名空间的划分规则：

在模块注册阶段，会通过类似发布订阅的方式将各模块中的 action、mutation 进行手机并注册，需要根据模块是否开启命名空间状态，为模块拼接命名空间前缀；

所以，可以统一理解为，在事件订阅时，为事件添加对应命名空间标识即可；

2，命名空间的代码实现

在 installModule 模块安装阶段，获取当前模块的命名空间：

// src/vuex/store.js#installModule

/**
 * 安装模块
 * @param {*} store       容器
 * @param {*} rootState   根状态
 * @param {*} path        所有路径
 * @param {*} module      格式化后的模块对象
 */
const installModule = (store, rootState, path, module) => {
  // 根据当前模块的 path 路径，拼接当前模块的命名空间标识
  let namespace = store._modules.getNamespaced(path);
}

为 ModuleCollection 类添加 getNamespaced 方法：

// src/vuex/module/module-collection.js

class ModuleCollection {
  constructor(options) {
    this.register([], options);
  }
  /**
   * 根据当前模块的 path 路径，拼接当前模块的命名空间标识
   * @param {*} path 
   * @returns 
   */
  getNamespaced(path) {
    let root = this.root;
    // 从根模块开始，逐层处理子模块，拼接命名空间标识
    return path.reduce((str, key) => {
      // 从根模块查找当前子模块
      root = root.getChild(key);
      // 若子模块启用命名空间，拼接命名空间标识并返回结果继续处理
      return str + (root.namespaced ? key + '/' : '')
    }, '');
  }
}

测试getNamespaced获取命名空间：

模块 A、B 都开启命名空间的情况：

模块 A 不开启命名空间，模块 C 开启命名空间的情况：

结论与官方 Vuex 插件相同；

拿到了命名空间后，就需要在注册事件时，为其添加对应的命名空间标识；

在模块安装注册时，为事件添加命名空间标识:

// src/vuex/store.js#installModule

/**
 * 安装模块
 * @param {*} store       容器
 * @param {*} rootState   根状态
 * @param {*} path        所有路径
 * @param {*} module      格式化后的模块对象
 */
const installModule = (store, rootState, path, module) => {

  // 根据当前模块的 path 路径，拼接当前模块的命名空间标识
  let namespace = store._modules.getNamespaced(path);

  if (path.length > 0) {
    let parent = path.slice(0, -1).reduce((memo, current) => {
      return memo[current]
    }, rootState)
    Vue.set(parent, path[path.length - 1], module.state);
  }

  // 遍历 mutation
  module.forEachMutation((mutation, key) => {
		// 添加命名空间标识: namespace + key
    store._mutations[namespace + key] = (store._mutations[namespace + key] || []);
    store._mutations[namespace + key].push((payload) => {
      mutation.call(store, module.state, payload);
    })
  })
  // 遍历 action
  module.forEachAction((action, key) => {
    // 添加命名空间标识: namespace + key
    store._actions[namespace + key] = (store._actions[namespace + key] || []);
    store._actions[namespace + key].push((payload) => {
      action.call(store, store, payload);
    })
  })
  // 遍历 getter
  module.forEachGetter((getter, key) => {
    // 添加命名空间标识: namespace + key
    store._wrappedGetters[namespace + key] = function () {
      return getter(module.state);
    }
  })
  module.forEachChild((child, key) => {
    installModule(store, rootState, path.concat(key), child);
  })
}

3，命名空间效果测试

测试示例：

<template>
  <div id="app">
    <br> 根模块测试： <br>
    商品数量: {{this.$store.state.num}} 个<br>
    商品单价: 10 元<br>
    订单金额: {{this.$store.getters.getPrice}} 元<br>
    <button @click="$store.commit('changeNum',5)">同步更新：数量+5</button>
    <button @click="$store.dispatch('changeNum',-5)">异步更新：数量-5</button>

    <br> 子模块测试： <br>
    A 模块-商品数量: {{this.$store.state.moduleA.num}} 个<br>
    B 模块-商品数量: {{this.$store.state.moduleB.num}} 个<br>
    C 模块-商品数量: {{this.$store.state.moduleA.moduleC.num}} 个<br>
    <button @click="$store.commit('moduleA/changeNum',5)">A 模块-同步更新：数量+5</button>
    <button @click="$store.commit('moduleB/changeNum',5)">B 模块-同步更新：数量+5</button>
    <button @click="$store.commit('moduleA/moduleC/changeNum',5)">C 模块-同步更新：数量+5</button>
  </div>
</template>