Pomelo 新手周计划学习笔记(一) Nodejs版

Pomelo 新手周计划学习笔记(一) Nodejs版

前言

由于目前Pomelo公开资料中缺乏教程类的内容，我决定花一周时间来学习Pomelo。因此，我将撰写一系列学习笔记，用于记录我的学习过程。预计会有七篇，这篇是星期一的学习笔记。

通读API

既然要使用一个框架，对框架提供的API必须非常熟悉。Pomelo的API相对较少，因此我会将其拆分成几个部分，以便初学者更容易理解。

Application 类

Application 类包含了许多方法，我们将其分为几类进行介绍：

环境相关方法

app.getBase(); // 获取基础路径
app.set(key, value); // 设置配置项
app.get(key); // 获取配置项
app.enabled(key); // 检查是否启用了某个功能
app.disabled(key); // 检查是否禁用了某个功能
app.enable(key); // 启用某个功能
app.disable(key); // 禁用某个功能
app.configure(key, fn); // 配置应用

初始化相关方法

app.start(); // 启动应用
app.registerAdmin(route, handler); // 注册管理路由
app.filter(filterName, filterFn); // 添加过滤器
app.before(route, handler); // 添加前置处理器
app.after(route, handler); // 添加后置处理器
app.load(plugin); // 加载插件
app.loadConfig(path); // 加载配置文件

组件相关方法

app.route(route, handler); // 注册路由
app.getMaster(); // 获取主服务器实例
app.getCurServer(); // 获取当前服务器实例
app.getServerId(); // 获取当前服务器ID
app.getServerType(); // 获取当前服务器类型
app.getServers(); // 获取所有服务器列表
app.getServersFromConfig(); // 从配置文件获取所有服务器列表
app.getServerTypes(); // 获取所有服务器类型
app.getServerById(id); // 根据ID获取服务器实例
app.getServerFromConfig(type); // 从配置文件获取指定类型的服务器实例
app.getServersByType(type); // 获取指定类型的服务器实例
app.isFrontend(); // 判断是否为前端服务器
app.isBackend(); // 判断是否为后台服务器
app.isMaster(); // 判断是否为主服务器
app.addServers(servers); // 添加新服务器
app.removeServers(servers); // 移除服务器

Pomelo: Hello World

安装好Pomelo后，创建一个项目非常简单：

pomelo init helloworld

这样我们就创建了一个名为helloworld的项目。

客户端编写

下面我们来看一下客户端如何与服务端进行通信。

客户端代码

var pomelo = window.pomelo;
var host = "127.0.0.1";
var port = "3010";

function show() {
  pomelo.init({
    host: host,
    port: port,
    log: true
  }, function() {
    pomelo.request("connector.entryHandler.entry", "hello pomelo", function(data) {
      alert(data.msg);
    });
  });
}

服务端代码

在game-server目录下的app/servers/connector/handler/entryHandler.js文件中，我们可以找到entry方法。为了验证我们的想法，我们在该文件中添加一个新的处理函数：

Handler.prototype.helloworld = function(msg, session, next) {
  console.log(msg);
  console.log(session);
  next(null, { code: 200, msg: 'Hello world!' });
};

修改客户端请求

修改客户端代码以调用新的处理函数：

pomelo.request("connector.entryHandler.helloworld", "hello pomelo", function(data) {
  alert(data.msg);
});

运行项目，就可以看到服务端与客户端成功进行了通信。

总结

今天我们了解了如何创建Pomelo项目，并且学会了如何编写客户端代码与服务端进行通信。接下来我们将继续深入学习其他方面的内容。

希望这些示例代码和解释对你有所帮助！如果你有任何问题，欢迎随时提问。