Vue状态管理vuex

转: https://www.cnblogs.com/xiaohuochai/p/7554127.html

前面的话

　　因为多个状态分散的跨越在许多组件和交互间各个角落，大型应用复杂度也常常逐渐增加。为了解决这个问题，Vue提供了vuex。本文将详细介绍Vue状态管理vuex

 

引入

　　当访问数据对象时，一个 Vue 实例只是简单的代理访问。因此，若是有一处须要被多个实例间共享的状态，能够简单地经过维护一份数据来实现共享

const sourceOfTruth = {}
const vmA = new Vue({
  data: sourceOfTruth
})
const vmB = new Vue({
  data: sourceOfTruth
})

　　如今当 sourceOfTruth 发生变化，vmA 和 vmB 都将自动的更新引用它们的视图。子组件们的每一个实例也会经过 this.$root.$data 去访问。如今有了惟一的实际来源，可是，调试将会变为噩梦。任什么时候间，应用中的任何部分，在任何数据改变后，都不会留下变动过的记录。

　　为了解决这个问题，采用一个简单的 store 模式：

var store = {
  debug: true,
  state: {
    message: 'Hello!'
  },
  setMessageAction (newValue) {
    if (this.debug) console.log('setMessageAction triggered with', newValue)
    this.state.message = newValue
  },
  clearMessageAction () {
    if (this.debug) console.log('clearMessageAction triggered')
    this.state.message = ''
  }
}

　　全部 store 中 state 的改变，都放置在 store 自身的 action 中去管理。这种集中式状态管理可以被更容易地理解哪一种类型的 mutation 将会发生，以及它们是如何被触发。当错误出现时，如今也会有一个 log 记录 bug 以前发生了什么

　　此外，每一个实例/组件仍然能够拥有和管理本身的私有状态：

var vmA = new Vue({
  data: {
    privateState: {},
    sharedState: store.state
  }
})
var vmB = new Vue({
  data: {
    privateState: {},
    sharedState: store.state
  }
})

　　[注意]不该该在action中替换原始的状态对象，组件和store须要引用同一个共享对象，mutation才可以被观察

　　接着继续延伸约定，组件不容许直接修改属于 store 实例的 state，而应执行 action 来分发 (dispatch) 事件通知 store 去改变，最终达成了 Flux 架构。这样约定的好处是，可以记录全部 store 中发生的 state 改变，同时实现能作到记录变动 (mutation)、保存状态快照、历史回滚/时光旅行的先进的调试工具

 

概述

　　Vuex 是一个专为 Vue.js 应用程序开发的状态管理模式。它采用集中式存储管理应用的全部组件的状态，并以相应的规则保证状态以一种可预测的方式发生变化。Vuex提供了诸如零配置的 time-travel 调试、状态快照导入导出等高级调试功能

【状态管理模式】

　　下面以一个简单的计数应用为例，来讲明状态管理模式

new Vue({
  el: '#app',
  // state
  data () {
    return {
      count: 0
    }
  },
  // view
  template: `
  <div>
    <span>{{count}}</span>
    <input type="button" value="+" @click="increment">
  </div>
  `,
  // actions
  methods: {
    increment () {
      this.count++
    }
  }
})

　　这个状态自管理应用包含如下几个部分：

state，驱动应用的数据源；
view，以声明方式将 state 映射到视图；
actions，响应在 view 上的用户输入致使的状态变化。

　　下面是一个表示“单向数据流”理念的极简示意：

　　可是，当应用遇到多个组件共享状态时，单向数据流的简洁性很容易被破坏，存在如下两个问题

　　一、多个视图依赖于同一状态

　　二、来自不一样视图的行为须要变动同一状态

　　对于问题一，传参的方法对于多层嵌套的组件将会很是繁琐，而且对于兄弟组件间的状态传递无能为力。对于问题二，常常会采用父子组件直接引用或者经过事件来变动和同步状态的多份拷贝。以上的这些模式很是脆弱，一般会致使没法维护的代码。

　　所以，为何不把组件的共享状态抽取出来，以一个全局单例模式管理呢？在这种模式下，组件树构成了一个巨大的“视图”，无论在树的哪一个位置，任何组件都能获取状态或者触发行为

　　另外，经过定义和隔离状态管理中的各类概念并强制遵照必定的规则，代码将会变得更结构化且易维护。

　　这就是 Vuex 背后的基本思想，借鉴了 Flux、Redux、和 The Elm Architecture。与其余模式不一样的是，Vuex 是专门为 Vue.js 设计的状态管理库，以利用 Vue.js 的细粒度数据响应机制来进行高效的状态更新

【使用状况】

　　虽然 Vuex 能够帮助管理共享状态，但也附带了更多的概念和框架。这须要对短时间和长期效益进行权衡。

　　若是不打算开发大型单页应用，使用 Vuex 多是繁琐冗余的。确实是如此——若是应用够简单，最好不要使用 Vuex。一个简单的 global event bus 就足够所需了。可是，若是须要构建是一个中大型单页应用，极可能会考虑如何更好地在组件外部管理状态，Vuex 将会成为天然而然的选择

 

开始

【安装】

npm install vuex --save

　　在一个模块化的打包系统中，必须显式地经过 Vue.use() 来安装 Vuex

import Vue from 'vue'
import Vuex from 'vuex'

Vue.use(Vuex)

　　当使用全局 script 标签引用 Vuex 时，不须要以上安装过程

【概述】

