Vue defineReactive

/**
 * Define a reactive property on an Object.
 */
export function defineReactive (
  obj: Object,
  key: string,
  val: any,
  customSetter?: ?Function,
  shallow?: boolean
) {
  const dep = new Dep()

  const property = Object.getOwnPropertyDescriptor(obj, key)
  if (property && property.configurable === false) {
    return
  }

  // cater for pre-defined getter/setters
  const getter = property && property.get
  const setter = property && property.set
  if ((!getter || setter) && arguments.length === 2) {
    val = obj[key]
  }

  let childOb = !shallow && observe(val)
  Object.defineProperty(obj, key, {
    enumerable: true,
    configurable: true,
    get: function reactiveGetter () {
      const value = getter ? getter.call(obj) : val
      // Dep.target 在 mountComponent 中设置
      if (Dep.target) {
        // 收集依赖
        dep.depend()
        if (childOb) {
          childOb.dep.depend()
          if (Array.isArray(value)) {
            dependArray(value)
          }
        }
      }
      return value
    },
    set: function reactiveSetter (newVal) {
      const value = getter ? getter.call(obj) : val
      /* eslint-disable no-self-compare */
      if (newVal === value || (newVal !== newVal && value !== value)) {
        return
      }
      /* eslint-enable no-self-compare */
      if (process.env.NODE_ENV !== 'production' && customSetter) {
        customSetter()
      }
      // #7981: for accessor properties without setter
      if (getter && !setter) return
      if (setter) {
        setter.call(obj, newVal)
      } else {
        val = newVal
      }
      childOb = !shallow && observe(newVal)
      //当设置值时通知 dep
      dep.notify()
    }
  })
}

import type Watcher from './watcher'
import { remove } from '../util/index'

let uid = 0

/**
 * 定义可观测对象，允许多次订阅
 * 是响应式的核心部分
 * 在对象 getter 中调用来观测对象元素
 * 实际上是对 watcher 的管理
 */
export default class Dep {
  static target: ?Watcher;
  id: number;
  subs: Array<Watcher>;

  constructor () {
    this.id = uid++
    this.subs = []
  }

  /**
   * 在 watcher 中调用了此方法，用来收集订阅者
   * 
  */
  addSub (sub: Watcher) {
    // 记录观察者
    this.subs.push(sub)
  }

  removeSub (sub: Watcher) {
    remove(this.subs, sub)
  }

  /**
   * 在对象元素的 getter 中调用
   * 由于 mountComponent 时添加了 watcher
   * 在 Watcher 的 constructor 中：
   * 1. 将此 watcher 设置为了 Dep.target，
   * 2. 执行表达式，触发表达式依赖元素的 getter
  */
  depend () {
    if (Dep.target) {
      // 添加当前依赖到 watcher
      Dep.target.addDep(this)
    }
  }

  notify () {
    // stabilize the subscriber list first
    const subs = this.subs.slice()
    for (let i = 0, l = subs.length; i < l; i++) {
      // 设置值时会调用 watcher 的 update，执行 update 策略
      subs[i].update()
    }
  }
}

/**
 * target 是当前活动的 watcher
 * 在使用中同一时间只有一个 watcher 被使用
 */
Dep.target = null
const targetStack = []

export function pushTarget (_target: ?Watcher) {
  if (Dep.target) targetStack.push(Dep.target)
  Dep.target = _target
}

export function popTarget () {
  Dep.target = targetStack.pop()
}