Vue源码探究-组件的持久活跃

// 导入辅助函数
import { isRegExp, remove } from 'shared/util'
import { getFirstComponentChild } from 'core/vdom/helpers/index'

// 定义VNodeCache静态类型
// 它是一个包含key名和VNode键值对的对象，可想而知它是用来存储组件的
type VNodeCache = { [key: string]: ?VNode };

// 定义getComponentName函数，用于获取组件名称，传入组件配置对象
function getComponentName (opts: ?VNodeComponentOptions): ?string {
  // 先尝试获取配置对象中定义的name属性，或无则获取标签名称
  return opts && (opts.Ctor.options.name || opts.tag)
}

// 定义matches函数，进行模式匹配，传入匹配的模式类型数据和name属性
function matches (pattern: string | RegExp | Array<string>, name: string): boolean {
  // 匹配数组模式
  if (Array.isArray(pattern)) {
    // 使用数组方法查找name，返回结果
    return pattern.indexOf(name) > -1
  } else if (typeof pattern === 'string') {
    // 匹配字符串模式
    // 将字符串转换成数组查找name，返回结果
    return pattern.split(',').indexOf(name) > -1
  } else if (isRegExp(pattern)) {
    // 匹配正则表达式
    // 使用正则匹配name，返回结果
    return pattern.test(name)
  }
  /* istanbul ignore next */
  // 未匹配正确模式则返回false
  return false
}

// 定义pruneCache函数，修剪keep-alive组件缓存对象
// 接受keep-alive组件实例和过滤函数
function pruneCache (keepAliveInstance: any, filter: Function) {
  // 获取组件的cache，keys，_vnode属性
  const { cache, keys, _vnode } = keepAliveInstance
  // 遍历cache对象
  for (const key in cache) {
    // 获取缓存资源
    const cachedNode: ?VNode = cache[key]
    // 如果缓存资源存在
    if (cachedNode) {
      // 获取该资源的名称
      const name: ?string = getComponentName(cachedNode.componentOptions)
      // 当名称存在 且不匹配缓存过滤时
      if (name && !filter(name)) {
        // 执行修剪缓存资源操作
        pruneCacheEntry(cache, key, keys, _vnode)
      }
    }
  }
}

// 定义pruneCacheEntry函数，修剪缓存条目
// 接受keep-alive实例的缓存对象和键名缓存对象，资源键名和当前资源
function pruneCacheEntry (
  cache: VNodeCache,
  key: string,
  keys: Array<string>,
  current?: VNode
) {
  // 检查缓存对象里是否已经有以key值存储的资源
  const cached = cache[key]
  // 如果有旧资源并且没有传入新资源参数或新旧资源标签不同
  if (cached && (!current || cached.tag !== current.tag)) {
    // 销毁该资源
    cached.componentInstance.$destroy()
  }
  // 置空key键名存储资源
  cache[key] = null
  // 移除key值的存储
  remove(keys, key)
}

// 定义模式匹配接收的数据类型
const patternTypes: Array<Function> = [String, RegExp, Array]

// 导出keep-alive组件实例的配置对象
export default {
  // 定义组件名称
  name: 'keep-alive',
  // 设置abstract属性
  abstract: true,
  // 设置组件接收的属性
  props: {
    // include用于包含模式匹配的资源，启用缓存
    include: patternTypes,
    // exclude用于排除模式匹配的资源，不启用缓存
    exclude: patternTypes,
    // 最大缓存数
    max: [String, Number]
  },

  created () {
    // 实例创建时定义cache属性为空对象，用于存储资源
    this.cache = Object.create(null)
    // 设置keys数组，用于存储资源的key名
    this.keys = []
  },

  destroyed () {
    // 实例销毁时一并销毁存储的资源并清空缓存对象
    for (const key in this.cache) {
      pruneCacheEntry(this.cache, key, this.keys)
    }
  },

  mounted () {
    // DOM加载完成后，观察include和exclude属性的变动
    // 回调执行修改缓存对象的操作
    this.$watch('include', val => {
      pruneCache(this, name => matches(val, name))
    })
    this.$watch('exclude', val => {
      pruneCache(this, name => !matches(val, name))
    })
  },

  render () {
    // 实例渲染函数
    // 获取keep-alive包含的子组件结构
    // keep-alive组件并不渲染任何真实DOM节点，只渲染嵌套在其中的组件资源
    const slot = this.$slots.default
    // 将嵌套组件dom结构转化成虚拟节点
    const vnode: VNode = getFirstComponentChild(slot)
    // 获取嵌套组件的配置对象
    const componentOptions: ?VNodeComponentOptions = vnode && vnode.componentOptions
    // 如果配置对象存在
    if (componentOptions) {
      // 检查是否缓存的模式匹配
      // check pattern
      // 获取嵌套组件名称
      const name: ?string = getComponentName(componentOptions)
      // 获取传入keep-alive组件的include和exclude属性
      const { include, exclude } = this
      // 如果有included，且该组件不匹配included中资源
      // 或者有exclude。且该组件匹配exclude中的资源
      // 则返回虚拟节点，不继续执行缓存
      if (
        // not included
        (include && (!name || !matches(include, name))) ||
        // excluded
        (exclude && name && matches(exclude, name))
      ) {
        return vnode
      }

      // 获取keep-alive组件的cache和keys对象
      const { cache, keys } = this
      // 获取嵌套组件虚拟节点的key
      const key: ?string = vnode.key == null
        // 同样的构造函数可能被注册为不同的本地组件，所以cid不是判断的充分条件
        // same constructor may get registered as different local components
        // so cid alone is not enough (#3269)
        ? componentOptions.Ctor.cid + (componentOptions.tag ? `::${componentOptions.tag}` : '')
        : vnode.key
      // 如果缓存对象里有以key值存储的组件资源
      if (cache[key]) {
        // 设置当前嵌套组件虚拟节点的componentInstance属性
        vnode.componentInstance = cache[key].componentInstance
        // make current key freshest
        // 从keys中移除旧key，添加新key
        remove(keys, key)
        keys.push(key)
      } else {
        // 缓存中没有该资源，则直接存储资源，并存储key值
        cache[key] = vnode
        keys.push(key)
        // 如果设置了最大缓存资源数，从最开始的序号开始删除存储资源
        // prune oldest entry
        if (this.max && keys.length > parseInt(this.max)) {
          pruneCacheEntry(cache, keys[0], keys, this._vnode)
        }
      }

      // 设置该资源虚拟节点的keepAlive标识
      vnode.data.keepAlive = true
    }
    // 返回虚拟节点或dom节点
    return vnode || (slot && slot[0])
  }
}