JavaScript设计模式 - 发布订阅最佳实践

什么是设计模式?

  • 设计模式(Design pattern)代表了最佳的实践,通常被有经验的面向对象的软件开发人员所采用。设计模式是软件开发人员在软件开发过程中面临的一般问题的解决方案。这些解决方案是众多软件开发人员经过相当长的一段时间的试验和错误总结出来的。
  • 在 1994 年,由 Erich Gamma、Richard Helm、Ralph Johnson 和 John Vlissides 四人合著出版了一本名为 Design Patterns - Elements of Reusable Object-Oriented Software(中文译名:设计模式 - 可复用的面向对象软件元素) 的书,该书首次提到了软件开发中设计模式的概念。四位作者合称 GOF(四人帮,全拼 Gang of Four)
  • 设计模式其实是一种解决方案、一种编程套路、一种解决问题的思想,并不是具体的代码,代码只是它具体的实现,它跟编程语言无关,框架无关,你可以用JavaScript实现、也可以是Go实现、你可以在Vue里用,也可以在React里用。
  • 特别注意:"使用设计模式是为了可重用代码、让代码更容易被他人理解、保证代码可靠性、程序的重用性。"如果你不能满足这个前提,那就不要用,一定要根据业务场景去选择合适的设计模式,不要生搬硬套。
文本所有代码都是用node v17.8.0 版本进行开发和运行;使用pnpm包管理进行依赖管理和安装;

什么是发布订阅?

  • 发布订阅其实就是一个事件模型,平时咱们前端开发常用的事件监听,其实就是一个发布订阅模式;它把一些列用户监听(订阅)的事件收集起来,然后当用户点击监听(订阅)的按钮时,就触发(发布)该事件的所有监听(订阅)函数;
  • 咱们的公众号也是发布订阅模式;关注(订阅)一个公众号,当这个公众号有新文章发布时,所有关注这种公众号的用户都能收到新文章发布的消息!
  • 下面我们来看一个平时开发中最常见的发布订阅例子:

    
    
    
    
      
      发布订阅 - 事件监听
    
    
    
    点我
  • 运行结果:

image-20220425230355831

  • 可以发现,发布订阅其实是我们前端最早接触到的设计模式,也是最最常用的设计模式;像click或者keydown这种都是浏览器内置定义好的事件,只有点击元素或者按下键盘时才会触发!
  • 如果说我想弄一个浏览器没有定义的事件行不行?当然可以,因为浏览器是支持自定义事件的,下面通过例子演示一下如何使用浏览器的自定义事件:

    
    
    
    
      
      发布订阅 - 浏览器自定义事件
    
    
    
    
    

    运行结果:

JavaScript设计模式 - 发布订阅最佳实践_第1张图片

通过上述两个例子可以发现,如果要在浏览器内使用发布订阅模式,直接使用浏览器的自定义事件即可,无需引入三方库和自己造轮子了;但是缺点就是移植性差,你只能在支持CustomEvent的浏览器中使用,你无法将你的代码移植到Node环境中或者不支持CustomEvent的小程序环境中使用。
JavaScript设计模式 - 发布订阅最佳实践_第2张图片
通过caniuse可以发现,各大浏览器厂商从2011年开始陆续支持CustomEvent到2013年基本当时所有主流的浏览器都支持了,后面像Edge这种新浏览器从2015年推出的第一个版本就支持了;2013~2022至今9年时间,所以大家可以放心大胆使用了。

发布订阅的应用场景

通过上述的两个小例子,咱们基本上已经了解了什么是发布订阅模式了;咱们先忘掉那些高深的概念,先记住发布订阅如何使用,用一句话来记住它的用法:"先订阅(监听)事件,然后发布(触发)事件"就这么简单,但是上述的两个小例子并不能完全展示发布订阅的真正威力,下面我通过一系列的应用场景来展示一下发布订阅的真正威力。

跨IFrame传递数据

