node.js中的Socket.IO使用实例


Posted in Javascript onNovember 04, 2014

1. 简介

首先是Socket.IO的官方网站:http://socket.io

官网非常简洁,甚至没有API文档,只有一个简单的“How to use”可以参考。因为Socket.IO就跟官网一样简洁好用易上手。

那么Socket.IO到底是什么呢?Socket.IO是一个WebSocket库,包括了客户端的js和服务器端的nodejs,它的目标是构建可以在不同浏览器和移动设备上使用的实时应用。它会自动根据浏览器从WebSocket、AJAX长轮询、Iframe流等等各种方式中选择最佳的方式来实现网络实时应用,非常方便和人性化,而且支持的浏览器最低达IE5.5,应该可以满足绝大部分需求了。

2. 安装部署

2.1 安装

首先安装非常简单,在node.js环境下只要一句:

npm install socket.io

2.2 结合express来构建服务器

express是一个小巧的Node.js的Web应用框架,在构建HTTP服务器时经常使用到,所以直接以Socket.IO和express为例子来讲解。

var express = require('express')

    , app = express()

    , server = require('http').createServer(app)

    , io = require('socket.io').listen(server);

server.listen(3001);

若不使用express,请参考socket.io/#how-to-use

3. 基本使用方法

主要分为服务器端和客户端两段代码,都非常简单。

Server(app.js):

//接上面的代码

app.get('/', function (req, res) {

    res.sendfile(__dirname + '/index.html');});
io.sockets.on('connection', function (socket) {

    socket.emit('news', { hello: 'world' });

    socket.on('other event', function (data) {

        console.log(data);

    });

});

首先io.sockets.on函数接受字符串"connection"作为客户端发起连接的事件,当连接成功后,调用带有socket参数的回调函数。我们在使用socket.IO的时候,基本上都在这个回调函数里面处理用户的请求。

socket最关键的是emit和on两个函数,前者提交(发出)一个事件(事件名称用字符串表示),事件名称可以自定义,也有一些默认的事件名称,紧接着是一个对象,表示向该socket发送的内容;后者接收一个事件(事件名称用字符串表示),紧接着是收到事件调用的回调函数,其中data是收到的数据。

在上面的例子中,我们发送了news事件和收到了other event事件,那么客户端应该会有对应的接收和发送事件。没错,客户端代码和服务器正好相反,而且非常相似。

Client(client.js)

<script src="/socket.io/socket.io.js"></script>

<script>

    var socket = io.connect('http://localhost');

    socket.on('news', function (data) {

        console.log(data);

        socket.emit('other event', { my: 'data' });

    });

</script>

有两点要注意的:socket.io.js路径要写对,这个js文件实际放在了服务器端的node_modules文件夹中,在请求这个文件时会重定向,因此不要诧异服务器端不存在这个文件但为什么还能正常工作。当然,你可以把服务器端的socket.io.js这个文件拷贝到本地,使它成为客户端的js文件,这样就不用每次都向Node服务器请求这个js文件,增强稳定性。第二点是要用var socket = io.connect('网站地址或ip');来获取socket对象,接着就可以使用socket来收发事件。关于事件处理,上面的代码表示收到“news”事件后,打印收到的数据,并向服务器发送“other event”事件。

注:内置默认的事件名例如“disconnect”表示客户端连接断开,“message”表示收到消息等等。自定义的事件名称,尽量不要跟Socket.IO中内置的默认事件名重名,以免造成不必要的麻烦。

4. 其他常用API

1).向所有客户端广播:socket.broadcast.emit('broadcast message');

2).进入一个房间(非常好用!相当于一个命名空间,可以对一个特定的房间广播而不影响在其他房间或不在房间的客户端):socket.join('your room name');

3).向一个房间广播消息(发送者收不到消息):socket.broadcast.to('your room name').emit('broadcast room message');

4).向一个房间广播消息(包括发送者都能收到消息)(这个API属于io.sockets):io.sockets.in('another room name').emit('broadcast room message');

5).强制使用WebSocket通信:(客户端)socket.send('hi'),(服务器)用socket.on('message', function(data){})来接收。

5. 使用Socket.IO构建一个聊天室

最后,我们通过一个简单的实例来结束本篇。用Socket.IO构建一个聊天室就是50行左右的代码的事情,实时聊天效果也非常好。以下贴出关键代码:

Server(socketChat.js)

//一个客户端连接的字典,当一个客户端连接到服务器时,

//会产生一个唯一的socketId,该字典保存socketId到用户信息(昵称等)的映射

var connectionList = {};
exports.startChat = function (io) {

    io.sockets.on('connection', function (socket) {

        //客户端连接时,保存socketId和用户名

        var socketId = socket.id;

        connectionList[socketId] = {

            socket: socket

        };
        //用户进入聊天室事件,向其他在线用户广播其用户名

        socket.on('join', function (data) {

            socket.broadcast.emit('broadcast_join', data);

            connectionList[socketId].username = data.username;

        });
        //用户离开聊天室事件,向其他在线用户广播其离开

        socket.on('disconnect', function () {

            if (connectionList[socketId].username) {

                socket.broadcast.emit('broadcast_quit', {

                    username: connectionList[socketId].username

                });

            }

            delete connectionList[socketId];

        });
        //用户发言事件,向其他在线用户广播其发言内容

        socket.on('say', function (data) {

            socket.broadcast.emit('broadcast_say',{

                username: connectionList[socketId].username,

                text: data.text

            });

        });

    })

};

