Pomelo 新手周计划（二） Nodejs版

##前言## 昨天，简要的介绍了客户端如何发起对Pomelo的请求和处理pomelo响应，今天，我们说一下，Pomelo服务端如何处理请求响应以及如何开始我们服务端代码的编写。

##Pomelo 请求与响应##

Pomelo请求响应流程图。

在pomelo 请求响应模型中，它只有三层。

发起请求与响应的客户端。
接受，响应请求的Frontend。
处理Frontend 请求与响应的Backend。

在昨天，我们已经知道了如何利用frontend进行与客户端的通信，那么什么是Backend?

我先来看一下官方的定义：

Frontend（connector）

用于面向客户端的连接
维护Session信息
分发请求给Backend
推送消息给客户端

Backend

处理来自于Frontend的请求
通过Channel 或者 Response 推送请求给frontend
Rpc 服务

从以上定义中，我们可以这么认为，Frontend 是用于面向客户端请求的服务器，用于维护当前的连接数以及让客户端能够访问Backend 的桥梁，而Backend 用于处理游戏的逻辑。

为了方便了解，我们可以阅读官方提供的框架图。

###创建Frontend和Backend### Pomelo 有一个特点就是通过对目录和命名约定进行来进行对组件的创建。现在我们去到./game-server/app/servers/ 我们所有关于frontend和backend的代码都有在该目录下创建。

创建规则 ###Frontend的创建###

servers
├─connector
│  └─handler
│          entryHandler.js

第一级目录为servers Type，就是定义这个在服务端处于什么类型，例如，我们要创建一个gate 类型的服务用于负载均衡的话，我们只需要创建一个把connector 改为gate。

第二级目录约定为handler,所有处理请求的js文件都放在该目录下面。

entryHandler.js 这个文件为我们处理请求和响应的文件。

以上规则就是我们在Pomelo 里面要响应对客户端请求的步骤。然后，我们只需要在配置文件上面做一些修改，Pomelo在启动的时候就会加载我们创建好的frontend了。（详情阅读声明使用Frontend和Backend）

对于客户端而言只要在请求的时候对应以上规则即可阅读hello world项目 /public/index.html 大概19 -36行代码

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

假如我们常见了一个gate的 frontend 用于负载均衡我们在客户端只需要做如下修改就能进行对gate的访问了。

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

###Backend的创建###

servers
└─testBackend
    ├─handler
    │      entryHandler.js
    │
    └─remote
            testBackendremote.js

规则与frontend基本一致，不过多了一个remote目录，用于RPC 的处理。然后，我们只需要在配置文件上面做相关配置，pomelo在启动的时候就会加载我们创建好的Backend。（详情阅读声明使用frontend，backend）

接着客户端如果要访问Backend 需要先连接接Frontend 再从回调中发起对Backend的访问。

client -> frontend -> backend 这个过程不可越过

hello world项目 /public/index.html 大概19 -36行代码增加。

     pomelo.request("connector.entryHandler.entry", "hello frontend",   function(data) {
         pomelo.request("testBackend.entryHandler.entry", "hello backend", function(data) {
                    alert(data.msg);
                });
            });

做了以上的修改以后，客户端就能对服务端的Backend发起请求并且响应。

##配置Frontend和Backend## 上面我们知道了如何在服务端创建Frontend，Backend规则，那么Pomelo如何加载我们的定义好的的frontend,和backend 呢？

要让pomelo 加载我们创建好的frontend和backend 需要在 ./game-server/config/servers.json 作以下修改。因为development与production的设置是一样的这里就以development为例

{
    "development": {
        "connector": [
            {
                "id": "connector-server-1",
                "host": "127.0.0.1",
                "port": 3150,
                "clientPort": 3010,
                "frontend": true
            }
        ],
        "testBackend": [
            {
                "id": "test-server-1",
                "host": "127.0.0.1",
                "port": 3151
            }
        ]
    }
}