我们日常工作中经常会遇到一种情况,需要在一个系统里面通过iframe嵌入其他域名下的某个页面;这时候两个系统之间的数据通讯,我们也可以通过发布订阅的方式进行,下面通过一个简单的例子演示一下:

  • 被嵌入的iframe页面:

    
    
    
    
      
      我是iframe页面
      
    
    
      

    我是iframe

  • 主页面:

    
    
    
    
      
      主页面
      
    
    
      

    我是主页面index

    以下内容是从iframe中通过发布订阅模式传递过来的:

    运行结果:
    JavaScript设计模式 - 发布订阅最佳实践_第3张图片

  • 通过上述代码可以发现,我们通过在index.html中订阅一个iframe-data自定义事件,然后在iframe.html页面中发布iframe-data事件通过参数将数据传递给主页面上!
  • 此时有的同学会说,你通过top.document.querySelector('#content').innerHTML进行修改元素的内容不就可以了吗?为什么非要使用发布订阅这种模式呢?当前这个例子的场景下是可以的,而且更加简单;但是如果说index.html页面是使用vue编写的而且div#content渲染时机还不确定,iframe.html页面是使用React编写的;这个时候你用top.document.querySelector('#content')就会找不到元素了,下面通过例子模拟演示一下:

被嵌入的iframe页面:





    
    我是iframe页面
    


    

发布者:我是iframe,用React编写的

主页面:





    
    主页面
    


    

订阅者:我是主页面index,用Vue写的,content元素10秒后才会被插入

以下内容是从iframe中通过发布订阅模式传递过来的:

运行结果:

JavaScript设计模式 - 发布订阅最佳实践_第4张图片
感受到发布订阅的威力了吗?发布者不需要关心订阅者的业务逻辑,老子才不管你的dom元素啥时候渲染,我只管触发事件把数据传给你订阅者;至于订阅者你怎么使用或啥时候使用这个数据我不管,你什么业务逻辑我也不管;

React跨组件之间传递数据

JavaScript设计模式 - 发布订阅最佳实践_第5张图片

  • 在说跨组件传递数据之前,我们先来看一下上述这张组织架构图,皇帝要下达一条消息,都是通过丞相层层传递到各级官员的;亭长要上报一条消息给皇帝,也得层层上报,才能到皇帝耳朵里。这种方式最大的问题消息传递链路很长,消息可能会被劫持不报,传丢了,下面我们通过代码来演示一下上述效果:
// example/demo05-passing-data-across-components/src/donot-use-publish-subscribe.jsx
// @ts-nocheck
import React from "react";
import './app.css'

function 亭长(props) {
  return 
亭长{props.shengzhi ? ': 卑职明白' : ''} { props.shengzhi ? '' : props.上奏折('皇上,郎中令那个王八蛋抢了我老婆!')}>上奏折 }
} function 乡(props) { return
乡{props.shengzhi ? ': 卑职明白' : ''}
<亭长 {...props} />
} function 县令(props) { return
县令{props.shengzhi ? ': 卑职明白' : ''}
<乡 {...props} />
} function 郡守(props) { return
郡守{props.shengzhi ? ': 卑职明白' : ''}
<县令 {...props} />
} function 少府(props) { return
少府{props.shengzhi ? ': 卑职明白' : ''}
} function 郎中令(props) { return
郎中令{props.shengzhi ? ': 卑职明白' : ''}
<郡守 {...props} />
} function 宗正(props) { return
宗正{props.shengzhi ? ': 卑职明白' : ''}
} function 御史大夫(props) { return
御史大夫{props.shengzhi ? ': 卑职明白' : ''}
} function 丞相(props) { return
丞相{props.shengzhi ? ': 卑职明白' : ''}
<少府 {...props} /> <郎中令 {...props} /> <宗正 {...props} />
} function 太尉(props) { return
太尉{props.shengzhi ? ': 卑职明白' : ''}
} export default class 皇帝 extends React.Component { state = { shengzhi: '', zhouze: '' } render() { return <>
皇帝 { this.state.zhouze ? ': 大胆郎中令,你竟敢干出如此伤天害理之事!' : '' } 下圣旨
<御史大夫 {...this.state} /> <丞相 {...this.state} 上奏折={this.上奏折} /> <太尉 {...this.state} />
} 下圣旨 = () => { this.setState({ shengzhi: '朕要大赦天下' }); } 上奏折 = (奏折内容) => { this.setState({ zhouze: 奏折内容 }) } }
注意: 上述代码是为了让大家能够更加清晰的看清楚这个组织架构,所以故意用的中文命名,实际开发中大家千万不要用中文命名挑战JavaScript的底线。