　　每个 Vuex 应用的核心就是 store（仓库）。“store”基本上就是一个容器，它包含着应用中大部分的状态 (state)。Vuex 和单纯的全局对象有如下两点不一样：

　　一、Vuex 的状态存储是响应式的。当 Vue 组件从 store 中读取状态的时候，若 store 中的状态发生变化，那么相应的组件也会相应地获得高效更新

　　二、不能直接改变 store 中的状态。改变 store 中的状态的惟一途径就是显式地提交 (commit) mutation。这样使得能够方便地跟踪每个状态的变化，从而可以实现一些工具帮助更好地了解应用

【最简单的store】

　　下面来建立一个 store。建立过程直截了当——仅须要提供一个初始 state 对象和一些 mutation

// 若是在模块化构建系统中，请确保在开头调用了 Vue.use(Vuex)
const store = new Vuex.Store({
  state: {
    count: 0
  },
  mutations: {
    increment (state) {
      state.count++
    }
  }
})

　　如今，能够经过 store.state 来获取状态对象，以及经过 store.commit 方法触发状态变动：

store.commit('increment')
console.log(store.state.count) // -> 1

　　经过提交 mutation 的方式，而非直接改变 store.state.count，是由于想要更明确地追踪到状态的变化。这个简单的约定可以让意图更加明显，这样在阅读代码的时候能更容易地解读应用内部的状态改变。此外，这样也有机会去实现一些能记录每次状态改变，保存状态快照的调试工具。有了它，甚至能够实现如时间穿梭般的调试体验。

　　因为 store 中的状态是响应式的，在组件中调用 store 中的状态简单到仅须要在计算属性中返回便可。触发变化也仅仅是在组件的 methods 中提交 mutation

　　下面是一个使用vuex实现的简单计数器

const store = new Vuex.Store({
  state: {
    count: 0
  },
  mutations: {
    increment: state => state.count++,
    decrement: state => state.count--,
  }
})
new Vue({
  el: '#app',
  computed: {
    count () {
      return store.state.count
    }
  },
  // view
  template: `
  <div>
    <input type="button" value="-" @click="decrement">
    <span>{{count}}</span>
    <input type="button" value="+" @click="increment">
  </div>
  `,
  // actions
  methods: {
    increment () {
      store.commit('increment')
    },
    decrement () {
      store.commit('decrement')
    },    
  }
})

 

核心概念

state

【单一状态树】

　　Vuex 使用单一状态树——用一个对象就包含了所有的应用层级状态。至此它便做为一个“惟一数据源 (SSOT)”而存在。这也意味着，每一个应用将仅仅包含一个 store 实例。单一状态树可以直接地定位任一特定的状态片断，在调试的过程当中也能轻易地取得整个当前应用状态的快照

【在VUE组件中得到VUEX状态】

　　如何在 Vue 组件中展现状态呢？因为 Vuex 的状态存储是响应式的，从 store 实例中读取状态最简单的方法就是在计算属性中返回某个状态

// 建立一个 Counter 组件
const Counter = {
  template: `<div>{{ count }}</div>`,
  computed: {
    count () {
      return store.state.count
    }
  }
}

　　每当 store.state.count 变化的时候, 都会从新求取计算属性，而且触发更新相关联的 DOM

　　然而，这种模式致使组件依赖全局状态单例。在模块化的构建系统中，在每一个须要使用 state 的组件中须要频繁地导入，而且在测试组件时须要模拟状态。

　　Vuex 经过 store 选项，提供了一种机制将状态从根组件“注入”到每个子组件中（需调用 Vue.use(Vuex)）：

const app = new Vue({
  el: '#app',
  // 把 store 对象提供给 “store” 选项，这能够把 store 的实例注入全部的子组件
  store,
  components: { Counter },
  template: `
    <div class="app">
      <counter></counter>
    </div>
  `
})

　　经过在根实例中注册 store 选项，该 store 实例会注入到根组件下的全部子组件中，且子组件能经过this.$store访问到。下面来更新下 Counter 的实现：

const Counter = {
  template: `<div>{{ count }}</div>`,
  computed: {
    count () {
      return this.$store.state.count
    }
  }
}

【mapState辅助函数】

　　当一个组件须要获取多个状态时，将这些状态都声明为计算属性会有些重复和冗余。为了解决这个问题，可使用mapState辅助函数帮助生成计算属性

// 在单独构建的版本中辅助函数为 Vuex.mapState
import { mapState } from 'vuex'

export default {
  // ...
  computed: mapState({
    // 箭头函数可以使代码更简练
    count: state => state.count,

    // 传字符串参数 'count' 等同于 `state => state.count`
    countAlias: 'count',

    // 为了可以使用 `this` 获取局部状态，必须使用常规函数
    countPlusLocalState (state) {
      return state.count + this.localCount
    }
  })
}

　　当映射的计算属性的名称与 state 的子节点名称相同时，也能够给 mapState 传一个字符串数组

computed: mapState([
  // 映射 this.count 为 store.state.count
  'count'
])

【对象展开运算符】

　　mapState 函数返回的是一个对象。如何将它与局部计算属性混合使用呢？一般，须要使用一个工具函数将多个对象合并为一个，将最终对象传给 computed 属性。可是自从有了对象展开运算符，能够极大地简化写法：

computed: {
  localComputed () { /* ... */ },
  // 使用对象展开运算符将此对象混入到外部对象中
  ...mapState({
    // ...
  })
}

【组件仍然保有局部状态】

