好得很程序员自学网

<tfoot draggable='sEl'></tfoot>

concent渐进式重构react应用使用详解

正文

传统的redux项目里，我们写在reducer里的状态一定是要打通到store的，我们一开始就要规划好state、reducer等定义，有没有什么方法，既能够快速享受ui与逻辑分离的福利，又不需要照本宣科的从条条框框开始呢？本文从普通的react写法开始，当你一个收到一个需求后，脑海里有了组件大致的接口定义，然后丝滑般的接入到concent世界里，感受渐进式的快感以及全新api的独有魅力吧！

需求来了

上周天气其实不是很好，记得下了好几场雨，不过北京总部大厦的隔音太好了，以致于都没有感受到外面的风雨飘摇，在工位上正在思索着整理下现有代码时，接到一个普通的需求，大致是要实现一个弹窗。

左侧有一个可选字段列表，点击任意一个字段，就会进入右侧。 右侧有一个已选字段列表，该列表可以上下拖拽决定字段顺序决定表格里的列字段显示顺序，同时也可以删除，将其恢复到可选择列表。 点击保存，将用户的字段配置存储到后端，用户下次再次使用查看该表格时，使用已配置的显示字段来展示。

这是一个非常普通的需求，我相信不少码神看完后，脑海里已经把代码雏形大致写完了吧，嘿嘿，但是还请耐性看完本篇文章，来看看在 concent 的加持下，你的 react 应用将如何变得更加灵活与美妙，正如我们的slogan：

concent, power your react

准备工作

产品同学期望快速见到一般效果原型，而我希望原型是可以持续重构和迭代的基础代码，当然要认真对待了，不能为了交差而乱写一版，所以要快速整理需求并开始准备工作了。

因为项目大量基于 antd 来书写UI，听完需求后，脑海里冒出了一个穿梭框模样的组件，但因为右侧是一个可拖拽列表，查阅了下没有类似的组件，那就自己实现一个吧，初步整理下，大概列出了以下思路。

组件命名为 ColumnConfModal ,基于 antd 的 Modal , Card 实现布局， antd 的 List 来实现左侧的选择列表，基于 react-beautiful-dnd 的可拖拽api来实现右侧的拖拽列表。

因为这个弹窗组件在不同页面被不同的table使用，传入的列定义数据是不一样的，所以我们使用事件的方式，来触发打开弹窗并传递表格id，打开弹窗后获取该表格的所有字段定义，以及用户针对表哥的已选择字段数据，这样把表格元数据的初始化工作收敛在 ColumnConfModal 内部。 基于表格左右两侧的交互，大致定义一下内部接口 1 moveToSelectedList（移入到已选择列表 ） 2 moveToSelectableList（移入到可选择列表） 3 saveSelectedList（保存用户的已选择列表） 4 handleDragEnd（处理已选择列表顺序调整完成时） 5 其他略.....

UI 实现

因为注册为 concent 组件后天生拥有了 emit&on 的能力，而且不需要手动 off ， concent 在实例销毁前自动就帮你解除其事件监听，所以我们可以注册完成后，很方便的监听 openColumnConf 事件了。

我们先抛弃各种store和reducer定义，快速的基于 class 撸出一个原型，利用 register 接口将普通组件注册为 concent 组件，伪代码如下

import { register } from 'concent';
class ColumnConfModal extends React.Component {
  state = {
    selectedColumnKeys: [],
    selectableColumnKeys: [],
    visible: false,
  };
  componentDidMount(){
    this.ctx.on('openColumnConf', ()=>{
      this.setState({visible:true});
    });
  }
  moveToSelectedList = ()=>{
    //code here
  }
  moveToSelectableList = ()=>{
    //code here
  }
  saveSelectedList = ()=>{
    //code here
  }
  handleDragEnd = ()=>{
    //code here
  }
  render(){
    const {selectedColumnKeys, selectableColumnKeys, visible} = this.state;
    return (
      <Modal title="设置显示字段" visible={state._visible} onCancel={settings.closeModal}>
        <Head />
        <Card title="可选字段">
          <List dataSource={selectableColumnKeys} render={item=>{
            //...code here
          }}/>
        </Card>
        <Card title="已选字段">
          <DraggableList dataSource={selectedColumnKeys} onDragEnd={this.handleDragEnd}/>
        </Card>
      </Modal>
    );
  }
}
// es6装饰器还处于实验阶段，这里就直接包裹类了
// 等同于在class上@register( )来装饰类
export default register( )(ColumnConfModal)