​ 通过上述代码我们可以发现,每个组件之间传递数据都是通过props进行的,有很多的props,但凡有一点疏忽,把props传丢了,那么我们这个组件就接收不到数据了。 JavaScript设计模式 - 发布订阅最佳实践_第6张图片

​ 而且按照这种层层上报的机制,在上述古代官员的组织架构层级中就会存在一个问题,亭长他想跟皇帝告发郎中令抢了他老婆的这个禽兽行为,层层上报的话,它一定会经过这个郎中令的,到郎中令这里只有他不想死,那么他一定不会在往上传递了。如果此时亭长还想告发郎中令的禽兽行为,应该怎么办呢?还有条途径就是告御状,告御状跟咱们的发布订阅有着异曲同工之妙,相当于建立了一条亭长跟皇帝的专属通道,亭长可以直通皇帝,下面我们来看代码:

// example/demo05-passing-data-across-components/src/use-publish-subscribe.jsx
// @ts-nocheck
import React from "react";
import './app.css'

function 亭长(props) {
  return 
亭长{props.shengzhi ? ': 卑职明白' : ''} { props.shengzhi ? '' : document.dispatchEvent(new CustomEvent('告御状', { detail: { zhouze: '皇上,郎中令那个王八蛋抢了我老婆!' }}))}>上奏折 }
} function 乡(props) { return
乡{props.shengzhi ? ': 卑职明白' : ''}
<亭长 {...props} />
} function 县令(props) { return
县令{props.shengzhi ? ': 卑职明白' : ''}
<乡 {...props} />
} function 郡守(props) { return
郡守{props.shengzhi ? ': 卑职明白' : ''}
<县令 {...props} />
} function 少府(props) { return
少府{props.shengzhi ? ': 卑职明白' : ''}
} function 郎中令(props) { return
郎中令{props.shengzhi ? ': 卑职明白' : ''}
<郡守 {...props} />
} function 宗正(props) { return
宗正{props.shengzhi ? ': 卑职明白' : ''}
} function 御史大夫(props) { return
御史大夫{props.shengzhi ? ': 卑职明白' : ''}
} function 丞相(props) { return
丞相{props.shengzhi ? ': 卑职明白' : ''}
<少府 {...props} /> <郎中令 {...props} /> <宗正 {...props} />
} function 太尉(props) { return
太尉{props.shengzhi ? ': 卑职明白' : ''}
} export default class 皇帝 extends React.Component { state = { shengzhi: '', zhouze: '' } componentDidMount() { // 接收御状消息 document.addEventListener('告御状', (e) => { this.setState({ zhouze: e.detail.zhouze }) }); } render() { return <>
皇帝 { this.state.zhouze ? ': 大胆郎中令,你竟敢干出如此伤天害理之事!' : '' } 下圣旨
<御史大夫 {...this.state} /> <丞相 {...this.state} /> <太尉 {...this.state} />
} 下圣旨 = () => { this.setState({ shengzhi: '朕要大赦天下' }); } }

JavaScript设计模式 - 发布订阅最佳实践_第7张图片

  • 通过上述代码我们可以发现,使用发布订阅模式亭长直接就把奏折消息传递给皇帝了,没有经过任何的其他组件,这就是发布订阅的威力;

redux与发布订阅的区别

​ 这里有的同学会问有一个redux的东西也可以实现跨组件共享数据,这个跟发布订阅有什么区别呢?其实最本质的区别是redux是跨组件共享数据,把各个组件需要用到的数据,统一放到store里,所有组件都有能获取这里面的数据,也都有资格修改这里面的数据。

​ 发布订阅只是传递数据,它并没有存储数据、修改数据的能力,它能够帮你无视掉各个组件之间的层级关系,直接把数据传递过去;你只要知道事件名称就可以了,真正存储数据修改数据还是在组件的本身,下面我们通过代码来看一下用redux实现上述组织架构的跨组件共享数据:

// example/demo05-passing-data-across-components/src/use-react-redux.jsx
// @ts-nocheck
import React from "react";
import { Provider, useSelector, connect } from 'react-redux';
import store from './store';
import { reduxShangZhouZe, reduxXiaShengZhi } from './store/action';
import './app.css'