　　使用 Vuex 并不意味着须要将全部的状态放入 Vuex。虽然将全部的状态放到 Vuex 会使状态变化更显式和易调试，但也会使代码变得冗长和不直观。若是有些状态严格属于单个组件，最好仍是做为组件的局部状态

 

Getter

　　有时候须要从 store 中的 state 中派生出一些状态，例如对列表进行过滤并计数：

computed: {
  doneTodosCount () {
    return this.$store.state.todos.filter(todo => todo.done).length
  }
}

　　若是有多个组件须要用到此属性，要么复制这个函数，或者抽取到一个共享函数而后在多处导入它——不管哪一种方式都不是很理想

　　Vuex 容许在 store 中定义“getter”（能够认为是 store 的计算属性）。就像计算属性同样，getter 的返回值会根据它的依赖被缓存起来，且只有当它的依赖值发生了改变才会被从新计算

　　Getter 接受 state 做为其第一个参数：

const store = new Vuex.Store({
  state: {
    todos: [
      { id: 1, text: '...', done: true },
      { id: 2, text: '...', done: false }
    ]
  },
  getters: {
    doneTodos: state => {
      return state.todos.filter(todo => todo.done)
    }
  }
})

　　Getter 会暴露为 store.getters 对象：

store.getters.doneTodos // -> [{ id: 1, text: '...', done: true }]

　　Getter 也能够接受其余 getter 做为第二个参数：

getters: {
  // ...
  doneTodosCount: (state, getters) => {
    return getters.doneTodos.length
  }
}
store.getters.doneTodosCount // -> 1

　　能够很容易地在任何组件中使用它：

computed: {
  doneTodosCount () {
    return this.$store.getters.doneTodosCount
  }
}

　　也能够经过让 getter 返回一个函数，来实现给 getter 传参。在对 store 里的数组进行查询时很是有用

getters: {
  // ...
  getTodoById: (state, getters) => (id) => {
    return state.todos.find(todo => todo.id === id)
  }
}
store.getters.getTodoById(2) // -> { id: 2, text: '...', done: false }

　　若是箭头函数很差理解，翻译成普通函数以下

var getTodoById = function(state,getters){
  return function(id){
    return state.todos.find(function(todo){
      return todo.id === id
    })
  }
}
store.getters.getTodoById(2) // -> { id: 2, text: '...', done: false }

【mapGetters辅助函数】

　　mapGetters 辅助函数仅仅是将 store 中的 getter 映射到局部计算属性：

import { mapGetters } from 'vuex'

export default {
  // ...
  computed: {
  // 使用对象展开运算符将 getter 混入 computed 对象中
    ...mapGetters([
      'doneTodosCount',
      'anotherGetter',
      // ...
    ])
  }
}

　　若是想将一个 getter 属性另取一个名字，使用对象形式：

mapGetters({
  // 映射 `this.doneCount` 为 `store.getters.doneTodosCount`
  doneCount: 'doneTodosCount'
})

 

mutation

　　更改 Vuex 的 store 中的状态的惟一方法是提交 mutation。Vuex 中的 mutation 很是相似于事件：每一个 mutation 都有一个字符串的 事件类型 (type) 和 一个 回调函数 (handler)。这个回调函数就是实际进行状态更改的地方，而且它会接受 state 做为第一个参数：

const store = new Vuex.Store({
  state: {
    count: 1
  },
  mutations: {
    increment (state) {
      // 变动状态
      state.count++
    }
  }
})

　　不能直接调用一个 mutation handler。这个选项更像是事件注册：“当触发一个类型为 increment 的 mutation 时，调用此函数。”要唤醒一个 mutation handler，须要以相应的 type 调用 store.commit 方法：

store.commit('increment')

【提交载荷(Payload)】

　　能够向 store.commit 传入额外的参数，即 mutation 的 载荷（payload）

// ...
mutations: {
  increment (state, n) {
    state.count += n
  }
}
store.commit('increment', 10)

　　在大多数状况下，载荷应该是一个对象，这样能够包含多个字段而且记录的 mutation 会更易读：

// ...
mutations: {
  increment (state, payload) {
    state.count += payload.amount
  }
}
store.commit('increment', {
  amount: 10
})

【对象风格的提交方式】

　　提交 mutation 的另外一种方式是直接使用包含 type 属性的对象

store.commit({
  type: 'increment',
  amount: 10
})

　　当使用对象风格的提交方式，整个对象都做为载荷传给 mutation 函数，所以 handler 保持不变：

mutations: {
  increment (state, payload) {
    state.count += payload.amount
  }
}

【遵照响应规则】

　　既然 Vuex 的 store 中的状态是响应式的，那么当变动状态时，监视状态的 Vue 组件也会自动更新。这也意味着 Vuex 中的 mutation 也须要与使用 Vue 同样遵照一些注意事项：

　　一、最好提早在store中初始化好全部所需属性

　　二、当须要在对象上添加新属性时，应该使用 Vue.set(obj, 'newProp', 123), 或者以新对象替换老对象

　　例如，利用对象展开运算符能够这样写：

state.obj = { ...state.obj, newProp: 123 }

【使用常量替代Mutation事件类型】

　　使用常量替代 mutation 事件类型在各类 Flux 实现中是很常见的模式。这样可使 linter 之类的工具发挥做用，同时把这些常量放在单独的文件中可让代码合做者对整个 app 包含的 mutation 一目了然

// mutation-types.js
export const SOME_MUTATION = 'SOME_MUTATION'
// store.js
import Vuex from 'vuex'
import { SOME_MUTATION } from './mutation-types'

