研发协同利器:XState调研与应用

news2024/11/17 3:37:58

背景

帖子详情是一个图文/视频混排、拥有大量长文本、大量交互和部分细节动效的页面,细节组件非常多,页面复杂度高。按以往的页面协作方式,会将一个个组件样式、组件数据和组件交互逻辑交给对应的开发同学完成,通过多人协同最终搭建出完整的页面,但这样的方式会造成后期维护该页面的一到两个核心同学成本急剧增加,需要理解每个组件内的逻辑代码;于是为了改善页面内的协作效率,同时为开发上下游协同效率提升打好基础,通过大量案例/源码/文献调研,最后选择使用开源的XState方案来完成页面协同开发。

59491ed341f1b8638e81a06dfb1f9d12.png

XState的理论基础

在使用XState前,我们一直在探索的方向是当下有没有一种适合降低研发上下游协同成本的代码即流程的理论模型或者方案,经过大量调研,最终找到了在致力促进团队间沟通提升生产力的基于可执行UML研究分支的W3C SCXML标准协议,在该协议的基础上,我们可以标准化的方式将业务逻辑进行图形化的表达。随着调研的深入,最终选择了具有成熟工具配套的基于JS语言的解决方案XState。

在该方案下核心会使用到三种工具,第一种是用于创建状态机的xstate库和其在主流UI框架下的适配库;第二种是可视化的编辑器插件,基于该插件我们可以快速产出图形化的业务逻辑,同时拥有一份等价的状态配置代码;第三种是状态机实例的可视化展示,闲鱼基于该工具之上的定制可以试试观测与模拟正在运行的页面内状态机。

xstate库基础概念与使用方式

StateNodeConfig介绍

首先基于xstate库,我们了解下其核心概念。当我们定义状态机时,会使用到createMachine方法(如图2-1),该方法接收StateNodeConfig实例(如图2-2,在不同入参时可以参看不同的StateNodeConfig子类型),并生成StateNode实例。

eb75746eda5522a9a75a506d07a1a457.png
图2-1
508fe9583169c92688ca44c7f315290c.png
图2-2

StateNodeConfig的属性是初学者需要核心关注的内容,以社区详情的互动点赞能力简化版为例子,我们首先需要和业务一起定义点赞会有几种状态,然后定义在用户的交互事件中如何响应,如下所示,我们定义了四种状态"未点赞","点赞中","已点赞","取消点赞中",并且声明,如果处于"已点赞"状态下用户进行了点赞按钮的点击,那么我们就会进入"取消点赞中"的状态,在"取消点赞中"我们会调用服务端取消点赞接口,当请求完成后,我们就进入了"未点赞"状态。当然,这个逻辑是需要和业务方一起定制的,例如有的场景下希望取消点赞后立刻成为"未点赞"状态,而取消点赞请求可以延后调用,那么就可以进行对应的状态调整。

states: {
  like: {
    on: {
      CLICK_LIKE: {
      actions: (ctx, e)=> console.log('you clicked to undolike'),
        target: 'undoliking'
        }
    }
  },
  undolike: {
  },
  liking: {},
    undoliking: {
    invoke: 'requestToUndoLike',
    onDone: {
      target: 'undolike'
    }
  }
}

Node属性介绍

结合上面的例子,我们进一步了解下其代码结构,从叶子节点开始看,首先是actions和invoke,actions接收SingleOrArray类型,即可以是Action的数组,也可以是单个Action,Action的用途是在状态机的生命周期切面或者在响应事件时声明没有副作用的方法,Action的定义有三种(代码如下),第一种是字符串,定义字符串后,需要在调用createMachine时传入第二参数options,其包含actions属性;第二种是内置的Action,例如send、assign,send Action会向状态机发送事件;第三种是无返回值的匿名函数,其入参和options内的定义相同。