function 亭长() {
  const shengzhi = useSelector(state => state.shengzhi)
  return 
亭长{shengzhi ? ': 卑职明白' : ''} { shengzhi ? '' : reduxShangZhouZe('皇上,郎中令那个王八蛋抢了我老婆!')}>上奏折 }
} function 乡() { const shengzhi = useSelector(state => state.shengzhi) return
乡{shengzhi ? ': 卑职明白' : ''}
<亭长 />
} function 县令() { const shengzhi = useSelector(state => state.shengzhi) return
县令{shengzhi ? ': 卑职明白' : ''}
<乡 />
} function 郡守() { const shengzhi = useSelector(state => state.shengzhi) return
郡守{shengzhi ? ': 卑职明白' : ''}
<县令 />
} function 少府() { const shengzhi = useSelector(state => state.shengzhi) return
少府{shengzhi ? ': 卑职明白' : ''}
} function 郎中令() { const shengzhi = useSelector(state => state.shengzhi) return
郎中令{shengzhi ? ': 卑职明白' : ''}
<郡守 />
} function 宗正() { const shengzhi = useSelector(state => state.shengzhi) return
宗正{shengzhi ? ': 卑职明白' : ''}
} function 御史大夫() { const shengzhi = useSelector(state => state.shengzhi) return
御史大夫{shengzhi ? ': 卑职明白' : ''}
} function 丞相() { const shengzhi = useSelector(state => state.shengzhi) return
丞相{shengzhi ? ': 卑职明白' : ''}
<少府 /> <郎中令 /> <宗正 />
} function 太尉() { const shengzhi = useSelector(state => state.shengzhi) return
太尉{shengzhi ? ': 卑职明白' : ''}
} @connect(state => state) class 皇帝 extends React.Component { render() { return <>
皇帝 { this.props.zhouze ? ': 大胆郎中令,你竟敢干出如此伤天害理之事!' : '' } 下圣旨
<御史大夫 /> <丞相 /> <太尉 />
} 下圣旨 = () => { reduxXiaShengZhi('朕要大赦天下'); } } export default () => <皇帝 />

运行效果:

JavaScript设计模式 - 发布订阅最佳实践_第8张图片

​ 从运行效果来看和发布订阅没有任何区别,但是给我们最大的感受就是代码量增加了很多,尤其是初始化redux一下就增加了5个文件;如果你从来没有接触过redux的话,这对于你来说这的确会有一点小小的难度,更加觉得发布订阅的简单;除了这个变化以外,还有一个变化就是咱们的state数据都被放入到了redux中,组件之间也不在需要通过props层层传递了,要让数据变化的时候,直接修改redux中的数据就可以了,组件展示数据也是从redux中取,任何组件都可以操作修改redux中的数据。

CocosCreator 与 React 跨框架之间传递数据

JavaScript设计模式 - 发布订阅最佳实践_第9张图片

  • 跨组件传递数据只是发布订阅模式的牛刀小试,跨框架传递数据才能真正展示它的威力,玩过Cocos的同学都知道开发Cocos游戏必须要用CocosCreator这个软件进行开发,而且它跟React这个框架也有非常大的区别,如何做到低耦合、低侵入实现二者的相互数据通讯尤为重要;因为在实际工作中Cocos游戏开发和React前端开发通常都是两个团队,通常对彼此的框架都不太了解,所以框架之间的互相通讯解耦非常重要。
  • 在我的工作生涯中就遇到过这么一种场景,有一个功能是用cocos编写实现的(是游戏团队负责开发的他们不懂React),但是需要嵌入到用React写的前端页面(前端团队负责开发页面他们不懂Cocos),并且需要在前端页面里操控cocos里面的一些行为;怎样做到我不需要了解对方的框架和逻辑细节,并且能够操控对方的框架的一些行为?用发布订阅就能够完美解决这个问题,下面我通过一个demo来模拟一下这个场景。

JavaScript设计模式 - 发布订阅最佳实践_第10张图片

  • 上图是CocosCreator的开发界面,假设这是游戏团队开发的一个小游戏,他们不懂React,就会用CocosCreator开发游戏,开发好以后构建打包交给前端团队,由前端团队嵌入到他们的前端页面中,但是需要前端页面操作cocos里面的关闭音乐亢龙有悔这两个功能;而且Cocos游戏和React前端页面都是独立仓库、独立部署。