const store = new Vuex.Store({
  state: { ... },
  mutations: {
    // 可使用 ES2015 风格的计算属性命名功能来使用一个常量做为函数名
    [SOME_MUTATION] (state) {
      // mutate state
    }
  }
})

【Mutation必须是同步函数】

　　一条重要的原则就是mutation必须是同步函数

mutations: {
  someMutation (state) {
    api.callAsyncMethod(() => {
      state.count++
    })
  }
}

　　假如正在debug 一个 app 而且观察 devtool 中的 mutation 日志。每一条 mutation 被记录，devtools 都须要捕捉到前一状态和后一状态的快照。然而，在上面的例子中 mutation 中的异步函数中的回调让这不可能完成：由于当 mutation 触发的时候，回调函数尚未被调用，devtools 不知道何时回调函数实际上被调用——实质上任何在回调函数中进行的状态改变都是不可追踪的

【在组件中提交Mutation】

　　能够在组件中使用 this.$store.commit('xxx') 提交 mutation，或者使用 mapMutations 辅助函数将组件中的 methods 映射为 store.commit 调用（须要在根节点注入 store）

import { mapMutations } from 'vuex'

export default {
  // ...
  methods: {
    ...mapMutations([
      'increment', // 将 `this.increment()` 映射为 `this.$store.commit('increment')`

      // `mapMutations` 也支持载荷：
      'incrementBy' // 将 `this.incrementBy(amount)` 映射为 `this.$store.commit('incrementBy', amount)`
    ]),
    ...mapMutations({
      add: 'increment' // 将 `this.add()` 映射为 `this.$store.commit('increment')`
    })
  }
}

 

action

　　在 mutation 中混合异步调用会致使程序很难调试。例如，当能调用了两个包含异步回调的 mutation 来改变状态，怎么知道何时回调和哪一个先回调呢？这就是为何要区分这两个概念。在 Vuex 中，mutation 都是同步事务：

store.commit('increment')
// 任何由 "increment" 致使的状态变动都应该在此刻完成。

　　Action相似于mutation，不一样之处在于：

　　一、Action 提交的是 mutation，而不是直接变动状态

　　二、Action 能够包含任意异步操做

　　下面来注册一个简单的action

const store = new Vuex.Store({
  state: {
    count: 0
  },
  mutations: {
    increment (state) {
      state.count++
    }
  },
  actions: {
    increment (context) {
      context.commit('increment')
    }
  }
})

　　Action 函数接受一个与 store 实例具备相同方法和属性的 context 对象，所以能够调用 context.commit 提交一个 mutation，或者经过 context.state 和 context.getters 来获取 state 和 getters

　　实践中，会常常用到 ES2015 的 参数解构 来简化代码（特别是须要调用 commit 不少次的时候）

actions: {
  increment ({ commit }) {
    commit('increment')
  }
}

【分发Action】

　　Action 经过 store.dispatch 方法触发

store.dispatch('increment')

　　乍一眼看上去感受画蛇添足，直接分发 mutation 岂不更方便？实际上并不是如此，mutation必须同步执行这个限制，而Action 就不受约束，能够在 action 内部执行异步操做

actions: {
  incrementAsync ({ commit }) {
    setTimeout(() => {
      commit('increment')
    }, 1000)
  }
}

　　Actions 支持一样的载荷方式和对象方式进行分发

// 以载荷形式分发
store.dispatch('incrementAsync', {
  amount: 10
})

// 以对象形式分发
store.dispatch({
  type: 'incrementAsync',
  amount: 10
})

　　来看一个更加实际的购物车示例，涉及到调用异步 API 和分发多重 mutation：

actions: {
  checkout ({ commit, state }, products) {
    // 把当前购物车的物品备份起来
    const savedCartItems = [...state.cart.added]
    // 发出结帐请求，而后乐观地清空购物车
    commit(types.CHECKOUT_REQUEST)
    // 购物 API 接受一个成功回调和一个失败回调
    shop.buyProducts(
      products,
      // 成功操做
      () => commit(types.CHECKOUT_SUCCESS),
      // 失败操做
      () => commit(types.CHECKOUT_FAILURE, savedCartItems)
    )
  }
}

　　注意正在进行一系列的异步操做，而且经过提交 mutation 来记录 action 产生的反作用（即状态变动）

【在组件中分发Action】

　　在组件中使用 this.$store.dispatch('xxx') 分发 action，或者使用 mapActions 辅助函数将组件的 methods 映射为 store.dispatch 调用（须要先在根节点注入 store）：

import { mapActions } from 'vuex'

export default {
  // ...
  methods: {
    ...mapActions([
      'increment', // 将 `this.increment()` 映射为 `this.$store.dispatch('increment')`

      // `mapActions` 也支持载荷：
      'incrementBy' // 将 `this.incrementBy(amount)` 映射为 `this.$store.dispatch('incrementBy', amount)`
    ]),
    ...mapActions({
      add: 'increment' // 将 `this.add()` 映射为 `this.$store.dispatch('increment')`
    })
  }
}

【组合Action】

　　Action 一般是异步的，那么如何知道 action 何时结束呢？更重要的是，如何才能组合多个 action，以处理更加复杂的异步流程？

　　首先，须要明白 store.dispatch 能够处理被触发的 action 的处理函数返回的 Promise，而且 store.dispatch 仍旧返回 Promise：

