koa2--delegates模块源码解读

Posted tugenhua0707

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了koa2--delegates模块源码解读相关的知识,希望对你有一定的参考价值。

delegates模块是由TJ大神写的,该模块的作用是将内部对象上的变量或函数委托到外部对象上。
然后我们就可以使用外部对象就能获取内部对象上的变量或函数。delegates委托方式有如下:

getter: 外部对象可以通过该方法访问内部对象的值。
setter:外部对象可以通过该方法设置内部对象的值。
access: 该方法包含getter和setter功能。
method: 该方法可以使外部对象直接调用内部对象的函数。

项目文件如下结构:

|----- 项目
|  |-- delegates.js  # 委托代理的js
|  |-- index.js  # 入口文件的js

1. getter (外部对象可以通过该方法访问内部对象的值。)

使用方法demo如下(index.js):

const delegates = require(‘./delegates‘);

const obj = {
  xx: {
    name: ‘kongzhi‘,
    age: 30,
    test: function() {
      console.log(‘xxxxxxx‘);
    }
  }
};

// 通过delegates将内部对象 xx 委托到外部对象obj上

var d = new delegates(obj, ‘xx‘);
d.getter(‘name‘).getter(‘age‘).getter(‘test‘);

console.log(obj.name); // kongzhi
console.log(obj.age); // 30
obj.test(); // xxxxxxx

2. setter (外部对象可以通过该方法设置内部对象的值。)

使用方法的demo如下(代码在index.js内):

const delegates = require(‘./delegates‘);

const obj = {
  xx: {
    name: ‘kongzhi‘,
    age: 30,
    test: function() {
      console.log(‘xxxxxxx‘);
    }
  }
};

// 通过delegates将内部对象 xx 委托到外部对象obj上

var d = new delegates(obj, ‘xx‘);
d.setter(‘name‘).setter(‘age‘).setter(‘test‘);

// 使用setter后,就可以在obj对象上直接修改变量或函数的值了
obj.name = ‘123456‘;
obj.age = ‘31‘;
obj.test = function() {
  console.log(‘yyyy‘);
}

/*
 在外部对象obj修改完成后,我们再使用 外部对象[内部对象][变量] 
 这种方式获取值, 就可以看到值更新了
*/
console.log(obj.xx.name); // 123456
console.log(obj.xx.age); // 31
obj.xx.test(); // yyyy

3. access (该方法包含getter和setter功能。)

使用方法的demo如下

const delegates = require(‘./delegates‘);

const obj = {
  xx: {
    name: ‘kongzhi‘,
    age: 30,
    test: function() {
      console.log(‘xxxxxxx‘);
    }
  }
};

// 通过delegates将内部对象 xx 委托到外部对象obj上

var d = new delegates(obj, ‘xx‘);
d.access(‘name‘).access(‘age‘).access(‘test‘);

// access 该方法既有setter功能,又有getter功能

// 1. 直接使用外部对象 obj, 来访问内部对象中的属性
console.log(obj.name); // kongzhi
console.log(obj.age); // 30
obj.test(); // xxxxxxx

// 2. 使用常规的方法获取对象的内部的属性
console.log(obj.xx.name); // kongzhi
console.log(obj.xx.age); // 30
obj.xx.test(); // xxxxxxx

// 3. 修改内部对象的属性
obj.name = ‘2222‘;
console.log(obj.name); // 2222
console.log(obj.xx.name); // 2222

4. method (该方法可以使外部对象直接调用内部对象的函数。)

使用方法的demo如下:

const delegates = require(‘./delegates‘);

const obj = {
  xx: {
    name: ‘kongzhi‘,
    age: 30,
    test: function() {
      console.log(‘xxxxxxx‘);
    }
  }
};

// 通过delegates将内部对象 xx 委托到外部对象obj上

var d = new delegates(obj, ‘xx‘);
d.method(‘test‘);

obj.test(); // xxxxxxx

5. fluent

该方法的作用是,如果该方法传了参数的话,那么它的含义是修改该变量的值,如果没有传入参数的话,那么
它的作用是获取该参数的值。

注意:只针对变量有用,如果是函数的话,不建议使用;

如下代码demo所示:

const delegates = require(‘./delegates‘);

const obj = {
  xx: {
    name: ‘kongzhi‘,
    age: 30,
    test: function() {
      console.log(‘xxxxxxx‘);
    }
  }
};

// 通过delegates将内部对象 xx 委托到外部对象obj上
var d = new delegates(obj, ‘xx‘);
d.fluent(‘name‘).fluent(‘age‘);

// 无参数 获取该对象的值
console.log(obj.name()); // kongzhi
console.log(obj.age()); // 30