JavaScript设计模式 - 发布订阅最佳实践_第11张图片

  • 上图是CocosCreator打包编译后的源码和资源,可以发现资源和源码都进行了拆分和压缩,可读性很低了;我们前端要嵌入Cocos游戏也是一个编译后的代码,如果从这个切入点入手,显然是不可取的。
  • 如果用发布订阅就很简单了,Cocos游戏团队开发人员只需要添加两行订阅事件的代码就可以了,代码如下:
// 订阅 亢龙有悔 事件
document.addEventListener('onKangLongYouHui', this.onKangLongYouHui.bind(this));
// 订阅 关闭音乐 事件
document.addEventListener('onCloseMusic', this.onCloseMusic.bind(this));
  • Cocos开发人员不需要关心前端如何嵌入他的游戏?如何触发他的事件?他只要监听到两个事件被触发时,去做相关的处理就可以了;
  • 前端开发人员也不需要关心Cocos内部是怎么关闭音乐的?怎么发出亢龙有悔技能的;前端只需要知道当我触发onCloseMusic事件就是关闭音乐,触发onKangLongYouHui事件就是触发亢龙有悔技能,至于你cocos内部逻辑如何实现,如何编写代码,我不需要关心,完全解耦,下面我们来看一下代码实现:
  • 首先大家不需要安装CocosCreator相关环境和软件,你只需要进入/blog/design-patterns/publish-subscribe/example/demo06-cocos-across-react/Kingdoms/build/web-mobile这个目录下启动一个http服务即可,例如:

JavaScript设计模式 - 发布订阅最佳实践_第12张图片

  • 服务端启动以后,可以在浏览器中进行访问,运行起来的效果如下:

JavaScript设计模式 - 发布订阅最佳实践_第13张图片

  • Cocos游戏的demo已经顺利运行起来了,但是我们无法对游戏角色进行操作;此时如果我们项目触发亢龙有悔技能怎么办?其实可以通过控制台直接触发订阅的事件即可,例如:

  • 可以看到,咱们只要在控制台中发布(触发)onKangLongYouHui这个事件就可以操作Cocos中的角色发出亢龙有悔这个技能,我们根本不需要懂Cocos也不需要了解这个技能是实现逻辑以及它的动画是如何控制的,是不是很解耦?但是,我们的前端程序员可以通过控制台触发,给用户用的话,咱们就不能这么暴力了,接下来我们需要通过一个页面将这个游戏嵌入到我们的页面中,然后通过按钮来触发,下面我们来看代码:
// example/demo06-cocos-across-react/react-with-cocos/src/app.jsx
import { useCallback } from 'react';
import cs from './app.module.scss';

function App() {
  const onCloseMusic = useCallback(() => {
    document.querySelector('iframe').contentWindow.document.dispatchEvent(new CustomEvent('onCloseMusic'));
  }, []);

  const onKangLongYouHui = useCallback(() => {
    document.querySelector('iframe').contentWindow.document.dispatchEvent(new CustomEvent('onKangLongYouHui'))
    console.log(document.querySelector('iframe').contentWindow.document)
  }, []);

  return (
    

下面是React框架里面的代码

关闭音乐
亢龙有悔
) } export default App

  • 通过运行效果可以发现,通过发布订阅我们已经成功实现了在React框架里控制了Cocos游戏里面的一些行为了,而且咱们都不需要安装CocosCreator相关的开发环境。当然这里只是演示React和Cocos的通讯,如果你是Vue或者Angular都是可以的,这个东西与框架语言无关,核心是思想。

JavaScript设计模式 - 发布订阅最佳实践_第14张图片

  • 通过发布订阅模式就能够实现Cocos游戏逻辑和前端React逻辑的解耦,双方只要约定好事件名称的功能就好了,至于对方的逻辑怎么实现,彼此都不需要关心;Cocos游戏团队订阅好onKangLongYouHui事件了,至于你前端什么时候触发我不管,你爱啥时候触发啥时候触发;我只关注当你触发的时候,我就给你放技能。