actions: {
  actionA ({ commit }) {
    return new Promise((resolve, reject) => {
      setTimeout(() => {
        commit('someMutation')
        resolve()
      }, 1000)
    })
  }
}

　　如今能够

store.dispatch('actionA').then(() => {
  // ...
})

　　在另一个 action 中也能够：

actions: {
  // ...
  actionB ({ dispatch, commit }) {
    return dispatch('actionA').then(() => {
      commit('someOtherMutation')
    })
  }
}

　　最后，若是利用 async / await 这个 JavaScript 新特性，能够像这样组合 action：

// 假设 getData() 和 getOtherData() 返回的是 Promise

actions: {
  async actionA ({ commit }) {
    commit('gotData', await getData())
  },
  async actionB ({ dispatch, commit }) {
    await dispatch('actionA') // 等待 actionA 完成
    commit('gotOtherData', await getOtherData())
  }
}

　　一个 store.dispatch 在不一样模块中能够触发多个 action 函数。在这种状况下，只有当全部触发函数完成后，返回的 Promise 才会执行

 

module

　　因为使用单一状态树，应用的全部状态会集中到一个比较大的对象。当应用变得很是复杂时，store 对象就有可能变得至关臃肿。

　　为了解决以上问题，Vuex 容许将 store 分割成模块（module）。每一个模块拥有本身的 state、mutation、action、getter、甚至是嵌套子模块——从上至下进行一样方式的分割：

const moduleA = {
  state: { ... },
  mutations: { ... },
  actions: { ... },
  getters: { ... }
}

const moduleB = {
  state: { ... },
  mutations: { ... },
  actions: { ... }
}

const store = new Vuex.Store({
  modules: {
    a: moduleA,
    b: moduleB
  }
})

store.state.a // -> moduleA 的状态
store.state.b // -> moduleB 的状态

【模块的局部状态】

　　对于模块内部的 mutation 和 getter，接收的第一个参数是模块的局部状态对象

const moduleA = {
  state: { count: 0 },
  mutations: {
    increment (state) {
      // 这里的 `state` 对象是模块的局部状态
      state.count++
    }
  },

  getters: {
    doubleCount (state) {
      return state.count * 2
    }
  }
}

　　一样，对于模块内部的 action，局部状态经过 context.state 暴露出来，根节点状态则为 context.rootState：

const moduleA = {
  // ...
  actions: {
    incrementIfOddOnRootSum ({ state, commit, rootState }) {
      if ((state.count + rootState.count) % 2 === 1) {
        commit('increment')
      }
    }
  }
}

　　对于模块内部的 getter，根节点状态会做为第三个参数暴露出来：

const moduleA = {
  // ...
  getters: {
    sumWithRootCount (state, getters, rootState) {
      return state.count + rootState.count
    }
  }
}

【命名空间】

　　默认状况下，模块内部的 action、mutation 和 getter 是注册在全局命名空间的——这样使得多个模块可以对同一 mutation 或 action 做出响应

　　若是但愿模块具备更高的封装度和复用性，能够经过添加 namespaced: true 的方式使其成为命名空间模块。当模块被注册后，它的全部 getter、action 及 mutation 都会自动根据模块注册的路径调整命名。例如：

const store = new Vuex.Store({
  modules: {
    account: {
      namespaced: true,
      // 模块内容（module assets）
      state: { ... }, // 模块内的状态已是嵌套的了，使用 `namespaced` 属性不会对其产生影响
      getters: {
        isAdmin () { ... } // -> getters['account/isAdmin']
      },
      actions: {
        login () { ... } // -> dispatch('account/login')
      },
      mutations: {
        login () { ... } // -> commit('account/login')
      },
      // 嵌套模块
      modules: {
        // 继承父模块的命名空间
        myPage: {
          state: { ... },
          getters: {
            profile () { ... } // -> getters['account/profile']
          }
        },

        // 进一步嵌套命名空间
        posts: {
          namespaced: true,

          state: { ... },
          getters: {
            popular () { ... } // -> getters['account/posts/popular']
          }
        }
      }
    }
  }
})

　　启用了命名空间的 getter 和 action 会收到局部化的 getter，dispatch 和 commit。换言之，在使用模块内容（module assets）时不须要在同一模块内额外添加空间名前缀。更改 namespaced 属性后不须要修改模块内的代码

【在命名空间模块内访问全局内容（Global Assets）】

　　若是但愿使用全局 state 和 getter，rootState 和 rootGetter 会做为第三和第四参数传入 getter，也会经过 context 对象的属性传入 action

　　若须要在全局命名空间内分发 action 或提交 mutation，将 { root: true } 做为第三参数传给 dispatch 或 commit便可

modules: {
  foo: {
    namespaced: true,
    getters: {
      // 在这个模块的 getter 中，`getters` 被局部化了
      // 你可使用 getter 的第四个参数来调用 `rootGetters`
      someGetter (state, getters, rootState, rootGetters) {
        getters.someOtherGetter // -> 'foo/someOtherGetter'
        rootGetters.someOtherGetter // -> 'someOtherGetter'
      },
      someOtherGetter: state => { ... }
    },

    actions: {
      // 在这个模块中， dispatch 和 commit 也被局部化了
      // 他们能够接受 `root` 属性以访问根 dispatch 或 commit
      someAction ({ dispatch, commit, getters, rootGetters }) {
        getters.someGetter // -> 'foo/someGetter'
        rootGetters.someGetter // -> 'someGetter'

        dispatch('someOtherAction') // -> 'foo/someOtherAction'
        dispatch('someOtherAction', null, { root: true }) // -> 'someOtherAction'

        commit('someMutation') // -> 'foo/someMutation'
        commit('someMutation', null, { root: true }) // -> 'someMutation'
      },
      someOtherAction (ctx, payload) { ... }
    }
  }
}