createMachine({

states: {
    stateA: {
      on: {
        'CLICK_LIKE': {
          actions: [
            'myaction',
            send({type: 'CLICK_LIKE'}),
            (ctx, e) => {}
          ]
        }
      }
    }
  }
}, {
  actions: {
    myaction: (ctx, e)=>{},
    }
}

另一个叶子结点是 invoke,invoke属性是SingleOrArray类型(图2-3),既可以是InvokeConfig的数组,也可以是单个InvokeConfig,InvokeConfig内可以通过src来指定一个可调用的service名称,然后在options属性的services内实现对应的service函数,InvokeConfig相比Action的核心差异,在于它提供了onDone和onError的配置,这样我们便能通过InvokeConfig去完成带副作用的服务调用,另一个差异在于invoke是StateNodeConfig的属性,意味着只有在进入某一状态时才能使用invoke,而Action可以在状态生命周期切面例如entry或exit,也可以在事件接收时声明。然后我们关注到states属性,states是StateNodeConfig的数组,即意味着在状态表中的状态可以嵌套,形成父子状态,甚至可以一直嵌套下去,同时这也意味着当我们形容当前所属状态时,它的状态会由多维数组构成,同时我们可以注意到parallel属性,该属性的意思是同一级的状态是否可以并行,并行状态是指当前同一层级的states可以共同表达状态机的状态,例如在已点赞的状态下,也可以同时处于已收藏的状态,但如果非并行,则意味着states下只能有一个节点表达当前同一层级下状态,例如处于已点赞状态下,不可能同时又处于未点赞状态。

9f7427f7c371e5c102dccc5f91aa73a3.png
图2-3

Transition介绍

既然定义了状态,那状态的流转的边是怎么样的呢?在XState内有两种转移声明方式,即通过StateNodeConfig下的on属性或者是always属性,来声明一个或多个TransitionConfig实例(如图2-4),通过TransitionConfig内的target来指定转移的形如a.b.c(转移到指定a状态内的b状态内的c状态)的state名称,这两种方式的差别是on属性需要声明TransitionConfig对应的event,即在指定event下才会发生状态转移(有一个例外是声明event为空字符串), 在always下声明则不需要相应的event,TransitionConfig下可以使用cond声明发生转移的条件,cond是Condition类型(图2-5),它可以是一个字符串,同时在options内guards属性中进行定义,或者是一个返回布尔类型的匿名函数。

fc0de0714f303e16adb52d0f6465e93f.png
图2-4
93383de7ab949073b25b77ecc2ed598b.png
图2-5

在我们用代码声明完业务逻辑后,为了主流UI框架内快速使用,XState提供了相应的适配框架,例如react-xstate,参考代码如下,基于react hooks,适配层提供了useMachine获取(主要的)两个对象实例,一个是state(图3-1),另一个是send方法,通过state可以设置组件需要的数据,通过send可以发送事件给useMachine接收的状态表。

import myMachine from './my-machine.ts'

const MyComponent = (props) => {
  const [state, send] = useMachine(myMachine);
  retiurn <View>
    <Text>{state.context.myTitle}</Text>
      <View onClick={() => {send('CLICK_LIKE')}}><Text>Click Me</Text></View>
  </View>;
}
f66b165efedac8e58f4946d6fa56d197.png
图3-1

那useMachine是怎么工作的呢,我们可以看下useMachine的实现(图3-2),useMachine首先会通过useIdleInterpreter(图3-3)生成service。

a726b228dc881cd110126027975367b5.png
图3-2
5759f811337f7c3b5e6387117adf8296.png
图3-3 ‍ ‍

service参考图3-4,其核心逻辑在于实现状态迁移,并增加状态机的各类切面能力。当状态update时,会通知到各类listener,同时支持send方法(参考图3-5),即通知调度器进行状态迁移。通过useIdleInterpreter返回的service,在useMachine内调用useState来绑定页面刷新,当isEqual方法返回值变化时即state的change属性发生变化时即刷新当前组件。

9f30fd6a4bf578c102fa100937c46f92.png
图3-4
0a3312601ab35057871f6bd3d84740de.png
图3-5

配套工具的使用&帖子详情的状态表展示

通过上面createMachine和useMachine我们已经可以完成业务开发了,但是这样和没有体现出状态表的最大收益,我们需要使用套配套工具来降低上下游和开发之间的成本,第一个工具是Editor,通过安装VisiualStuid的XState插件,我们可以进入可视化编辑器,在编辑器内(如图4-1)我们可以非常快速的定义多个state和state转换,在可视化编辑器内构建完状态表后,只需要再options内写入对应的actions/services/guards即可。对已完成的状态表,我们可以使用Simulator来模拟事件发送并观测状态转移方式(图4-2),在帖子详情页我们主要构建了页面状态表/单篇帖子状态表/评论输入状态表/菜单管理状态表等,图4-2展示了其中单篇帖子状态表,也是业务逻辑最复杂的部分之一。

59cf097dc96ce6651d133e4959907e23.png
图4-1
4ebc003ee666193039fc1ba0fe7ca546.png
图4-2

当页面运行后,需要实时调试页面状态时,可以使用xstate-viz的可视化页面,xstate-viz会通过websocket或者window广播能力来实现页面实例和xstate-viz的可视化界面通信。在闲鱼内,我们通过基于flutter的动态化容器kun实现了帖子详情页的开发,基于kun的开发逼近h5研发,但是页面实例运行在手机端,因此当我们需要使用xstate-viz时,只能通过websocket能力来进行通信,因此在kun内我们注入了websocketServer,配合xstate-inspect库进行双工的通信,inspect库的核心逻辑在于添加状态表的监听,在状态表发生任何变化时通过当前状态表的所有信息到xstate-viz页面,然后进行图形化展示,当xstate-viz页面内操作事件发送时,会通过websocket让手机端的页面实例进行指定操作,例如通过send发送事件,其流程如下所示。

30167855da83aa1454d3e2011478f3d8.gif

踩坑框架使用后高频刷新

当首次通过XState完成业务开发时,我们发现页面刷新非常频繁,即时在页面没有发生大幅变化时也会频繁执行组件的render函数,于是我们快速实现了web版的帖子详情进行调试,这里构造了一份demo代码。

const pageMachine = createMachine({
    id: 'pageMachine',
    preserveActionOrder: true,
    context: { title: '' },
    initial:'like',
    states: {
        like: {
            type: 'parallel',
            states: { stateA: {},stateB: {} },
            on: {
                'SCROLL': {
                    actions: (ctx, e) => {
                        console.log('scroll1')
                    }
                }
            }
        },
        undolike: {}
    }
});

export default function Detail() {
  console.log('rendering')
  const [state, send] = useMachine(pageMachine);
  setInterval(()=> {
    send('SCROLL')
    console.log('sending')
  }, 500)
  return <View>
    <Text>{state.context.title}</Text>
  </View>
}

在demo里状态表内监听了SCROLL方法但是只会输出log,然后在组件内定时发送SCROLL事件,通过在useMachine的isEqual处的断点(如图5-1),我们可以看到state.changed属性是true 。

4d0a325faa7e7ab7fde9eb49003d874a.png
图5-1

那么问题来了我们并没有在SCROLL事件监听后发生状态迁移,为什么state会是changed呢?这个就涉及到事件监听的完整流程,上文提到过,interpret内实现了send方法(如图3-5),我们通过断点可以观测下其迁移的过程,send方法会通过调度器执行nextState方法,然后执行transition方法(图5-2),在transition内会通过解析StateNode获取当前状态的可迁移的边,然后通过resolveTransition来执行状态迁移(图5-3)

58a8ab327f132da1706cb372e3555384.png
图5-2
ab649d3e5934afa412548c2476caca81.png
图5-3

状态迁移过程中包含对action解析与执行,当action执行完成后我们发现会直接生成一份新的state值(如图5-4),如果actions不为空则会直接返回新的state(如图5-5), 也就意味着不需要进行状态迁移的配置,当收到SCROLL事件后state即changed。

ca7473f5f0f7998abece10463d86509b.png
图5-4
e9c3b8a4abf270dd2d765d421e8b278c.png
图5-5

这么频繁的刷新并不满足我们对性能的要求,那应该怎么改造呢?上文提到核心的监听逻辑由useMachine完成,而useIdleInterpreter已经提供了service能力但不会刷新组件,因此我们可以使用其他方式来完成对组件的绑定,在XState内提供了useSelector方法,该方法接收状态表实例/属性获取函数/diff函数三个参数,通过调用属性获取函数得到新/旧state内我们关注的数据,然后通过自定义diff函数来达到最小化的刷新,如代码所示,当我们关注的list属性长度发生变化时才会进行组件的刷新。

const MyComponent = (props) => {
  const [propa,propb] = useSelector(pageMachine,
    (state)=>[state.context.propa,state.context.propb],
    (a, b)=> {
      return a.length == b.length
    }
  );
return <View>{propa}</View>
}

总结

通过对XState进行定制和业务开发后,其完整的工作流如图所示,页面只需要由1-2名核心的维护同学配合产品与测试同学完成逻辑图开发,然后开发组件的同学其组件会非常轻量,通过少量协同和数据约定,即可完成页面交付。

38cfd6778ef1033e2cf7b616f681f969.png

在后续的维护过程中业务逻辑以图形的方式清晰的展示出来,极大的降低了业务Owner维护该页面的成本。未来我们会尝试在工具上做更多增强可读性提升效率的探索,同时会尝试补充图形化的单测能力,为更高效的协作模式而努力。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.coloradmin.cn/o/137869.html

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈,一经查实,立即删除!

相关文章

【数据结构】C语言实现栈和队列

目录 一、栈 1、栈的概念及结构 2、如何实现栈 3、代码实现 3.1 栈的定义 3.2 栈中将要实现的函数 3.3 函数实现 二、队列 1、队列的概念及结构 2、如何实现队列 3、代码实现 3.1 队列定义 3.2 队列中将要实现的函数 3.3 函数实现 一、栈 1、栈的概念及结构 栈&am…

AI医药论文阅读-使用药物描述和分子结构从文献中提取药物-药物相互作用

202107Using drug descriptions and molecular structures for drug-drug interaction extraction from literature 使用药物描述和分子结构从文献中提取药物-药物相互作用 Bioinformatics. 2021.07 有代码 https://github.com/tticoin/DESC_MOL-DDIE 目录 202107Using dru…

2022亚太杯数学建模(补赛)DE题思路模型代码

占个位置吧&#xff0c;开始在本帖实时更新赛题思路代码&#xff0c;文章末尾名片获取&#xff01;ABC题已更新 持续为更新参考思路 赛题思路 会持续进行思路模型分析&#xff0c;下自行获取。 D题思路&#xff1a; &#xff08;比赛开始后第一时间更新&#xff09; E题思…

面试官:海量请求下的接口并发解决方案,具体聊聊吧

设定一个场景&#xff0c;假如一个商品接口在某段时间突然上升&#xff0c;会怎么办&#xff1f; 生活中的例子来说&#xff0c;假设冰墩墩在当天晚上上热搜之后&#xff0c;迅速有十几万人去淘宝下单购买&#xff0c;此时并没有做好对该商品的缓存预热以及准备&#xff0c;如何…

【力扣刷题】day1-1、两数之和 2、两数相加

力扣刷题笔记day1 1&#xff0c;两数之和 题意 给定一个整数数组 nums 和一个整数目标值 target&#xff0c;请你在该数组中找出 和为目标值 target 的那 两个 整数&#xff0c;并返回它们的数组下标。 你可以假设每种输入只会对应一个答案。但是&#xff0c;数组中同一个元…

C++ · 入门 · 04 | 引用

啊我摔倒了..有没有人扶我起来学习.... &#x1f471;个人主页&#xff1a;《CGod的个人主页》\color{Darkorange}{《CGod的个人主页》}《CGod的个人主页》交个朋友叭~ &#x1f492;个人社区&#xff1a;《编程成神技术交流社区》\color{Darkorange}{《编程成神技术交流社区》…

STM32MP157驱动开发——Linux WIFI驱动

STM32MP157驱动开发——Linux WIFI驱动一、简介二、驱动开发1.wifi驱动添加与编译2.配置 USB 支持设备1&#xff09;配置 USB 支持设备2&#xff09;配置支持的 WIFI 设备3&#xff09;配置支持 IEEE 802.114&#xff09;使能 STAGING 配置3.设备树配置4.编译 wifi 驱动1&#…

05SpringCloudAlibaba负载均衡服务调用-Ribbon

目录 推荐与004SpringCloud-Ribbon_gh_xiaohe的博客-CSDN博客 对比观看 Ribbon概述 Ribbon官网https://github.com/Netflix/ribbon/wiki/Getting-Started Ribbon是什么 Ribbon也进入维护模式 Ribbon能干什么 LB&#xff08;负载均衡&#xff09; 一句话&#xff1a;…

冲击港交所:百果园书写水果连锁运营默示录

卖水果是一门古老的生意&#xff0c;但是长期以来并不受资本重视。一是因为产品口味难以标准化、鲜度要求高、流通环节易损耗、质量控制难度大。二是因为交易主体多&#xff0c;进出壁垒小&#xff0c;经济学中往往将其定义为完全竞争市场&#xff0c;难以出现龙头企业和超额利…

AI与艺术——图像生成模型是否能挑战人类艺术?

在2018年末的佳士得纽约拍卖场上&#xff0c;一件名为《爱德蒙贝拉米肖像》拍出了43.25万美元的价格&#xff0c;从绘画艺术风格来看&#xff0c;这是一幅有着很明显的印象派主义痕迹的作品。 印象派是19世纪中叶在法国兴起的一种艺术运动。印象派艺术家们拒绝了艺术(“美术”…

Webpack中的文件指纹

1. 什么是文件指纹&#xff1f; 文件指纹就是打包后输出的文件名的后缀&#xff0c;主要用来对修改后的文件做版本区分。 2. 文件指纹有哪几种&#xff1f; 1. Hash&#xff1a;和整个项目的构建相关&#xff0c;只要项目文件有修改&#xff0c;整个项目构建的 hash 值就会更…

CSRF与XSS攻防知识点总结

本章节将用于详细总结记录&#xff0c;跨站脚本攻击XSS&#xff08;cross site script&#xff09;与 跨站请求伪造CSRF&#xff08;cross site request forgery&#xff09;这两种常见的浏览器安全的攻防手段。本章节会介绍两种攻击的概念&#xff0c;以及相关手段有哪些&…

常见的电动两轮车 BMS 架构

1、摘要 近年来&#xff0c;随着新国标的施行&#xff0c;以及平衡车&#xff0c;滑板车&#xff0c;共享电单车等新应用场景的出现&#xff0c;促使电动两轮车市场迎来了新的发展热潮。 锂电池因为具有能量密度高&#xff0c;循环次数多等优点而逐渐替代铅酸电池&#xff0c…

Spire.XLS for Java 12.12.4 2022-12-30 Version

Spire.XLS for Java 12.12.4 Spire.XLS for Java是一个专业的 Java Excel API&#xff0c;Ω578867473使开发人员无需使用 Microsoft Office 或 Microsoft Excel即可创建、管理、操作、转换和打印 Excel工作表。 Spire.XLS for Java 支持旧的 Excel 97-2003 格式&#xff08;.…

Java中main函数里的String[] args详解

1&#xff09;概念 在开始学习 Java 时都会被要求记住主方法&#xff08;main&#xff09;的写法&#xff0c;就像以下&#xff1a; public static void main(String[] args) { }&#xff1b;public static void main(String args[]) { }&#xff1b; 这里做如下说明&#xff…

什么是 A/B 实验,为什么要开 A/B 实验?

更多技术交流、求职机会&#xff0c;欢迎关注字节跳动数据平台微信公众号&#xff0c;回复【1】进入官方交流群 1、什么是 A/B 实验 A/B 实验也被称为 A/B 测试&#xff0c;实验的基本思路是在线上流量中取出一小部分&#xff08;较低风险&#xff09;&#xff0c;完全随机地分…

【机器学习】minHash最小哈希原理及其应用

目录1 前言2 哈希函数的定义3 miniHash函数4 miniHash的例子5 miniHash数学原理6 miniHash的应用7 参考文献1 前言 在数据结构中学过哈希概念以及哈希在内存中的应用&#xff0c;在实际的应用问题中哈希技术也应用十分广泛如在推荐系统以及图神经网络技术中&#xff0c;所以在此…

Java多线程之死锁问题,wait和notify

文章目录一. synchronnized 的特性1. 互斥性2. 可重入性二. 死锁问题1. 什么是死锁2. 死锁的四个必要条件3. 常见的死锁场景及解决3.1 不可重入造成的死锁3.2 循环等待的场景哲学家就餐问题(多个线程多把锁)两个线程两把锁三. Object类中提供线程等待的方法1. 常用方法2. wait和…

剑指offer----C语言版----第八天

目录 1. 矩阵中的路径 1.1 题目描述 1.2 基础知识 1.3 思路分析 1.4 小试牛刀 1. 矩阵中的路径 原题链接&#xff1a; 剑指 Offer 12. 矩阵中的路径 - 力扣&#xff08;LeetCode&#xff09;https://leetcode.cn/problems/ju-zhen-zhong-de-lu-jing-lcof/submissions/ 1.1 题…

c++11 标准模板(STL)(std::deque)(七)

定义于头文件 <deque> std::deque 修改器 清除内容 std::deque<T,Allocator>::clear void clear(); (C11 前) void clear() noexcept; (C11 起)从容器擦除所有元素。此调用后 size() 返回零。 非法化任何指代所含元素的引用、指针或迭代器。任何尾后迭代器亦被…