LeanEngine 中使用 WebSocket

一直以来 HTTP 协议都是使用「请求/响应」的模型,在 Web 应用越来越复杂的今天,这种模型的限制越来越明显。

很多场景下,我们想要服务器主动发送通知给浏览器,甚至我们想在浏览器中实现一个实时对战的网络游戏。这个时候 HTML5 规范中的 WebSocket 可以很好地满足我们的需求。

对于使用 LeanEngine 的用户,我们也可以直接在 LeanEngine 环境中使用 WebSocket,来构建应用了。下面我们以 LeanEngine NodeJS 运行时环境为例,实现一个 WebSocket echo server(echo server 是指返回任何接收到信息的服务)。

创建应用

我们可以使用 avoscloud new 命令来创建一个新的 LeanEngine 应用,但是简单起见,我们的还是直接手动创建我们的项目。

首先将下面的内容放到项目根目录的 package.json 文件中:

{
  "dependencies": {
    "ejs": "^2.3.2",
    "express": "^4.13.0",
    "express-ws": "^0.2.6",
    "leanengine": "^0.1.4"
  }
}

然后执行 npm install 来安装依赖。

ws 是 Node.js 一个比较常用的 WebSocket 实现模块。而 express-ws 是对其简单的封装,方便在 express 中使用。

之后创建 server.js 文件,作为应用的入口文件。在这个文件中,我们初始化 express 与 LeanCloud SDK:

var express = require("express");
var AV = require('leanengine');

// init LeanEngine
var PORT = parseInt(process.env.LC_APP_PORT || 3000);
var APP_ID = process.env.LC_APP_ID;
var APP_KEY = process.env.LC_APP_KEY;
var MASTER_KEY = process.env.LC_APP_MASTER_KEY;
AV.initialize(APP_ID, APP_KEY, MASTER_KEY);

// init express
var app = express();
app.set('view engine', 'ejs');
app.use(AV.Cloud);

// start server
app.listen(PORT);

这样一个最基本的 LeanEngine 应用就已经实现了,在此之上我们可以增加自己的路由处理与 LeanEngine 的 CloudFunc 等功能,但这不是这篇文章的重点,在此略过。

express-ws 是作为 express 的中间件实现的,之后我们需要安装此中间件:

var expressWs = require('express-ws');
expressWs(app);

之后就可以使用 app.ws 方法来注册 WebSocket 路由请求了:

app.ws('/echo', function(ws, req) {
  ws.on('message', function(msg) {
    ws.send(msg);
  });
});

这里只是简单的将收到的请求发送回客户端,你也可以实现其他自定义的操作。

使用 LeanCloud 提供的命令行工具,我们可以将应用部署到服务器上:avoscloud deploy && avoscloud publish

wscat 是一个基于 Node.js 实现的命令行工具,可以用来测试我们的 echo server。使用 npm install wscat -g 来安装此工具,之后 wscat -c ws://websocket.avosapps.com(将 websocket 替换成自己在 LeanCloud 注册的二级域名)连接自己的服务:

$ wscat -c ws://websocket.avosapps.com/echo
connected (press CTRL+C to quit)
> Hello WebSocket!
< Hello WebSocket!
>

如果没有问题的话,基于 LeanEngine 的 WebSocket 服务就搭建成功了。

以上代码参见 Github Demo,效果参考 http://websocket.avosapps.com

备注 :LeanCloud 还提供 实时通讯 服务,相比自己使用 WebSocket,它能帮你更加轻松地实现实时聊天等功能,并且你也不用担心部署、断线重连与自动扩容等问题。

LeanEngine 中使用 WebSocket》上有1条评论

  1. Pingback引用通告: 2015 年 5 — 8 月份 LeanCloud 更新汇总 | LeanCloud Blog

发表评论

电子邮件地址不会被公开。 必填项已用*标注