【带命名空间的绑定函数】

　　当使用 mapState, mapGetters, mapActions 和 mapMutations 这些函数来绑定命名空间模块时，写起来可能比较繁琐

computed: {
  ...mapState({
    a: state => state.some.nested.module.a,
    b: state => state.some.nested.module.b
  })
},
methods: {
  ...mapActions([
    'some/nested/module/foo',
    'some/nested/module/bar'
  ])
}

　　对于这种状况，能够将模块的空间名称字符串做为第一个参数传递给上述函数，这样全部绑定都会自动将该模块做为上下文。因而上面的例子能够简化为

computed: {
  ...mapState('some/nested/module', {
    a: state => state.a,
    b: state => state.b
  })
},
methods: {
  ...mapActions('some/nested/module', [
    'foo',
    'bar'
  ])
}

　　并且，能够经过使用 createNamespacedHelpers 建立基于某个命名空间辅助函数。它返回一个对象，对象里有新的绑定在给定命名空间值上的组件绑定辅助函数：

import { createNamespacedHelpers } from 'vuex'

const { mapState, mapActions } = createNamespacedHelpers('some/nested/module')

export default {
  computed: {
    // 在 `some/nested/module` 中查找
    ...mapState({
      a: state => state.a,
      b: state => state.b
    })
  },
  methods: {
    // 在 `some/nested/module` 中查找
    ...mapActions([
      'foo',
      'bar'
    ])
  }
}

【注意事项】

　　若是开发的插件（Plugin）提供了模块并容许用户将其添加到 Vuex store，可能须要考虑模块的空间名称问题。对于这种状况，能够经过插件的参数对象来容许用户指定空间名称：

// 经过插件的参数对象获得空间名称
// 而后返回 Vuex 插件函数
export function createPlugin (options = {}) {
  return function (store) {
    // 把空间名字添加到插件模块的类型（type）中去
    const namespace = options.namespace || ''
    store.dispatch(namespace + 'pluginAction')
  }
}

【模块动态注册】

　　在 store 建立以后，可使用 store.registerModule 方法注册模块：

// 注册模块 `myModule`
store.registerModule('myModule', {
  // ...
})
// 注册嵌套模块 `nested/myModule`
store.registerModule(['nested', 'myModule'], {
  // ...
})

　　以后就能够经过 store.state.myModule 和 store.state.nested.myModule 访问模块的状态。

　　模块动态注册功能使得其余 Vue 插件能够经过在 store 中附加新模块的方式来使用 Vuex 管理状态。例如，vuex-router-sync 插件就是经过动态注册模块将 vue-router 和 vuex 结合在一块儿，实现应用的路由状态管理。

　　也可使用 store.unregisterModule(moduleName) 来动态卸载模块。注意，不能使用此方法卸载静态模块（即建立 store 时声明的模块）

【模块重用】

　　有时可能须要建立一个模块的多个实例，例如：

　　一、建立多个 store，他们公用同一个模块 (例如当 runInNewContext 选项是 false 或 'once' 时，为了在服务端渲染中避免有状态的单例)

　　二、在一个 store 中屡次注册同一个模块

　　若是使用一个纯对象来声明模块的状态，那么这个状态对象会经过引用被共享，致使状态对象被修改时 store 或模块间数据互相污染的问题。

　　实际上这和 Vue 组件内的 data 是一样的问题。所以解决办法也是相同的——使用一个函数来声明模块状态（仅 2.3.0+ 支持）：

const MyReusableModule = {
  state () {
    return {
      foo: 'bar'
    }
  },
  // mutation, action 和 getter 等等...
}

 

项目结构

　　Vuex 并不限制代码结构。可是，它规定了一些须要遵照的规则：

　　一、应用层级的状态应该集中到单个 store 对象中

　　二、提交 mutation 是更改状态的惟一方法，而且这个过程是同步的

　　三、异步逻辑都应该封装到 action 里面

　　只要遵照以上规则，能够随意组织代码。若是store文件太大，只需将 action、mutation 和 getter 分割到单独的文件

　　对于大型应用，但愿把 Vuex 相关代码分割到模块中。下面是项目结构示例：

├── index.html
├── main.js
├── api
│   └── ... # 抽取出API请求
├── components
│   ├── App.vue
│   └── ...
└── store
    ├── index.js          # 组装模块并导出 store 的地方
    ├── actions.js        # 根级别的 action
    ├── mutations.js      # 根级别的 mutation
    └── modules
        ├── cart.js       # 购物车模块
        └── products.js   # 产品模块

 

插件

　　Vuex 的 store 接受 plugins 选项，这个选项暴露出每次 mutation 的钩子。Vuex 插件就是一个函数，它接收 store 做为惟一参数：

const myPlugin = store => {
  // 当 store 初始化后调用
  store.subscribe((mutation, state) => {
    // 每次 mutation 以后调用
    // mutation 的格式为 { type, payload }
  })
}

　　而后像这样使用：

const store = new Vuex.Store({
  // ...
  plugins: [myPlugin]
})

【在插件中提交Mutation】

　　在插件中不容许直接修改状态——相似于组件，只能经过提交 mutation 来触发变化。

