应用程序配置

app.js 文件

var pomelo = require('pomelo');
var app = pomelo.createApp();

// some configuration

app.configure(, , function() {
 
});

app.configure(....);
app.set(...);
app.route(...);

// ...

// start app
app.start();

使用 app.configure 调用来配置

app.configure([env], [serverType], [function]);

• env：运行环境，可设成 development、 production 或 development|production；
• serverType：服务器类型，设置了这个参数只会对当前参数类型服务器做初始化，不设置则对所有服务器执行初始化 function；
• function：具体的初始化操作，内部可以写任何对框架的配置操作逻辑。

实例一

app.configure(function(){
    // do some configuration
});

app.configure(function() {
    doSomeConfiguration();
  });

// <==>

doSomeConfiguration(); // equivalent to above `app.configure`

实例二

app.configure('development', function(){
    // do some configuration just for development env only.
});

实例三

app.configure('development', 'chat', function(){
    // do some configuration just for development env and chat server only.
});

配置内容

app.configure('development|production', function(){
     app.loadConfig('mysql', app.getBase() + '/config/mysql.json');
});

var initArea = function(){
   //area init
};
app.configure('development|production', 'area', function(){
     initArea();
});

app.configure('development|production', 'chat', function() {
    app.route('chat', routeUtil.chat);
});

app.enable('systemMonitor');

app.configure('development|production','gate', function() {
    app.set('connectorConfig', {
       connector: pomelo.connectors.hybridconnector,
       heartbeat: 3
       });
    }); // configure connector for gate server

上下文变量存取

app.set(name, value, [isAttach]);
app.get(name);

app.set('server',server);
var server = app.get('server');

app.set('service', service, true);
var service = app.service;

app.set('connectorConfig', {
  // ...
}); // set opts for connector component

var backendSessionService = app.get('backendSessionService'); // get backendSessionService instance

开启和关闭功能选项

app.enable('rpcDebugLog');
app.enabled('rpcDebugLog'); // return true
app.disable('rpcDebugLog');
app.disabled('rpcDebugLog'); //return true

app.enable('systemMonitor'); // enable system monitor

加载配置文件

{
  "development":
    {
      "host":"127.0.0.1",
      "port":"3306",
      "database":"pomelo" 
    }
}

app.loadConfig('mysql', path.resolve('./config/mysql.json'));
var host = app.get('mysql').host; //返回 127.0.0.1

加载 component

app.load(HelloWorldComponent, [opts]); //opts is optional

加载 plugin

// app.use(, );

var statusPlugin = require('pomelo-status-plugin');

app.use(statusPlugin, {
 status:{
  host: '127.0.0.1',
  port: 6379
 }
});

配置 router

//routeUtil.js
app.route('chat', routeUtil.chat);

routeUtil.chat = function(session, msg, app, callback) {
    var chatServers = app.getServersByType('chat'); 
    if (!chatServers) {
     	callback(new Error('can not find chat servers.'));
		return;
    }
    var server = dispatcher.dispatch(session.rid, chatServers);
    callback(null, server.id);
};

配置 filter

app.filter(pomelo.filters.serial()); // use builtin filter: serial filter

app.filter(FooFilter); // use FooFilter as a before & after filter

app.before(beforeFilter); // use beforeFilter as a before filter

app.after(afterFilter); // use afterFilter as an after filter

配置 admin-module

app.registerAdmin(require('../modules/watchdog'), {app: app, master: true});

服务器配置文件格式

• master.json：
  • id：master 服务器的服务器 id，是一个字符串；
  • host：master 服务器的 host，可以是一个 ip 或域名；
  • port：master 服务器开的端口，默认是 3005；
  • args：可选的，在这里配置的参数选项，是用来给n ode/v8 使用的，如你可以配置 "args": "--debug=5858"，这样的话，就可以开启调试。
• servers.json：
  • id：应用服务器的服务器 id，是一个字符串；
  • host：应用服务器的 host，可以是一个 ip 或域名；
  • port：接受 rpc 请求时使用的端口号，对于后端服务器来说必须的，对于前端服务器来说，如果仅仅像 gate 服务器那样，并不维护具体的客户端连接，仅仅给客户端返回可以连接的前端服务器的地址信息的话，port 则是可以省略的。一般来说，port 不应该省略；
  • frontend：是一个 boolean 值，对于前端服务器，配置为 true，如果省略的话，则默认为 false。后端服务器不配置；
  • clientPort：这是前端服务器接受客户端连接启用的端口，对于后端服务器来说，不需要配置，对于前端服务器，则是必需的；
  • max-connections：可选的，用来说明前端服务器最多承受的连接数，如果超过了这个连接数，则后来的连接将会会 connector 拒绝；
  • args：可选的，同 master 中的语义一样。

总结