可以发现，这个类的内部和传统的 react 类写法并无区别，唯一的区别是 concent 会为每一个实例注入一个上下文对象 ctx 来暴露 concent 为 react 带来的新特性api。

消灭生命周期函数

因为事件的监听只需要执行一次，所以例子中我们在 componentDidMount 里完成了事件 openColumnConf 的监听注册。

根据需求，显然的我们还要在这里书写获取表格列定义元数据和获取用户的个性化列定义数据的业务逻辑

  componentDidMount() {
    this.ctx.on('openColumnConf', () => {
      this.setState({ visible: true });
    });
    const tableId = this.props.tid;
    tableService.getColumnMeta(`/getMeta/${tableId}`, (columns) => {
      userService.getUserColumns(`/getUserColumns/${tableId}`, (userColumns) => {
        //根据columns userColumns 计算selectedList selectableList
      });
    });
  }

所有的 concent 实例可以定义 setup 钩子函数，该函数只会在初次渲染前调用一次。

现在让我们来用 setup 代替掉此生命周期

  //class 里定义的setup加$$前缀
  $$setup(ctx){
    //这里定义on监听，在组件挂载完毕后开始真正监听on事件
    ctx.on('openColumnConf', () => {
      this.setState({ visible: true });
    });
    //标记依赖列表为空数组，在组件初次渲染只执行一次
    //模拟componentDidMount
    ctx.effect(()=>{
      //service call balabala.....
    }, []);
  }

如果已熟悉 hook 的同学，看到 setup 里的 effect api语法是不是和 useEffect 有点像？

effect 和 useEffect 的执行时机是一样的，即每次组件渲染完毕之后，但是 effect 只需要在 setup 调用一次，相当于是静态的，更具有性能提升空间，假设我们加一个需求，每次 vibible 变为false时，上报后端一个操作日志，就可以写为

    //依赖列表填入key的名称，表示当这个key的值发生变化时，触发副作用
    ctx.effect( ctx=>{
      if(!ctx.state.visible){
        //当前最新的visible已是false，上报
      }
    }, ['visible']);

关于 effect 就点到为止，说得太多扯不完了，我们继续回到本文的组件上。

提升状态到store

我们希望组件的状态变更可以被记录下来，方便观察数据变化，so，我们先定义一个store的子模块，名为 ColumnConf ，

定义其sate为

// code in ColumnConfModal/model/state.js
export function getInitialState() {
  return {
    selectedColumnKeys: [],
    selectableColumnKeys: [],
	visible: false,
  };
}
export default getInitialState();

然后利用 concent 的 configure 接口载入此配置

// code in ColumnConfModal/model/index.js
import { configure } from 'concent';
import state from './state';
// 配置模块ColumnConf
configure('ColumnConf', {
  state,
});

注意这里，让 model 跟着组件定义走，方便我们维护 model 里的业务逻辑。

整个 store 已经被 concent 挂载到了 window.sss 下，为了方便查看store，当当当当，你可以打开 console ，直接查看 store 各个模块当前的最新数据。

然后我们把class注册为'配置模 ColumnConf 的组件，现在 class 里的state声明可以直接被我们干掉了。

import './model';//引用一下model文件，触发model配置到concent
@register('ColumnConf')
class ColumnConfModal extends React.Component {
  // state = {
  //   selectedColumnKeys: [],
  //   selectableColumnKeys: [],
  //   visible: false,
  // };
  render(){
    const {selectedColumnKeys, selectableColumnKeys, visible} = this.state;
  }
}

大家可能注意到了，这样暴力的注释掉， render 里的代码会不会出问题？放心吧，不会的，concent组件的state和 store 是天生打通的，同样的 setState 也是和 store 打通的，我们先来安装一个插件 concent-plugin-redux-devtool 。

import ReduxDevToolPlugin from 'concent-plugin-redux-devtool';
import { run } from 'concent';
// storeConfig配置略，详情可参考concent官网
run(storeConfig, {
	plugins: [ ReduxDevToolPlugin ]
});

注意哦， concent 驱动ui渲染的原理和 redux 完全不一样的，核心逻辑部分也不是在 redux 之上做包装，和 redux 一点关系都没有的^_^，这里只是桥接了 redux-dev-tool 插件，来辅助做状态变更记录的，小伙伴们千万不要误会，没有 redux ， concent 一样能够正常运作，但是由于 concent 提供完善的插件机制，为啥不利用社区现有的优秀资源呢，重复造无意义的轮子很辛苦滴(⊙﹏⊙)b......