　　经过提交 mutation，插件能够用来同步数据源到 store。例如，同步 websocket 数据源到 store（下面是个大概例子，实际上 createPlugin 方法能够有更多选项来完成复杂任务）：

export default function createWebSocketPlugin (socket) {
  return store => {
    socket.on('data', data => {
      store.commit('receiveData', data)
    })
    store.subscribe(mutation => {
      if (mutation.type === 'UPDATE_DATA') {
        socket.emit('update', mutation.payload)
      }
    })
  }
}
const plugin = createWebSocketPlugin(socket)

const store = new Vuex.Store({
  state,
  mutations,
  plugins: [plugin]
})

【生成State快照】

　　有时候插件须要得到状态的“快照”，比较改变的先后状态。想要实现这项功能，须要对状态对象进行深拷贝：

const myPluginWithSnapshot = store => {
  let prevState = _.cloneDeep(store.state)
  store.subscribe((mutation, state) => {
    let nextState = _.cloneDeep(state)

    // 比较 prevState 和 nextState...

    // 保存状态，用于下一次 mutation
    prevState = nextState
  })
}

　　生成状态快照的插件应该只在开发阶段使用，使用 webpack 或 Browserify，让构建工具帮助处理：

const store = new Vuex.Store({
  // ...
  plugins: process.env.NODE_ENV !== 'production'
    ? [myPluginWithSnapshot]
    : []
})

　　上面插件会默认启用。在发布阶段，须要使用 webpack 的 DefinePlugin 或者是 Browserify 的 envify 使 process.env.NODE_ENV !== 'production' 为 false

【内置Logger插件】

　　Vuex 自带一个日志插件用于通常的调试:

import createLogger from 'vuex/dist/logger'

const store = new Vuex.Store({
  plugins: [createLogger()]
})

　　createLogger 函数有几个配置项：

const logger = createLogger({
  collapsed: false, // 自动展开记录的 mutation
  filter (mutation, stateBefore, stateAfter) {
    // 若 mutation 须要被记录，就让它返回 true 便可
    // 顺便，`mutation` 是个 { type, payload } 对象
    return mutation.type !== "aBlacklistedMutation"
  },
  transformer (state) {
    // 在开始记录以前转换状态
    // 例如，只返回指定的子树
    return state.subTree
  },
  mutationTransformer (mutation) {
    // mutation 按照 { type, payload } 格式记录
    // 咱们能够按任意方式格式化
    return mutation.type
  }
})

　　日志插件还能够直接经过 <script> 标签引入，它会提供全局方法 createVuexLogger。

　　要注意，logger 插件会生成状态快照，因此仅在开发环境使用

 

严格模式

　　开启严格模式，仅需在建立 store 的时候传入 strict: true

const store = new Vuex.Store({
  // ...
  strict: true
})

　　在严格模式下，不管什么时候发生了状态变动且不是由 mutation 函数引发的，将会抛出错误。这能保证全部的状态变动都能被调试工具跟踪到

【开发环境与发布环境】

　　不要在发布环境下启用严格模式！严格模式会深度监测状态树来检测不合规的状态变动——请确保在发布环境下关闭严格模式，以免性能损失。

　　相似于插件，可让构建工具来处理这种状况：

const store = new Vuex.Store({
  // ...
  strict: process.env.NODE_ENV !== 'production'
})

 

表单处理

　　当在严格模式中使用 Vuex 时，在属于 Vuex 的 state 上使用 v-model 会比较棘手：

<input v-model="obj.message">

　　假设这里的 obj 是在计算属性中返回的一个属于 Vuex store 的对象，在用户输入时，v-model 会试图直接修改 obj.message。在严格模式中，因为这个修改不是在 mutation 函数中执行的, 这里会抛出一个错误。

　　用“Vuex 的思惟”去解决这个问题的方法是：给 <input> 中绑定 value，而后侦听 input 或者 change 事件，在事件回调中调用 action:

<input :value="message" @input="updateMessage">
// ...
computed: {
  ...mapState({
    message: state => state.obj.message
  })
},
methods: {
  updateMessage (e) {
    this.$store.commit('updateMessage', e.target.value)
  }
}

　　下面是 mutation 函数：

// ...
mutations: {
  updateMessage (state, message) {
    state.obj.message = message
  }
}

【双向绑定的计算属性】

　　必须认可，这样作比简单地使用“v-model + 局部状态”要啰嗦得多，而且也损失了一些 v-model 中颇有用的特性。另外一个方法是使用带有 setter 的双向绑定计算属性：

<input v-model="message">
// ...
computed: {
  message: {
    get () {
      return this.$store.state.obj.message
    },
    set (value) {
      this.$store.commit('updateMessage', value)
    }
  }
}

 

测试

【测试Mutation】

　　Mutation 很容易被测试，由于它们仅仅是一些彻底依赖参数的函数。这里有一个小技巧，若是在 store.js 文件中定义了 mutation，而且使用 ES2015 模块功能默认输出了 Vuex.Store 的实例，那么仍然能够给 mutation 取个变量名而后把它输出去：

const state = { ... }

// `mutations` 做为命名输出对象
export const mutations = { ... }

export default new Vuex.Store({
  state,
  mutations
})

　　下面是用 Mocha + Chai 测试一个 mutation 的例子

// mutations.js
export const mutations = {
  increment: state => state.count++
}
// mutations.spec.js
import { expect } from 'chai'
import { mutations } from './store'

// 解构 `mutations`
const { increment } = mutations