###Frontend配置说明###

对于frontend 对象而言

"connector": [
            {
                "id": "connector-server-1",
                "host": "127.0.0.1",
                "port": 3150,
                "clientPort": 3010,
                "frontend": true
            }
        ]

id 就是该frontend的在服务器的名字
host 服务器的地址
port 服务器的端口号
clientPort 客户端用于连接的端口号
frontend 是否是一个frontend

###Backend配置说明### backend对象基本与frontend一致，只是少了面向客户端端口的声明

"testBackend": [
            {
                "id": "test-server-1",
                "host": "127.0.0.1",
                "port": 3151
            }
        ]

id 就是该frontend的在服务器的名字
host 服务器的地址
port 服务器的端口号

###添加服务器### 对于Pomelo而言，添加服务器只需要在配置文件中作如下修改，这样我们就添加多了一台connector的服务器了，如果要添加一台backend服务器，也是一样的道理。

"connector": [
            {
                "id": "connector-server-1",
                "host": "127.0.0.1",
                "port": 3150,
                "clientPort": 3010,
                "frontend": true
            }， 
			{
                "id": "connector-server-2",
                "host": "127.0.0.1",
                "port": 3151,
                "clientPort": 3011,
                "frontend": true
            }
        ]

##总结## 今天，对于Pomelo的理解：

服务端

如何进行请求响应。
如何创建我们一个frontend或者backend。
如何通过配置文件让pomelo加载我们的frontend和backend。

客户端

客户端如何发起对backend请求。

##资料来源## pomelo 官方wiki

也欢迎到我的博客阅读：http://blog.gfdsa.net/2013/06/04/pomelo_study_two/

eggper 1楼

Pomelo 新手周计划（二） Nodejs版

前言

昨天我们简单介绍了客户端如何发起对Pomelo的请求及处理Pomelo响应。今天我们将深入探讨Pomelo服务端如何处理请求和响应，并学习如何编写服务端代码。

Pomelo 请求与响应

在Pomelo中，请求响应的流程如下图所示：

Pomelo的请求响应模型分为三个主要层次：

客户端：发起请求并接收响应。
前端（Frontend）：负责与客户端建立连接、维护Session信息，并将请求转发至后端（Backend）。
后端（Backend）：处理来自前端的请求，并通过Channel或Response推送响应给前端。

创建 Frontend 和 Backend

Frontend 的创建

Pomelo遵循特定的目录和命名约定来创建Frontend和Backend组件。我们可以在./game-server/app/servers/目录下找到这些组件。

创建规则

servers
├─connector
│  └─handler
│          entryHandler.js

第一级目录定义了服务端的类型，如connector表示一个连接器。
第二级目录handler存放处理请求的JavaScript文件。
entryHandler.js是处理请求和响应的核心文件。

示例代码

// ./game-server/app/servers/connector/handler/entryHandler.js
module.exports = function (app) {
    return new Handler(app);
};

function Handler(app) {
    this.app = app;
}

Handler.prototype.entry = function (msg, session, next) {
    let data = { msg: 'Hello from Frontend' };
    next(null, data);
};

Backend 的创建

创建规则

servers
└─testBackend
    ├─handler
    │      entryHandler.js
    │
    └─remote
            testBackendremote.js

remote目录用于处理远程调用（RPC）。
entryHandler.js和remote/testBackendremote.js分别处理请求和远程方法。

示例代码

// ./game-server/app/servers/testBackend/handler/entryHandler.js
module.exports = function (app) {
    return new Handler(app);
};

function Handler(app) {
    this.app = app;
}

Handler.prototype.entry = function (msg, session, next) {
    let data = { msg: 'Hello from Backend' };
    next(null, data);
};

配置 Frontend 和 Backend

为了让Pomelo加载我们创建的Frontend和Backend，需要在配置文件./game-server/config/servers.json中进行相应配置。

示例配置