Client(socketChatClient.js)

var socket = io.connect('http://localhost');

//连接服务器完毕后,马上提交一个“加入”事件,把自己的用户名告诉别人

socket.emit('join', {

    username: 'Username hehe'

});
//收到加入聊天室广播后,显示消息

socket.on('broadcast_join', function (data) {

    console.log(data.username + '加入了聊天室');

});
//收到离开聊天室广播后,显示消息

socket.on('broadcast_quit', function(data) {

    console.log(data.username + '离开了聊天室');

});
//收到别人发送的消息后,显示消息

socket.on('broadcast_say', function(data) {

    console.log(data.username + '说: ' + data.text);

});
//这里我们假设有一个文本框textarea和一个发送按钮.btn-send

//使用jQuery绑定事件

$('.btn-send').click(function(e) {

    //获取文本框的文本

    var text = $('textarea').val();

    //提交一个say事件,服务器收到就会广播

    socket.emit('say', {

        username: 'Username hehe'

        text: text

    });

});

这就是一个简单的聊天室DEMO,你可以根据你的需要随意扩展。Socket.IO基本上就是各种事件的提交和接收处理,思想非常简单。

Javascript 相关文章推荐
cssQuery()的下载与使用方法
Jan 12 Javascript
一个高效的JavaScript压缩工具下载集合
Mar 06 Javascript
js点击页面其它地方将某个显示的DIV隐藏
Jul 12 Javascript
jquery数据验证插件(自制,简单,练手)实例代码
Oct 24 Javascript
JS中操作JSON总结
Dec 06 Javascript
node.js中的http.request方法使用说明
Dec 14 Javascript
javascript鼠标滑动评分控件完整实例
May 13 Javascript
JavaScript中isPrototypeOf函数作用和使用实例
Jun 01 Javascript
基于JavaScript实现瀑布流效果
Mar 29 Javascript
原生JS进行前后端同构
Apr 22 Javascript
vue 组件的封装之基于axios的ajax请求方法
Aug 11 Javascript
Vue实现类似Spring官网图片滑动效果方法
Mar 01 Javascript
Node.js的特点和应用场景介绍
Nov 04 #Javascript
Node.js中的模块机制学习笔记
Nov 04 #Javascript
Node.js异步I/O学习笔记
Nov 04 #Javascript
JavaScript中的ubound函数使用实例
Nov 04 #Javascript
JavaScript实现检查页面上的广告是否被AdBlock屏蔽了的方法
Nov 03 #Javascript
网页中表单按回车就自动提交的问题的解决方案
Nov 03 #Javascript
详解jquery中$.ajax方法提交表单
Nov 03 #Javascript
You might like
中东人咖啡哲学
2021/03/03 咖啡文化
php FPDF类库应用实现代码
2009/03/20 PHP
PHP 批量删除 sql语句
2009/06/05 PHP
抓取并下载CSS中所有图片文件的php代码
2011/09/26 PHP
ThinkPHP写数组插入与获取最新插入数据ID实例
2014/11/03 PHP
php简单判断两个字符串是否相等的方法
2015/07/13 PHP
php 升级到 5.3+ 后出现的一些错误,如 ereg(); ereg_replace(); 函数报错
2015/12/07 PHP
Prototype使用指南之ajax
2007/01/10 Javascript
js 实现无缝滚动 兼容IE和FF
2009/07/15 Javascript
jQuery 行背景颜色的交替显示(隔行变色)实现代码
2009/12/13 Javascript
Jquery.Form 异步提交表单的简单实例
2014/03/03 Javascript
Node.js插件安装图文教程
2016/05/06 Javascript
浅谈js中子页面父页面方法 变量相互调用
2016/08/04 Javascript
js轮盘抽奖实例分析
2020/04/17 Javascript
jQuery购物网页经典制作案例
2016/08/19 Javascript
浅谈js算法和流程控制
2016/12/29 Javascript
Javascript 实现全屏滚动实例代码
2016/12/31 Javascript
提高Web性能的前端优化技巧总结
2017/02/27 Javascript
jQuery在header中设置请求信息的方法
2017/03/06 Javascript
iscroll动态加载数据完美解决方法
2017/07/18 Javascript
vue 怎么创建组件及组件使用方法
2017/07/27 Javascript
Vue2.0结合webuploader实现文件分片上传功能
2018/03/09 Javascript
小程序日历控件使用方法详解
2018/12/29 Javascript
bootstrap-table实现表头固定以及列固定的方法示例
2019/03/07 Javascript
vue 通过base64实现图片下载功能
2020/12/19 Vue.js
python 时间戳与格式化时间的转化实现代码
2016/03/23 Python
Python requests发送post请求的一些疑点
2018/05/20 Python
详解python单元测试框架unittest
2018/07/02 Python
如何解决pycharm调试报错的问题
2020/08/06 Python
英国领先的汽车轮胎和快速健康中心:Kwik Fit
2017/10/29 全球购物
Ellesse英国官网:意大利高级运动品牌
2019/07/23 全球购物
英国索普公园票务和酒店套餐:Thorpe Breaks
2019/09/14 全球购物
制定岗位职责的原则
2013/11/08 职场文书
中专生毕业个人鉴定
2014/02/26 职场文书
小学运动会报道稿
2014/10/04 职场文书
2015年小学体育教师工作总结
2015/10/23 职场文书