现在让我们打开 chrome 的redux插件看看效果吧。

上图里是含有大量的ccApi/setState，是因为还有不少逻辑没有抽离到 reducer ， dispatch/*** 模样的type就是 dispatch 调用了，后面我们会提到。

这样看状态变迁是不是要比 window.sss 好多了，因为 sss 只能看当前最新的状态。

这里既然提到了 redux-dev-tool ，我们就顺道简单了解下，concent提交的数据长什么样子吧

上图里可以看到5个字段， renderKey 是用于提高性能用的，可以先不作了解，这里我们就说说其他四个， module 表示修改的数据所属的模块名， committedState 表示提交的状态， sharedState 表示共享到 store 的状态， ccUniqueKey 表示触发数据修改的实例id。

为什么要区分 committedState 和 sharedState 呢？因为 setState 调用时允许提交自己的私有key的（即没有在模块里声明的key），所以 committedState 是整个状态都要再次派发给调用者，而 sharedState 是同步到 store 后，派发给同属于 module 值的其他cc组件实例的。

这里就借用官网一张图示意下：

所以我们可以在组件里声明其他非模块的key，然后在 this.state 里获取到了

@register('ColumnConf')
class ColumnConfModal extends React.Component {
   state = {
		_myPrivKey:'i am a private field value, not for store',
   };
  render(){
  	//这里同时取到了模块的数据和私有的数据
    const {selectedColumnKeys, selectableColumnKeys, visible, _myPrivKey} = this.state;
  }
}

解耦业务逻辑与UI

虽然代码能够正常工作，状态也接入了store，但是我们发现class已经变得臃肿不堪了，利用 setState 怼固然快和方便，但是后期维护和迭代的代价就会慢慢越来越大，让我们把业务抽到 reduder 吧

export function setLoading(loading) {
  return { loading };
};
/** 移入到已选择列表 */
export function moveToSelectedList() {
}
/** 移入到可选择列表 */
export function moveToSelectableList() {
}
/** 初始化列表 */
export async function initSelectedList(tableId, moduleState, ctx) {
  //这里可以不用基于字符串 ctx.dispatch('setLoading', true) 去调用了，虽然这样写也是有效的
  await ctx.dispatch(setLoading, true);
  const columnMeta = await tableService..getColumnMeta(`/getMeta/${tableId}`);
  const userColumsn = await userService.getUserColumns(`/getUserColumns/${tableId}`);
  //计算 selectedColumnKeys selectableColumnKeys 略
  //仅返回需要设置到模块的片断state就可以了
  return { loading: false, selectedColumnKeys, selectableColumnKeys };
}
/** 保存已选择列表 */
export async function saveSelectedList(tableId, moduleState, ctx) {
}
export function handleDragEnd() {
}

利用 concent 的 configure 接口把 reducer 也配置进去

// code in ColumnConfModal/model/index.js
import { configure } from 'concent';
import * as reducer from 'reducer';
import state from './state';
// 配置模块ColumnConf
configure('ColumnConf', {
  state,
  reducer,
});

还记得上面的 setup 吗， setup 可以返回一个对象，返回结果将收集在 settiings 里，现在我们稍作修改，然后来看看class吧，世界是不是清静多了呢？

import { register } from 'concent';
class ColumnConfModal extends React.Component {
  $$setup(ctx) {
    //这里定义on监听，在组件挂载完毕后开始真正监听on事件
    ctx.on('openColumnConf', () => {
      this.setState({ visible: true });
    });
    //标记依赖列表为空数组，在组件初次渲染只执行一次
    //模拟componentDidMount
    ctx.effect(() => {
      ctx.dispatch('initSelectedList', this.props.tid);
    }, []);
    return {
      moveToSelectedList: (payload) => {
        ctx.dispatch('moveToSelectedList', payload);
      },
      moveToSelectableList: (payload) => {
        ctx.dispatch('moveToSelectableList', payload);
      },
      saveSelectedList: (payload) => {
        ctx.dispatch('saveSelectedList', payload);
      },
      handleDragEnd: (payload) => {
        ctx.dispatch('handleDragEnd', payload);
      }
    }
  }
  render() {
    //从settings里取出这些方法
    const { moveToSelectedList, moveToSelectableList, saveSelectedList, handleDragEnd } = this.ctx.settings;
  }
}

爱class，爱hook，让两者和谐共处