{
    "development": {
        "connector": [
            {
                "id": "connector-server-1",
                "host": "127.0.0.1",
                "port": 3150,
                "clientPort": 3010,
                "frontend": true
            }
        ],
        "testBackend": [
            {
                "id": "test-server-1",
                "host": "127.0.0.1",
                "port": 3151
            }
        ]
    }
}

客户端请求

客户端需要先连接到Frontend，再从回调中发起对Backend的请求。

示例代码

pomelo.request("connector.entryHandler.entry", "hello frontend", function(data) {
    console.log('Frontend response:', data);

    pomelo.request("testBackend.entryHandler.entry", "hello backend", function(data) {
        console.log('Backend response:', data);
    });
});

总结

今天，我们学习了如何在Pomelo中实现请求响应机制，包括创建Frontend和Backend组件、配置文件的设置以及客户端如何发起对Backend的请求。希望这些内容能帮助你更好地理解和使用Pomelo。

资料来源

songsunli 2楼

有一点没看懂：两个frontend 服务器开了两个端口，客户端还要知道后台的多个端口，再选一个连接？这应该是 balancer 做的事。

wuwangju 3楼

这里一共需要是三台 frontend 服务器，一台负责负载均衡，两台处理。

客户端发起请求的时候，先访问负载均衡那台服务器，从负载服务器那里获取到相应的连接服务器。

sinazl 4楼

嗯，负载均衡不是框架该做的事。

在Lord of Pomelo的demo里采用的策略是先问gate服务器要connector的地址，然后连connector。产品环境也可以采用其它策略，我们的消息推送平台是在pomelo前面架了LVS

htzhanglong 5楼

lvs 作者是章文嵩博士？

sinazl 6楼

在“Pomelo 新手周计划（二） Nodejs版”的帖子中，主要讨论了Pomelo服务端如何处理客户端请求及响应，以及如何创建前端（frontend）和后端（backend）组件，并通过配置文件让Pomelo加载这些组件。

创建 Frontend 和 Backend

Frontend 创建

假设我们要创建一个名为connector的frontend，其结构如下：

servers
└─connector
    └─handler
            entryHandler.js

其中entryHandler.js文件负责处理客户端的请求和响应，代码示例如下：

// ./game-server/app/servers/connector/handler/entryHandler.js
module.exports = function (app) {
    return {
        handle: function (msg, session, next) {
            // 在这里处理客户端的请求
            console.log('Received message:', msg);

            // 向客户端发送响应
            next(null, { code: 200, msg: 'Hello from connector server' });
        }
    };
};

Backend 创建

创建一个名为testBackend的backend，结构如下：

servers
└─testBackend
    └─handler
            entryHandler.js
    └─remote
            testBackendremote.js

其中entryHandler.js处理来自frontend的请求，testBackendremote.js则提供远程调用接口，示例如下：

// ./game-server/app/servers/testBackend/handler/entryHandler.js
module.exports = function (app) {
    return {
        handle: function (msg, session, cb) {
            console.log('Received message:', msg);
            cb(null, { code: 200, msg: 'Hello from testBackend server' });
        }
    };
};

// ./game-server/app/servers/testBackend/remote/testBackendremote.js
module.exports = function (app) {
    return {
        sayHello: function (name, cb) {
            cb(null, `Hello ${name}`);
        }
    };
};

配置 Frontend 和 Backend

要让Pomelo加载这些frontend和backend，需要在配置文件./game-server/config/servers.json中进行相应配置：

{
    "development": {
        "connector": [
            {
                "id": "connector-server-1",
                "host": "127.0.0.1",
                "port": 3150,
                "clientPort": 3010,
                "frontend": true
            }
        ],
        "testBackend": [
            {
                "id": "test-server-1",
                "host": "127.0.0.1",
                "port": 3151
            }
        ]
    }
}

总结

通过上述步骤，你可以创建并配置frontend和backend组件，使Pomelo服务端能够正确地处理客户端请求及响应。