Pomelo入门03

这篇文章要分析如下部分的代码:

// app configure
app.configure('production|development', function() {
	// route configures
	app.route('chat', routeUtil.chat);   //chat是server类型,第二个是route函数

	// filter configures
	app.filter(pomelo.timeout());   //这里会同时在before和after加入这个filter 
});

// start app
app.start();  //开启application

其中最主要的其实还是分析application的start过程,先来看看configure要干一些什么东西吧:

Application.configure = function (env, type, fn) {
  var args = [].slice.call(arguments);  //将传进来的参数变成一个数组
  fn = args.pop();   //获取回调函数
  env = 'all';   
  type = 'all';

  if(args.length > 0) {
    env = args[0];  //获取当前额环境配置,例如development,production等
  }
  if(args.length > 1) {
    type = args[1]; //类型,conector,gate啥的
  }

  if (env === 'all' || contains(this.settings.env, env)) {   //如果没有配置env或者env包含在了配置中,
    if (type === 'all' || contains(this.settings.serverType, type)) {
      fn.call(this);  //调用回调函数
    }
  }
  return this;
};

代码应该还算是很简单的吧,先将传进来的参数转化为一个数组,然后获取最后的回调函数,接着判断当前环境配置是否符合,然后再调用回调函数,进行一些设置,例如我们来看看route干了些什么:

 //设置相应server的route函数
Application.route = function(serverType, routeFunc) {
  var routes = this.get('__routes__');
  if(!routes) {
    routes = {};
    this.set('__routes__', routes); 
  }
  routes[serverType] = routeFunc;   //保存route函数
  return this;
};

这个应该是一看就能看明白这个用来干嘛了吧,第一个参数是设置route的server类型,说白了就是将这个用键值对保存起来,routefunc一般是用户自定义的route函数吧。。以后的分析肯定会涉及到。。。

然后filter用来设置filter函数,这里比较有意思的是filter分为两个维度,分别是before和after,这里会同时在这两个维度中都设置这个传进去的filter函数。。。

好了,接下来进入主题,看start函数吧:

Application.start = function(cb) {
  if(this.state > STATE_INITED) {  //正常情况应该是等于这个
    utils.invokeCallback(cb, new Error('application has already start.'));
    return;
  }
  appUtil.loadDefaultComponents(this);  //用来加载默认的组件
  var self = this;
  //调用这些组件的start,开启这些组件
  appUtil.optComponents(this.loaded, 'start', function(err) {
    self.state = STATE_START;
    if(err) {
      utils.invokeCallback(cb, err);
    } else {
      logger.info('%j enter after start...', self.getServerId());
      self.afterStart(cb);
    }
  });
};

其实这个函数的定义相对还是比较容易搞明白,首先判断当前的状态,如果都已经开启了,那么就报错,正常情况下应该是加载那些默认的组件,然后在开启这些组件。。。来看看loadDefaultComponents方法:

 //为application加载默认的组件
module.exports.loadDefaultComponents = function(app) {
  var pomelo = require('../pomelo');
  // load system default components
  if (app.serverType === 'master') {
    app.load(pomelo.master, app.get('masterConfig')); //get得到的为null
    //这里pomelo.master在pomelo里面定义了,会载入components里面的master文件,这里的master其实是包装器,真正的master会在里面加载
  } else {
    app.load(pomelo.proxy, app.get('proxyConfig'));
    if(app.getCurServer().port) {
      app.load(pomelo.remote, app.get('remoteConfig'));
    }
    if(app.isFrontend()) {
      app.load(pomelo.connection, app.get('connectionConfig'));
      app.load(pomelo.connector, app.get('connectorConfig'));
      app.load(pomelo.session, app.get('sessionConfig'));
      app.load(pomelo.protobuf, app.get('protobufConfig'));
      app.load(pomelo.scheduler, app.get('schedulerConfig'));
    }
    app.load(pomelo.localSession, app.get('localSessionConfig'));
    app.load(pomelo.channel, app.get('channelConfig'));
    app.load(pomelo.server, app.get('serverConfig'));
    if(app.get('globalChannelConfig')) {
      app.load(pomelo.globalChannel, app.get('globalChannelConfig'));
    }
  }
  app.load(pomelo.monitor, app.get('monitorConfig'));
};

我们还是先来看master类型吧,因为我们现在整个代码的流程还是在master类型中,还没有涉及到server类型,这里直接调用load方法将master载入进来。。。至于后面得到的配置,其实是null。

在深入load之前,需要知道pomelo.master究竟是个什么东西。。。