react 社区轰轰烈烈推动了 Hook ，让大家逐步用 Hook 组件代替 class 组件，但是本质上 Hook 逃离了 this ，精简了 dom 渲染层级，但是也带来了组件存在期间大量的临时匿名闭包重复创建。

来看看 concent 怎么解决这个问题的吧，上面已提到 setup 支持返回结果，将被收集在 settiings 里，现在让稍微的调整下代码，将 class 组件吧变身为 Hook 组件吧。

import { useConcent } from 'concent';
const setup = (ctx) => {
  //这里定义on监听，在组件挂载完毕后开始真正监听on事件
  ctx.on('openColumnConf', (tid) => {
    ctx.setState({ visible: true, tid });
  });
  //标记依赖列表为空数组，在组件初次渲染只执行一次
  //模拟componentDidMount
  ctx.effect(() => {
    ctx.dispatch('initSelectedList', ctx.state.tid);
  }, []);
  return {
    moveToSelectedList: (payload) => {
      ctx.dispatch('moveToSelectedList', payload);
    },
    moveToSelectableList: (payload) => {
      ctx.dispatch('moveToSelectableList', payload);
    },
    saveSelectedList: (payload) => {
      ctx.dispatch('saveSelectedList', payload);
    },
    handleDragEnd: (payload) => {
      ctx.dispatch('handleDragEnd', payload);
    }
  }
}
const iState = { _myPrivKey: 'myPrivate state', tid:null };
export function ColumnConfModal() {
  const ctx = useConcent({ module: 'ColumnConf', setup, state: iState });
  const { moveToSelectedList, moveToSelectableList, saveSelectedList, handleDragEnd } = ctx.settings;
  const { selectedColumnKeys, selectableColumnKeys, visible, _myPrivKey } = ctx.state;
  // return your ui
}

在这里要感谢尤雨溪老师的这篇 Vue Function-based API RFC ，给了我很大的灵感，现在你可以看到所以的方法的都在 setup 里定义完成，当你的组件很多的时候，给gc减小的压力是显而易见的。

由于两者的写法高度一致，从 class 到 Hook 是不是非常的自然呢？我们其实不需要争论该用谁更好了，按照你的个人喜好就可以，就算某天你看 class 不顺眼了，在 concent 的代码风格下，重构的代价几乎为0。

使用组件

上面我们定义了一个on事件 openColumnConf ，那么我们在其他页面里引用组件 ColumnConfModal 时，当然需要触发这个事件打开其弹窗了。

import { emit } from 'concent';
class Foo extends React.Component {
  openColumnConfModal = () => {
    //如果这个类是一个concent组件
    this.ctx.emit('openColumnConfModal', 3);
    //如果不是则可以调用顶层api emit
    emit('openColumnConfModal', 3);
  }
  render() {
    return (
      <div>
        <button onClick={this.openColumnConfModal}>配置可见字段</button>
        <Table />
          <ColumnConfModal />
      </div>
    );
  }
}

上述写法里，如果有其他很多页面都需要引入 ColumnConfModal ,都需要写一个 openColumnConfModal ，我们可以把这个打开逻辑抽象到 modalService 里，专门用来打开各种弹窗，而避免在业务见到 openColumnConfModal 这个常量字符串

//code in service/modal.js
import { emit } from 'concent';
export function openColumnConfModal(tid) {
  emit('openColumnConfModal', tid);
}

现在可以这样使用组件来触发事件调用了

import * as modalService from 'service/modal';
class Foo extends React.Component {
  openColumnConfModal = () => {
    modalService.openColumnConfModal(6);
  }
  render() {
    return (
      <div>
        <button onClick={this.openColumnConfModal}>配置可见字段</button>
        <Table />
        <ColumnConfModal />
      </div>
    );
  }
}

结语

以上代码在任何一个阶段都是有效的，想要了解渐进式重构的在线demo可以 点这里

由于本篇主题主要是介绍 渐进式 重构组件，所以其他特性诸如 sync 、 computed$watch 、高性能杀手锏 renderKey 等等内容就不在这里展开讲解了，更多关于concent重构react的资料请关注其它相关文章！

原文地址：https://cloud.tencent.com/developer/article/1494206

查看更多关于concent渐进式重构react应用使用详解的详细内容...

声明：本文来自网络，不代表【好得很程序员自学网】立场，转载请注明出处：http://www.haodehen.cn/did222335
  阅读：33次

上一篇： React Context 变迁及背后实现原理详解

下一篇：monorepo实践：yarn workspace + vite + typescript + re

相关资讯