基于socket.io打造hybrid调试页面

前言

参考的钉钉调试页面实现，仅供学习！

功能为：

PC端编写代码，手机端执行

解决的痛点是：

避免了调试hybrid应用时重复写各类测试页面

源码与示例

源码

https://github.com/dailc/node-server-examples/tree/master/node-socketio-hybriddebug

运行

1.`npm install`

2.`npm run serve`启动`node`服务

3.浏览器打开`./test/debugroom.html`页面

4.开始测试（浏览器直接打开或手机扫码）

注意，手机端连接请确保在同一个网段

注意⚠️，实际状况请重写client页面，让其支持对于Hybrid容器的API

示例

原理

原理其实很是简单，就是HTML5中的websocket，并且为了方便，还直接使用了成熟的第三方库socket.io

基本交互以下：

1.先启动一个node后台（控制台），基于`express`和`socket.io`监听`socket`链接

2.打开一个PC端调试页面，链接后台，建立一个房间（能够建立N个房间）

3.PC端页面基于房间号生成对应房间的客户端地址（每个房间中能够有`N`个客户端），并基于地址建立二维码，方便使用（能够基于`qrcode.js`等库）

4.`Hybrid`客户端扫码后（或者打开客户端连接后），客户端页面链接后台，根据当前的房间号，在房间中建立客户端

5.PC端输入代码后，点击执行时，会将代码文本发送到后台，而后后台再推送给客户端，客户端经过`eval`便可执行这段代码，执行完毕后也可经过一样方式通知PC端

须要注意的是：

• 服务端是引用的npm的socket.io包
• 客户端是引用socket.io-client项目中发布的socket.io.js文件

另外：

• 后台程序直接基于es6语法编写的，而后基于gulp打包成dest文件，实际运行的是dest中的发布文件，代码规范接近与airbnb
• 前端页面的话比较随意，样式还大量用了钉钉本来的样式，也没有考虑各类浏览器的兼容
• 为何说是hybrid调试页面？由于打造它的核心需求就是用来调试hybridAPI

步骤

因为篇幅关系（也没有必要），并不会将全部代码都介绍一遍，只会介绍一些重点步骤，更多的能够直接阅读源码（源码中已经足够清晰）

设计DebugRoom（PC端）和DebugClient（hybrid端）

根据交互，PC端和hybrid端都须要和后台链接，所以这里直接单独封装了两个类

DebuRoom类

房间的定义是：

• 只有一个socket引用
• 有一个房间id标识
• 房间内能够管理客户端（增，删，查）

class DebugRoom {
    // 所属的房间号
    this._roomId
    // 所持有的socket对象
    this._socket
    // 客户端持有默认是一个空对象，key是clientid，value是client
    this._clients
    
    id()
    clients()
    socket()
    getClientsCount()
    removeClient(client)
    addClient(client)
    clearClients()
}

DebugClient类

客户端的定义是：

• 只有一个socket引用
• 有一个客户端id标识
• 有一个房间id引用，指向对于的房间号（固然其实也能够是引用DebugRoom对象的）

class DebugClient {
    // 所属的房间号
    this._roomId
    // 客户端id
    this._clientId
    // 所持有的socket对象
    this._socket
    
    id()
    roomId()
    socket()
}

设计一些交互接口

先后端交互经过socket.io中定义的事件来，如下是房间以及客户端和后台的交互事件接口

通用交互事件

后台：

// 后台监听链接，每有一个链接时（前端经过`io.connect`），会通知客户端触发'open'事件
io.on('connection', ...)

// 后台监听关闭链接，每当链接关闭时（前端直接关闭或调用`socket.disconnect`），会检测本地房间与客户端，若是关闭的是客户端，则移除这个客户端，对于的房间下的引用也置空，不然若是是房间，移除并关闭房间内全部的客户端
io.on('disconnect', ...)

房间与客户端：

// 前台监听打开事件，此时，若是是房间，则会通知后台触发'create room'，不然通知后台触发'create client'
socket.on('open', ...)

// 前台监听链接是否关闭
socket.on('disconnect', ...)

房间与后台交互事件

后台：

// 监听建立房间，若是房间ID合法，则会建立一个新的房间（new DebugRoom）
io.on('create room', ...)
// 监听房间分发数据，而且将数据转发给房间内的全部客户端，通知客户端触发'receive dispatch data'事件
io.on('dispatch data', ...)

房间：

// 监听客户端建立，每个客户端加入对应房间时都会通知这个房间
socket.on('client created', ...)
// 监听客户端关闭，每个客户端退出时都会通知这个房间
socket.on('client destroy', ...)
// 监听客户端执行，客户端每执行一次分发数据时，都会通知房间是否执行成功
socket.on('client excuted', ...)

客户端与后台交互事件

后台：

// 监听客户端建立，若是房间已存在，而且客户端id合法，才会正常建立，建立完后会通知房间触发'client created'事件
io.on('create client', ...)
// 监听客户端响应执行，客户端执行一次分发数据后，会通知后台，后台接收到这个事件后，通知房间触发'client excuted'事件
io.on('client excute notify', ...)

客户端：

// 监听接收分发数据，接收完后会执行数据中的代码，而且通知后台是否执行成功，触发后台的'client excute notify'事件
socket.on('receive dispatch data', ...)

一些逻辑上的细节

以上流程就是整套程序的基本思路与交互，这里再补充一些交互细节

• 用全局的roomsHash和clientsHash缓存住全部的房间和客户端，方便直接查询
• 每次建立时，id能够直接绑定在对于的socket中，这样更方便
• 房间和客户端id最好不要直接使用，能够进过一次编码（这样能够直接使用中文）
• 客户端失联时，必定要先判断房间是否以及销毁，不要重复操做
• 失去链接后，缓存中的引用要及时清除

更多源码请参考https://github.com/dailc/node-server-examples/tree/master/node-socketio-hybriddebug

附录

博客

初次发布2017.11.28于我的博客

http://www.dailichun.com/2017/11/28/socket_hybriddebug.html

参考资料

• socket.io/docs
• 钉钉JSAPI控制台