客户端(Android)与前端(JavaScript)通讯

JavaScript设计模式 - 发布订阅最佳实践_第15张图片

​ 开发过hybrid的同学应该都知道前端和客户端有一种通讯方式叫做bridge,通过bridge可以实现客户端与前端的相互通讯,从而扩展前端的能力。其实我们开发的网页不管是移动端还是PC端,咱们的前端代码都不只是直接运行在系统上的,PC端是运行在操作系统上的一个浏览器软件上,移动端是运行在操作系统的一个APP里的Webview组件上的,所以我们前端并没有太多能够直接去操作系统底层的API,下面我们通过2个demo演示如何利用发布订阅实现前端与客户的数据通讯。

​ 在说Android客户端与前端通讯之前,我们首先了解一下客户端调用前端的原理,其实Android客户端调用前端的方式很简单,是直接通过webview.loadUrl函数和webview.evaluateJavascript函数,这个跟我们直接在浏览器控制台里直接调用window.call 函数是一样的原理:

JavaScript设计模式 - 发布订阅最佳实践_第16张图片

  • 首先我们来看第一个案例,当Android客户端的音量发生变化时和用户按back建时需要调用前端的函数通知前端:
// example/demo08-android-call-javascript/src/case1/index.jsx
import { useState, useEffect } from 'react'
import Other from './other';
import cs from './index.module.scss';

function Case1() {
  const [text, setText] = useState('');

  useEffect(() => {
    /** 客户端会调用这个函数 */
    window.callJs = function({ type, param }) {
      if (type === 'VOLUME_UP') {
        console.log('param: ', param);
        setText('音量调大了');
      } else if (type === 'BACK') {
        setText('用户按返回键');
      }
    }
  }, [])

  return (
    

我是app组件

app组件的内容: {text}
) } export default Case1
// example/demo08-android-call-javascript/src/case1/other.jsx
import React from 'react';
import cs from './index.module.scss';

export default class Other extends React.PureComponent {
  state = {
    content: ''
  }
  
  render() {
    const { content } = this.state;
    return 

我是Other组件

Other组件的内容: {content}
} componentDidMount() { /** 客户端会调用这个函数 */ window.callJs = function({ type, param }) { if (type === 'VOLUME_DOWN') { this.setState({ content: '音量调小了' }); } } } }

上述代码中我们通过在window上挂载callJs函数给客户端调用,然后传递不同的type代表用户的不同操作,并且我们在两个组件中都在window上挂载了callJs函数,这样带来的后果就是Case1组件里的callJs函数会覆盖掉other.jsx里面挂载的callJs函数,下面我们看运行效果:

  • 既然我们已经知道后面挂载的callJs函数会把前面组件挂载的callJs逻辑覆盖掉,那么我们应该如何解决这样的问题呢?此时又到了发布订阅的表演时间了,首先我们利用发布订阅模式,将用户的操作逻辑通过事件收集起来,全局只挂载一次callJs,下面我们来看代码:
// example/demo08-android-call-javascript/src/bridge.js
const bridge = {
  MAP_CALLJS: {},
  /**
   * 监听事件
   */
  on(type, fn) {
    if (this.MAP_CALLJS[type]) {
      this.MAP_CALLJS[type].push(fn)
    } else {
      this.MAP_CALLJS[type] = [fn];
    }
    console.log('this.MAP_CALLJS: ', this.MAP_CALLJS);
  },
  /**
   * 触发函数
   * @param {*} type 
   */
  emit(type, param) {
    if (!this.MAP_CALLJS[type]) return;
    this.MAP_CALLJS[type].forEach(fn => fn(param));
  }
}

window.callJs = ({ type, param }) => bridge.emit(type, param);

export default bridge;
  • 使用bridge进行订阅事件:
// example/demo08-android-call-javascript/src/case2/index.jsx
import { useState, useEffect } from 'react'
import bridge from '../bridge';
import Other from './other';
import cs from './index.module.scss';

function Case2() {
  const [text, setText] = useState('');

  useEffect(() => {
    // 订阅相关事件,等待客户端调用
    bridge.on('VOLUME_UP', param => {
      setText(param.msg);
    });
    // 订阅相关事件,等待客户端调用
    bridge.on('BACK', param => {
      setText(param.msg);
    });

  }, [])

  return (
    

我是app组件

app组件的内容: {text}
) } export default Case2
// example/demo08-android-call-javascript/src/case2/other.jsx
import React from 'react';
import bridge from '../bridge';
import cs from './index.module.scss';

