介绍
说来惭愧,这对于喜欢摸鱼的程序员来说,vue3都发布这么久了,现在才开始阅读vuex3源码,现在分享一下个人对这次学习的总结,写的不好请大家轻喷。
地址
源码地址:vuejs/vuex@3.6.2
myGithub:2460392754/mini-vuex3
项目结构
src├── core│ ├── helpers.ts│ ├── index.ts│ └── store.ts├── types│ └── index.ts├── utils│ ├── index.ts│ ├── isModuleType.ts│ ├── reactive.ts│ └── register.ts└── index.ts
实现
1 基本
1.1 注册
使用class
的static
属性进行创建一个名为install
的静态方法, 用于Vue.use
注册插件。
插件注册时把当前环境的vue
对象引用保存下来,确保项目和插件使用的是同一个引用对象。因为需要利用项目中的data
功能来辅助state
和getters
值更新后触发视图更新。
github: mini-vuex3/src/core/store.ts#L6-L23
import type { VueConstructor } from 'vue';// 保存当前vue引用, 确保和项目使用相同的引用let _vue: VueConstructor;export class store { /** * 插件注册 * @param vue */ static install(vue: VueConstructor) { _vue = vue; } // do something...}
1.2 实例化
通过class
的构造函数进行初始化。
(Tips: registerState
和registerGetters
会在后面的实例属性里讲到)
github: mini-vuex3/src/core/store.ts#L40-L59
import type Vue from 'vue';import type { StoreOpts } from '../types';// 保存当前vue引用, 确保和项目使用相同的引用let _vue: VueConstructor;export class store { private _vm: Vue = null; private _mutations = null; private _actions = null; private _modules = null; getters = null; constructor(opts: StoreOpts) { // 添加 原型属性,指向当前store实例化后的对象 _vue.prototype.$store = this; // _state对象 响应式处理, 需要通知项目视图更新 this._vm = new _vue({ data() { return { _state: registerState(opts), }; }, }); this.getters = registerGetters(this.state, opts || {}); this._mutations = opts.mutations || {}; this._actions = opts.actions || {}; this._modules = opts.modules || {}; registerModules(this._mutations, this._actions, this._modules); }}
registerModules
使用 es6 中Reflect
特性进行修改对象的键名模拟私有对象, 例如: { A: 'a' }
=> { _A: 'a' }
。
把规范化后moduels.[NAME].mutations
和moduels.[NAME].actions
对象进行合并。
github: mini-vuex3/src/utils/register.ts#L57-L84
/** * 注册 modules */export function registerModules(mutations: Mutations, actions: Actions, modules: Modules) { Object.keys(modules).forEach((key) => { const module = modules[key] as Module & { _actions: Actions; _mutations: Mutations; }; // 修改键名 Reflect.set(module, '_actions', module.actions); Reflect.set(module, '_mutations', module.mutations); Reflect.deleteProperty(module, 'actions'); Reflect.deleteProperty(module, 'mutations'); let moduleActions = module._actions; let moduleMutations = module._mutations; if (module.namespaced === true) { moduleMutations = setModuleNameDataKey(module.name, moduleMutations); moduleActions = setModuleNameDataKey(module.name, moduleActions); } Object.assign(mutations, moduleMutations); Object.assign(actions, moduleActions); });}/** * 修改 modules 中对象的键名, 使用 module.name 追加拼接 * @param moduleName * @param data * @returns */function setModuleNameDataKey(moduleName: string, data: { [key: string]: Function }) { const res = {}; Object.keys(data).forEach((key) => { const newKey = moduleName + '/' + key; res[newKey] = data[key]; }); return res;}
2 实例属性
2.1 state 属性
github: mini-vuex3/src/core/store.ts#L28-L51
export class store { /** * 设置 state的get访问器 */ get state(): State { return this._vm.$data._state; } /** * 设置 state的set访问器 * 禁止直接写入数据 */ set state(v: any) { throw new Error("can't set state: " + v); } constructor(opts: StoreOpts) { // _state对象 响应式处理, 需要通知项目视图更新 this._vm = new _vue({ data() { return { _state: registerState(opts), }; }, }); // do something... } // do something...}
registerState
把module.[NAME].state
合并到state
中
github: mini-vuex3/src/utils/register.ts#L22-L35
/** * 注册 state * @param opts * @returns */export function registerState(opts: StoreOpts) { const moduleStates = {}; Object.values(opts.modules || {}).forEach((module) => { moduleStates[module.name] = module.state || {}; }); return Object.assign(moduleStates, opts.state || {});}
2.2 getters 属性
github: mini-vuex3/src/core/store.ts#L53
export class store { constructor(opts: StoreOpts) { this.getters = registerGetters(this.state, opts || {}); // do something... } // do something...}
registerGetters
把module.[NAME].getters
合并到getters
中, 并通过Object.defineProperty
劫持getters
中所有对象,转换成响应式类型。
github: mini-vuex3/src/utils/register.ts#L37-L55
/** * 注册 getters */export function registerGetters(state: State, opts: StoreOpts) { const getters: any = {}; reactiveGetters(opts.getters, state, getters); Object.values(opts.modules || {}).forEach((module) => { if (module.namespaced === true) { const newGetters = setModuleNameDataKey(module.name, module.getters); reactiveGetters(newGetters, state[module.name], getters); } else { reactiveGetters(module.getters, state[module.name], getters); } }); return getters;}/** * 劫持 getters 对象,处理成响应式内容 * @param getters * @param state * @param res */export function reactiveGetters(getters: Getters, state: State, res: { [key: string]: string }) { for (let key in getters) { Object.defineProperty(res, key, { get: () => { return getters[key](state); }, set(key) { console.error(`Cannot set getters ${key}`); }, }); }}
3 实例方法
3.1 commit 方法
访问namespaced
为true
的modules
对象时, 修改state
对象范围。
github: mini-vuex3/src/core/store.ts#L61-L85
export class store { // do something... commit(type: string, payload: Payload) { const func: Mutation = this._mutations[type]; let state: State; // 未定义属性 if (typeof func === 'undefined') { throw new Error(`unknown mutation type: ${type}`); } if (isModuleType(type)) { const name = type.split('/')[0]; const module = this._modules[name]; state = module.state; } else { state = this.state; } func.call(this, state, payload); }}
3.2 dispatch 方法
访问namespaced
为true
的modules
对象时, 修改函数内this
的commit
和dispatch
作用域范围和对应的store
内容。
github: mini-vuex3/src/core/store.ts#L87-L116
export class store { // do something... dispatch(type: string, payload: Payload) { const func: Action = this._actions[type]; let store: any; // 未定义属性 if (typeof func === 'undefined') { throw new Error(`unknown action type: ${type}`); } if (isModuleType(type)) { const name = type.split('/')[0]; const module = this._modules[name]; store = module; // 修改作用域范围 Object.assign(store, { commit: this.commit.bind(store), dispatch: this.dispatch.bind(store), }); } else { store = this; } func.call(this, store, payload); }}
4 辅助函数
4.1 mapState 方法
github: mini-vuex3/src/core/helpers.ts#L52-L92
import type { VueConstructor } from 'vue';// 保存当前vue引用, 确保和项目使用相同的引用let _vue: VueConstructor;export class store { /** * 插件注册 * @param vue */ static install(vue: VueConstructor) { _vue = vue; } // do something...}0
4.2 mapGetters 方法
github: mini-vuex3/src/core/helpers.ts#L94-L119
import type { VueConstructor } from 'vue';// 保存当前vue引用, 确保和项目使用相同的引用let _vue: VueConstructor;export class store { /** * 插件注册 * @param vue */ static install(vue: VueConstructor) { _vue = vue; } // do something...}1
4.3 mapMutations 方法
github: mini-vuex3/src/core/helpers.ts#L121-L152
import type { VueConstructor } from 'vue';// 保存当前vue引用, 确保和项目使用相同的引用let _vue: VueConstructor;export class store { /** * 插件注册 * @param vue */ static install(vue: VueConstructor) { _vue = vue; } // do something...}2
4.4 mapActions 方法
github: mini-vuex3/src/core/helpers.ts#L154-L200
import type { VueConstructor } from 'vue';// 保存当前vue引用, 确保和项目使用相同的引用let _vue: VueConstructor;export class store { /** * 插件注册 * @param vue */ static install(vue: VueConstructor) { _vue = vue; } // do something...}3
最后
手写一个 mini-vuex3 相对来说还是比较容易的,还是需要多看、多学、多写。
地址
原文:https://juejin.cn/post/7096027084455149581