// 有参数,就是修改对应的值
obj.name(‘11111‘)
obj.age(31)

console.log(obj.xx.name); // 11111
console.log(obj.xx.age); // 31

二:delegates模块源码如下:

/**
 * Expose `Delegator`.
 */

module.exports = Delegator;

/**
 * Initialize a delegator.
 *
 * @param {Object} proto
 * @param {String} target
 * @api public
 */
/*
 Delegator 函数接收二个参数,proto指是一个是外部对象,target指外部对象中的一个属性,也就是内部对象。
 首先判断this是否是Delegator的实列,如果不是实列的话,就直接使用 new 实列化一下。
 因此 const xx = Delegator(obj, ‘xx‘) 或 const xx = new Delegator(obj, ‘xx‘) 都是可以的。
 this.proto = proto; 外部对象保存该实列this.proto 中。
 this.target = target; 和proto一样。
 this.methods = [];
 this.getters = [];
 this.setters = [];
 this.fluents = [];
 如上四个数组作用是 记录委托了哪些属性和函数。
*/
function Delegator(proto, target) {
  if (!(this instanceof Delegator)) return new Delegator(proto, target);
  this.proto = proto;
  this.target = target;
  this.methods = [];
  this.getters = [];
  this.setters = [];
  this.fluents = [];
}

/**
 * Delegate method `name`.
 *
 * @param {String} name
 * @return {Delegator} self
 * @api public
 */
/*
 method的作用是:该方法可以使外部对象直接调用内部对象的函数。如下demo:
 const obj = {
  xx: {
    name: ‘kongzhi‘,
    age: 30,
    test: function() {
      console.log(‘xxxxxxx‘);
    }
  }
};
// 通过delegates将内部对象 xx 委托到外部对象obj上
var d = new delegates(obj, ‘xx‘);
d.method(‘test‘);

obj.test(); // xxxxxxx

1. 首先我们调用 d.method(‘test‘); 就把该test方法存入 this.methods数组中。
2. 该方法返回了一个函数
obj[‘test‘] = function() {
  return obj[‘xx‘][‘test‘].apply(obj[‘xx‘], arguments);
}
3. 最后返回 this, 返回该实例化对象,目的是可以链式调用。
4. 因此就返回了第二步函数。因此当我们使用 obj.test() 的时候,就会自动调用该函数。然后
使用 apply方法自动执行 obj[‘xx‘][‘test‘].apply(obj[‘xx‘], arguments); 
*/
Delegator.prototype.method = function(name){
  var proto = this.proto;
  var target = this.target;
  this.methods.push(name);

  proto[name] = function(){
    return this[target][name].apply(this[target], arguments);
  };

  return this;
};

/**
 * Delegator accessor `name`.
 *
 * @param {String} name
 * @return {Delegator} self
 * @api public
 */
/*
 该方法的作用是包含 getter的作用,同时也包含setter的作用,如demo如下:
 const obj = {
    xx: {
      name: ‘kongzhi‘,
      age: 30,
      test: function() {
        console.log(‘xxxxxxx‘);
      }
    }
  };

  // 通过delegates将内部对象 xx 委托到外部对象obj上

  var d = new delegates(obj, ‘xx‘);
  d.access(‘name‘).access(‘age‘).access(‘test‘);

  // access 该方法既有setter功能,又有getter功能

  // 1. 直接使用外部对象 obj, 来访问内部对象中的属性
  console.log(obj.name); // kongzhi
  console.log(obj.age); // 30
  obj.test(); // xxxxxxx

  // 2. 使用常规的方法获取对象的内部的属性
  console.log(obj.xx.name); // kongzhi
  console.log(obj.xx.age); // 30
  obj.xx.test(); // xxxxxxx

  // 3. 修改内部对象的属性
  obj.name = ‘2222‘;
  console.log(obj.name); // 2222
  console.log(obj.xx.name); // 2222
*/
Delegator.prototype.access = function(name){
  return this.getter(name).setter(name);
};

/**
 * Delegator getter `name`.
 *
 * @param {String} name
 * @return {Delegator} self
 * @api public
 */