export default class Other extends React.PureComponent {
  state = {
    content: ''
  }
  
  render() {
    const { content } = this.state;
    return 

我是Other组件

Other组件的内容: {content}
} componentDidMount() { bridge.on('VOLUME_DOWN', param => { this.setState({ content: '音量调小了' }); }); bridge.on('VOLUME_UP', param => { this.setState({ content: param.msg }); }); } }

通过上述代码可以发现,我们通过发布订阅模式将用户的事件操作逻辑收集起来,全局只挂载一次window.callJs然后当客户端调用前端的callJs函数时,根据事件类型循环调用刚刚前端监听的事件,并且把参数传递过去,下面我们看执行结果:

通过运行结果发现逻辑已经不会被覆盖了,而且我们可以在任意组件中进行监听相关的bridge事件。

Node.js 事件触发器

在node.js中有一个内置模块叫事件触发器events,这块模块就是一个标准的发布订阅实现,下面我们通过代码来感受一下它的功能和使用:

// example/demo09-node-event/demo01.mjs
import EventEmitter from 'events';

const emitter = new EventEmitter();

emitter.once('a', e => {
  console.log('1once.a', e);
});

emitter.on('a', e => {
  console.log('a1', e);
});

function callback() {
  console.log('a callback');
}
emitter.on('a', callback);
emitter.on('a', callback);
emitter.once('a', callback);
emitter.off('a', callback);

emitter.once('a', e => {
  console.log('2once.a', e);
});

emitter.once('a', e => {
  console.log('3once.a', e);
});

emitter.on('a', e => {
  console.log('a2', e);
});

emitter.emit('a', 'emit发出事件1');
console.log('==================');
emitter.emit('a', 'emit发出事件2');
console.log('==================');
emitter.emit('a', 'emit发出事件3')
console.log('==================');
emitter.emit('a', 'emit发出事件4');
console.log('==================');
emitter.emit('a', 'emit发出事件5');
console.log('==================');
emitter.emit('a', 'emit发出事件6');

运行结果:

JavaScript设计模式 - 发布订阅最佳实践_第17张图片

这里使用的node版本为 v17.8.0

发布订阅的实现原理

  • 感受完发布订阅的威力和应用场景之后,我们需要了解一下这个设计模式的实现原理,如何实现一个发布订阅?我们以node.js的事件触发器的功能为参考基准,用70行代码来实现一个通用的发布订阅功能。
  • 一个最基本的发布订阅最主要有3大功能:

    • 监听(on) => 收集事件处理函数,进行分类存放到数组里。
    • 触发(emit)=> 执行收集到的数据处理函数;先进先出,先监听的事件会被先触发。
    • 移除(off) => 移除收集到的数据处理函数;后进先出,后监听的事件会被先移除。
订阅(监听); 发布(触发)
  • 了解了基本功能之后,我们只要记住一句话就能手推出发布订阅设计模式的实现:"订阅其实就是将事件处理函数收集起来,进行分类存到数组里;发布其实就是将收集起来的这些事件处理函数进行调用执行",所以这就是为什么要先订阅后发布的原因。
// example/demo09-node-event/events.mjs
/**
 * 事件函数检查
 */
 function checkListener(listener) {
  if (typeof listener !== 'function') {
    throw Error('你传入的不是一个函数');
  }
}