扫描二维码关注公众号,回复: 10596406 查看本文章

回顾以前的一段代码:

 //用于在components文件夹中读取组件,然后保存到components对象里面去
fs.readdirSync(__dirname + '/components').forEach(function (filename) {
  if (!/\.js$/.test(filename)) {
    return;
  }
  var name = path.basename(filename, '.js');

  function load() {
    return require('./components/' + name);
  }
  Pomelo.components.__defineGetter__(name, load);//例如执行Pomelo.components.aa,其实会得到require("./components/aa");的值
  Pomelo.__defineGetter__(name, load);
});

在componets里面有了master.js文件,那么我们就知道如果访问pomelo.master,那么实际得到的是

  function load() {
    return require('./components/master');
  }

这个函数的返回值,那么我们再来看看这个东西的定义吧:

/**
 * Component for master.
 */
var Master = require('../master/master');

/**
 * Component factory function
 *
 * @param  {Object} app  current application context
 * @return {Object}      component instances
 */
 //相当于require之后得到的就是这个函数
module.exports = function (app) {
  return new Component(app);
};

/**
* Master component class
*
* @param {Object} app  current application context
*/
var Component = function (app) {
  this.master = new Master(app);   //创建爱你master
};

var pro = Component.prototype;

/**
 * Component lifecycle function
 *
 * @param  {Function} cb
 * @return {Void}
 */
pro.start = function (cb) {
  this.master.start(cb);
};

/**
 * Component lifecycle function
 *
 * @param  {Boolean}   force whether stop the component immediately
 * @param  {Function}  cb
 * @return {Void}
 */
pro.stop = function (force, cb) {
  this.master.stop(cb);
};

(呵呵,看起来不就是一个包装器么。。。用于对真正的master进行一个代理而已。。)

从这里我们可以看到,访问pomelo.master实际上得到的是如下这个函数:

function (app) {
  return new Component(app);
};

好了,搞清楚了pomelo.master是个什么东西,接下来我们就可以深入load函数了:

 //该函数用于加载组件,
Application.load = function(name, component, opts) {
  if(typeof name !== 'string') {
    opts = component;  //工厂方法,例如start,stop等
    component = name;   //加载得到的component
    name = null;
    if(typeof component.name === 'string') {
      name = component.name;
    }
  }

  if(typeof component === 'function') {  //如果是方法,那么就是component的构造方法,其实一般情况下就是这个样子的
    component = component(this, opts);
  }

  if(!name && typeof component.name === 'string') {
    name = component.name;
  }

  if(name && this.components[name]) {
    // ignore duplicat component
    logger.warn('ignore duplicate component: %j', name);
    return;
  }

  this.loaded.push(component);    //将家在得到的component放入到数组
  if(name) {
    // components with a name would get by name throught app.components later.
    this.components[name] = component;
  }

  return this;
};

这里我们可以知道最开始传进的name是上面提到的那个函数,其余的都是null,那么这个函数的整个执行流程也就很很明白了,调用刚刚那个函数,创建一个创建一个component,其实这个component其实是对master的一个包装而已(start,stop方法),然后再将这个component放到loaded数组当中去。。这就是组件的load过程。。。。(当然这里只是master的load过程)

好了,master组件load进来了,那么就应该启动了,也即是执行如下的代码:

  //调用这些组件的start,开启这些组件
  appUtil.optComponents(this.loaded, 'start', function(err) {
    self.state = STATE_START;
    if(err) {
      utils.invokeCallback(cb, err);
    } else {
      logger.info('%j enter after start...', self.getServerId());
      self.afterStart(cb);
    }
  });

好吧,我们来看这个函数的定义:

module.exports.optComponents = function(comps, method, cb) {
  var i = 0;
  //遍历所有的组件,调用他们相应的方法
  async.forEachSeries(comps, function(comp, done) {
    i++;
    if(typeof comp[method] === 'function') {
      comp[method](done);
    } else {
      done();
    }
  }, function(err) {
    if(err) {
      logger.error('fail to operate component, method:%s, err:' + err.stack, method);
    }
    cb(err);
  });

比较的简单,对于这里我们载入的master组件,说白了就是调用它的start函数,

pro.start = function (cb) {
  this.master.start(cb);
};

只不过是一个包装而已,用于调用真正的master的start函数。。。

好了,到这里master组件的载入和start也就差不多了,那么下一篇就可以看看master的start究竟是干了些什么事情了。

发布了39 篇原创文章 · 获赞 81 · 访问量 35万+

猜你喜欢

转载自blog.csdn.net/qq_31967569/article/details/105291394
今日推荐