/*
 getter,该方法的作用是:外部对象可以通过该方法访问内部对象的值。比如如下demo
 const obj = {
    xx: {
      name: ‘kongzhi‘,
      age: 30,
      test: function() {
        console.log(‘xxxxxxx‘);
      }
    }
  };

  // 通过delegates将内部对象 xx 委托到外部对象obj上
  var d = new delegates(obj, ‘xx‘);
  d.getter(‘name‘).getter(‘age‘).getter(‘test‘);

  console.log(obj.name); // kongzhi
  console.log(obj.age); // 30
  obj.test(); // xxxxxxx

  1. 该方法接收一个参数 name, 该参数是一个字符串类型。
  2. 把该参数name值保存到 this.getters数组中。然后我们使用 __defineGetter__ 监听对象属性值的变化。
  想要理解 __defineGetter__ 作用,请看我这篇文章 (https://www.cnblogs.com/tugenhua0707/p/10324983.html#_labe1)
  如果获取该对象值的话,就会自动调用 __defineGetter__ ,就能监听到,因此就返回 this[target][name]; 即使:
  obj[‘xx‘][‘name‘];
*/
Delegator.prototype.getter = function(name){
  var proto = this.proto;
  var target = this.target;
  this.getters.push(name);

  proto.__defineGetter__(name, function(){
    return this[target][name];
  });

  return this;
};

/**
 * Delegator setter `name`.
 *
 * @param {String} name
 * @return {Delegator} self
 * @api public
 */
/*
 该方法的作用是:外部对象可以通过该方法设置内部对象的值。使用demo如下:
 const obj = {
    xx: {
      name: ‘kongzhi‘,
      age: 30,
      test: function() {
        console.log(‘xxxxxxx‘);
      }
    }
  };

  // 通过delegates将内部对象 xx 委托到外部对象obj上

  var d = new delegates(obj, ‘xx‘);
  d.setter(‘name‘).setter(‘age‘).setter(‘test‘);

  // 使用setter后,就可以在obj对象上直接修改变量或函数的值了
  obj.name = ‘123456‘;
  obj.age = ‘31‘;
  obj.test = function() {
    console.log(‘yyyy‘);
  }
  
  // 在外部对象obj修改完成后,我们再使用 外部对象[内部对象][变量] 这种方式获取值, 就可以看到值更新了
  console.log(obj.xx.name); // 123456
  console.log(obj.xx.age); // 31
  obj.xx.test(); // yyyy

  1. 同样的道理,使用 __defineSetter__方法来监听对象值发生改变,如果对象值发生改变的话,就返回 
  this[target][name] = val; 把值赋值进去。最后返回this对象。
  */
Delegator.prototype.setter = function(name){
  var proto = this.proto;
  var target = this.target;
  this.setters.push(name);

  proto.__defineSetter__(name, function(val){
    return this[target][name] = val;
  });

  return this;
};

/**
 * Delegator fluent accessor
 *
 * @param {String} name
 * @return {Delegator} self
 * @api public
 */
/*
 该方法的作用是,如果该方法传了参数的话,那么它的含义是修改该变量的值,如果没有传入参数的话,那么
 它的作用是获取该参数的值。
 使用demo如下:
 const obj = {
    xx: {
      name: ‘kongzhi‘,
      age: 30,
      test: function() {
        console.log(‘xxxxxxx‘);
      }
    }
  };

  // 通过delegates将内部对象 xx 委托到外部对象obj上
  var d = new delegates(obj, ‘xx‘);
  d.fluent(‘name‘).fluent(‘age‘);

  // 无参数 获取该对象的值
  console.log(obj.name()); // kongzhi
  console.log(obj.age()); // 30

  // 有参数,就是修改对应的值
  obj.name(‘11111‘)
  obj.age(31)

  console.log(obj.xx.name); // 11111
  console.log(obj.xx.age); // 31

  1. 当我像如上demo一样,使用 d.fluent(‘name‘).fluent(‘age‘);后,会依次保存到 this.flunts数组中。
  2. 然后返回一个函数,如下代码:
  obj[‘name‘] = function(val) {
    if (‘undefined‘ != typeof val) {
      this[target][name] = val;
      return this;
    } else {
      return this[target][name];
    }
  }
  如果值没有传递电话,就直接返回 this[target][name]; 即:obj[‘xx‘][‘name‘];
  如果传递了值的话,就把值赋值到对象里面去,如代码:this[target][name] = val; 即:obj[‘xx‘][‘name‘] = val;
*/
Delegator.prototype.fluent = function (name) {
  var proto = this.proto;
  var target = this.target;
  this.fluents.push(name);

  proto[name] = function(val){
    if (‘undefined‘ != typeof val) {
      this[target][name] = val;
      return this;
    } else {
      return this[target][name];
    }
  };

  return this;
};

以上是关于koa2--delegates模块源码解读的主要内容,如果未能解决你的问题,请参考以下文章

vue源码解读预热-0

#yyds干货盘点# mybatis源码解读:executor包(语句处理功能)

motan源码解读:注册中心zookeeper

FlinkFlink on yarn 使用 pre-job模式 提交任务kerberos 认证 源码代码解读

require() 源码解读

node.js require() 源码解读