describe('mutations', () => {
  it('INCREMENT', () => {
    // 模拟状态
    const state = { count: 0 }
    // 应用 mutation
    increment(state)
    // 断言结果
    expect(state.count).to.equal(1)
  })
})

【测试Action】

　　Action 应对起来略微棘手，由于它们可能须要调用外部的 API。当测试 action 的时候，须要增长一个 mocking 服务层——例如，能够把 API 调用抽象成服务，而后在测试文件中用 mock 服务回应 API 调用。为了便于解决 mock 依赖，能够用 webpack 和 inject-loader 打包测试文件。

　　下面是一个测试异步 action 的例子：

// actions.js
import shop from '../api/shop'

export const getAllProducts = ({ commit }) => {
  commit('REQUEST_PRODUCTS')
  shop.getProducts(products => {
    commit('RECEIVE_PRODUCTS', products)
  })
}
// actions.spec.js

// 使用 require 语法处理内联 loaders。
// inject-loader 返回一个容许咱们注入 mock 依赖的模块工厂
import { expect } from 'chai'
const actionsInjector = require('inject-loader!./actions')

// 使用 mocks 建立模块
const actions = actionsInjector({
  '../api/shop': {
    getProducts (cb) {
      setTimeout(() => {
        cb([ /* mocked response */ ])
      }, 100)
    }
  }
})

// 用指定的 mutaions 测试 action 的辅助函数
const testAction = (action, args, state, expectedMutations, done) => {
  let count = 0

  // 模拟提交
  const commit = (type, payload) => {
    const mutation = expectedMutations[count]

    try {
      expect(mutation.type).to.equal(type)
      if (payload) {
        expect(mutation.payload).to.deep.equal(payload)
      }
    } catch (error) {
      done(error)
    }

    count++
    if (count >= expectedMutations.length) {
      done()
    }
  }

  // 用模拟的 store 和参数调用 action
  action({ commit, state }, ...args)

  // 检查是否没有 mutation 被 dispatch
  if (expectedMutations.length === 0) {
    expect(count).to.equal(0)
    done()
  }
}

describe('actions', () => {
  it('getAllProducts', done => {
    testAction(actions.getAllProducts, [], {}, [
      { type: 'REQUEST_PRODUCTS' },
      { type: 'RECEIVE_PRODUCTS', payload: { /* mocked response */ } }
    ], done)
  })
})

【测试Getter】

　　若是getter 包含很复杂的计算过程，颇有必要测试它们。Getter 的测试与 mutation 同样直截了当。

　　测试一个 getter 的示例：

// getters.js
export const getters = {
  filteredProducts (state, { filterCategory }) {
    return state.products.filter(product => {
      return product.category === filterCategory
    })
  }
}
// getters.spec.js
import { expect } from 'chai'
import { getters } from './getters'

describe('getters', () => {
  it('filteredProducts', () => {
    // 模拟状态
    const state = {
      products: [
        { id: 1, title: 'Apple', category: 'fruit' },
        { id: 2, title: 'Orange', category: 'fruit' },
        { id: 3, title: 'Carrot', category: 'vegetable' }
      ]
    }
    // 模拟 getter
    const filterCategory = 'fruit'

    // 获取 getter 的结果
    const result = getters.filteredProducts(state, { filterCategory })

    // 断言结果
    expect(result).to.deep.equal([
      { id: 1, title: 'Apple', category: 'fruit' },
      { id: 2, title: 'Orange', category: 'fruit' }
    ])
  })
})

【执行测试】

　　若是mutation 和 action 编写正确，通过合理地 mocking 处理以后这些测试应该不依赖任何浏览器 API，所以能够直接用 webpack 打包这些测试文件而后在 Node 中执行。换种方式，也能够用 mocha-loader 或 Karma + karma-webpack在真实浏览器环境中进行测试

在Node中执行测试

// webpack.config.js
module.exports = {
  entry: './test.js',
  output: {
    path: __dirname,
    filename: 'test-bundle.js'
  },
  module: {
    loaders: [
      {
        test: /\.js$/,
        loader: 'babel-loader',
        exclude: /node_modules/
      }
    ]
  }
}

　　而后

webpack
mocha test-bundle.js

在浏览器中测试

　　一、安装 mocha-loader

　　二、上述 webpack 配置中的 entry 改为 'mocha-loader!babel-loader!./test.js'

　　三、用以上配置启动 webpack-dev-server

　　四、访问 localhost:8080/webpack-dev-server/test-bundle

 

热加载

　　使用 webpack 的 Hot Module Replacement API，Vuex 支持在开发过程当中热重载 mutation、module、action 和 getter。也能够在 Browserify 中使用 browserify-hmr 插件。

　　对于 mutation 和模块，须要使用 store.hotUpdate() 方法：

// store.js
import Vue from 'vue'
import Vuex from 'vuex'
import mutations from './mutations'
import moduleA from './modules/a'

Vue.use(Vuex)

const state = { ... }

const store = new Vuex.Store({
  state,
  mutations,
  modules: {
    a: moduleA
  }
})

if (module.hot) {
  // 使 action 和 mutation 成为可热重载模块
  module.hot.accept(['./mutations', './modules/a'], () => {
    // 获取更新后的模块
    // 由于 babel 6 的模块编译格式问题，这里须要加上 `.default`
    const newMutations = require('./mutations').default
    const newModuleA = require('./modules/a').default
    // 加载新模块
    store.hotUpdate({
      mutations: newMutations,
      modules: {
        a: newModuleA
      }
    })
  })
}