class Events {
  constructor() {
    /** 事件记录 */
    this.MAP_EVENTS = {};
  }
  /**
   * 订阅事件
   * @param {String} key 事件名称
   * @param {Function} listener 事件回调函数
   * @param {Boolean} once 是否触发一次后移除事件
   */
  on(key, listener, once = false) {
    checkListener(listener);
    if (this.MAP_EVENTS[key]) {
      this.MAP_EVENTS[key].push({ listener, once });
    } else {
      this.MAP_EVENTS[key] = [{ listener, once }];
    }
    return this.MAP_EVENTS;
  }
  /**
   * 订阅事件 - 只有第一次触发事件时被回调
   * @param {String} key
   * @param {Function} listener
   */
  once(key, listener) {
    checkListener(listener);
    this.on(key, listener, true);
  }
  /**
   * 取消订阅
   * @param {String} key 事件名称
   * @param {Function} listener 事件回调函数,匿名函数无效
   */
  off(key, listener) {
    checkListener(listener);
    const arrEvents = this.MAP_EVENTS[key] || [];
    if (arrEvents.length) {
      // 移除事件是后进先出,后监听的事件会被先移除
      const index = arrEvents.lastIndexOf(e => e.listener === listener);
      this.MAP_EVENTS[key].splice(index, 1);
    } else {
      console.log(`你从来都没有订阅过${key}事件,所以你取消个`);
    }
  }
  /**
   * 触发事件
   * @param {String} key 事件名称
   * @param  {...any} args 事件参数
   */
  emit(key, ...args) {
    const arrEvents = this.MAP_EVENTS[key] || [];
    // 执行事件是先进先出;先监听的事情会被先执行
    arrEvents.forEach(e => e.listener.call(this, ...args));
    // 第一次触发后需要把once事件全部移除掉
    this.MAP_EVENTS[key] = arrEvents.filter(e => !e.once);
  }
}

// 默认事件对象,挂载在静态函数上
const defaultEvent = new Events();
Events.on = Events.prototype.on.bind(defaultEvent)
Events.once = Events.prototype.once.bind(defaultEvent)
Events.off = Events.prototype.off.bind(defaultEvent)
Events.emit = Events.prototype.emit.bind(defaultEvent)

export default Events;
  • 然后可以把前面例子中用的node内置的events换成咱们自己实现的;可以发现得到的结果是一模一样的,这就证明咱们实现的发布订阅是正确的了。
// example/demo09-node-event/demo02.mjs
import EventEmitter from './events.mjs';    // 其他逻辑代码没有变化,只需要把这个换成自己实现发布订阅即可

JavaScript设计模式 - 发布订阅最佳实践_第18张图片

  • 细心的同学会发现咱们自己实现的events.mjs里面有这么一段代码:
// 默认事件对象,挂载在静态函数上
const defaultEvent = new Events();
Events.on = Events.prototype.on.bind(defaultEvent)
Events.once = Events.prototype.once.bind(defaultEvent)
Events.off = Events.prototype.off.bind(defaultEvent)
Events.emit = Events.prototype.emit.bind(defaultEvent)
  • 这么设计的主要是为了给懒人准备,因为有些人不想new直接用,那么你就可以像下面这样用:
// example/demo09-node-event/demo03.mjs
import Events from './events.mjs';

Events.on('coding', (...param) => {
  console.log('懒人 on coding => ', ...param);
})

Events.once('coding', (...param) => {
  console.log('懒人 once-coding => ', ...param);
})

Events.emit('coding', '张三');
console.log('============================');
Events.emit('coding', '李四');
console.log('============================');
Events.emit('coding', '王五');
console.log('============================');


// 除了使用使用静态函数,还可以创建一个新的事件对象,事件名称一样也不会冲突,互相隔离
const e1 = new Events();
e1.on('coding', (name) => {
  console.log('e1-on-coding', name);
});

e1.once('coding', (name) => {
  console.log('e1-once-coding', name);
});

e1.emit('coding', 'Ice King');
console.log('============================');
e1.emit('coding', 'Simon King');
console.log('============================');
e1.emit('coding', 'Alex King');
console.log('============================');

运行结果:

JavaScript设计模式 - 发布订阅最佳实践_第19张图片

通过运行结果可以发现,对象之间虽然事件名称一样,但是都是互相隔离的,所以你可以根据你的业务场景创建不同的事件对象,进行分类管理,有效的避免事件名称同名冲突问题。

最后

​ 发布订阅这个设计模式的实现其实并不是特别的复杂,我觉得最主要的不是它的代码实现,而是它的设计思想,以及应用场景;只有在对的应用场景下才能发挥出它真正的威力;这篇文章我只是模拟演示了一些比较常见的应用场景,它还有很多变种分支和使用技巧也是非常巧妙的。

你可能感兴趣的:(JavaScript设计模式 - 发布订阅最佳实践)