babel在提升前端效率的实践

大纲

遇到的问题场景及解决方案对比

我们目前采用的是antd + react(umi)的框架做业务开发。在业务开发过程中会有较多频繁出现并且相似度很高的场景，比如基于一个table的基础的增删改查，这个相信大家都非常熟悉。在接到一个新的业务需求的时候，相信有不少人会选择copy一份功能类似的代码然后基于这份代码去改造以满足当前业务，当然我目前也是这样做的~

其实想把这块功能提取成一个公共组建的想法由来已久，最近开始做基础组件，便拿这个下手了。经过一周左右的时间完成了基础组件的编写。

基本的思路是通过json生成一些抽象配置，然后通过解析json的抽象配置+渲染器最终生成页面。json配置涵盖了目前80%的业务场景的基本需求，但是可扩展性很低。比如一些复杂的业务场景： 表单的关联校验 、 数据关联显示 、 多级列表下钻 等等功能。虽然通过一些较为复杂的处理可以把这些功能融入进来，但最终组件将会异常庞大难以维护。

所以，我能不能通过这些json配置通过某种 工具 生成对应的代码？这样一来以上提到的问题就完全不存在了，因为这和我们自己写的代码完全一样，工具只是帮我们完成初始化的过程。所以后来想了很多办法，最初采用 template string 的方式，这种方式较为简单粗暴，无非通过string中嵌套变量的判断来输出code。但是在实际写的时候发现很多问题，比如

function

最终学习了一些生成代码的工具比如angular-cli以及一些关于js生成代码的文章，主要是通过知乎上的这篇 讨论 了解到了大家是怎么处理这种问题的。最终决定采用babel的生态链来解决上述遇到的问题。

我们目前采用的方式是基于antd+react(umi)编写通用的CRUD模板，然后通过代码生成器解析json中的配置生成对应的代码，大致的流程是：

React --> JavaScript AST ---> Code Generator --> Compiler --> Page

目前功能只是完成了初步版本，待应用在项目中使用一段时间稳定之后将会开源~

什么是babel？

Babel是一个工具链，主要用于编译ECMAScript 2015+代码转换为向后兼容的可运行在各种浏览器上的JavaScript。主要功能：

1. 语法转换
2. 环境中缺少的Polyfill功能
3. 源代码转换
4. 查看更多Babel功能

如上提供了babel基本的流程及一篇介绍AST的文章。

我的理解中比如一段string类型code，首先通过babel.transform会将code转为一个包含AST(Abstract Syntax Tree)的Object，同样可以使用@babel/generator将AST转为code完成逆向过程。

例如一段变量声明代码：

const a = 1;

在解析之后的结构为：

{
  "type": "Program",
  "start": 0,
  "end": 191,
  "body": [
    {
      "type": "VariableDeclaration",
      "start": 179,
      "end": 191,
      "declarations": [
        {
          "type": "VariableDeclarator",
          "start": 185,
          "end": 190,
          "id": {
            "type": "Identifier",
            "start": 185,
            "end": 186,
            "name": "a"
          },
          "init": {
            "type": "Literal",
            "start": 189,
            "end": 190,
            "value": 1,
            "raw": "1"
          }
        }
      ],
      "kind": "const"
    }
  ],
  "sourceType": "module"
}

首先类型为 VariableDeclaration ，首先他的类型是 const ，可以通过点击查看api其它还有 let 、 var 的值。其次是声明 declarations 部分，这里值为数组，因为我们可以同时定义多个变量。数组中值的类型为 VariableDeclarator ，包含 id 和 init 两个参数，分别为变量名称以及变量值。 id 的类型为 Identifier ，译为修饰符即是变量名称。 init 类型为 Literal ，即是常量，一般常用的有 stringLiteral 、 numericliteral 、 booleanliteral 等。此时即完成了变量赋值的过程。

当然这只是很简单的语法转换，如果大家想学习更多关于转换及类型的知识，可参考如下两个官方链接：

• babel-types
• ast转换工具

解决过程

首先定义目录结构：

.
├── genCode // 代码生成器
|   ├── genDetail          // 需要新页面打开时单独的detail目录
|   └── genIndex           // 首页
|   └── genModels          // umi models
|   └── genServices        // umi services
|   └── genTableFilter     // table筛选区域
|   └── genTableForm       // 非新页面模式，新增/更新模态框
|   └── genUpsert          // 新页面模式下，新增/更新页面
|   └── genUtils           // 生成工具类
├── schema                 // 模型定义文件
|   ├── table              // 当前要生成的模型
|   └── ├──config.js       // 基础配置
|   └── └──dataSchema.js   // 列表、新增、更新配置
|   └── └──querySchema.js  // 筛选项配置
├── scripts                // 生成脚本
|   ├── generateCode.js    // 生成主文件
|   └── index.js           // 入口
|   └── utils.js           // 工具类
├── toCopyFiles            // 生成时需要拷贝的文件，比如less
└── index.js               // 主入口

主体流程为：

eslint ${filePath} --fix

其中主要模块为genCode文件夹中根据json配置生成代码的过程。

以genModels为例，首先提取可以使用 template string 完成的部分，减少代码解析的工作量。

module.exports = (tableConfig) => {
  return `
        import { message } from 'antd';
        import { routerRedux } from 'dva/router'
        import { parse } from 'qs'
        ${dynamicImport(dicArray, namespace)}

        export default {
            namespace: '${namespace}',
            state: {
                ...
            },
            effects: {
                *fetch({ payload }, { call, put }) {
                    const response = yield call(queryData, payload);
                    if (response && response.errorCode === 0) {
                        yield put({
                            type: 'save',
                            payload: response.data,
                        });
                    } else {
                        message.error(response && response.errorMessage || '请求失败')
                    }
                },
                ...,
                ${dynamicYieldFunction(dicArray)}
            },

            reducers: {
                save(state, action) {
                    return {
                        ...state,
                        data: action.payload,
                    };
                },
                ...,
                ${dynamicReducerFunction(dicArray)}
            },
        };
    `
}

因为列表数据可能有字典项从后台获取值来对应显示，所以 import 、 effects 、 reducers 模块均有需根据配置动态生成的代码。

以dynamecImport为例:

function dynamicImport (dicArray, namespace) {
    // 基础api import
    let baseImport = [
      'queryData', 'removeData', 'addData', 'updateData', 'findById'
    ]
    // 判断json数据中是否有需从后台加载项
    if (dicArray && dicArray.length) {
      baseImport = baseImport.concat(dicArray.map(key => getInjectVariableKey(key)))
    }
    // 遍历生成依赖项
    const _importDeclarationArray = map(specifier => (
      _importDeclarationArray.push(t.importSpecifier(t.identifier(specifier), t.identifier(specifier)))
    ))
    // 定义importDeclaration
    const ast = t.importDeclaration(
      _importDeclarationArray,
      t.stringLiteral(`../services/${namespace}`)
    )
    // 通过@babel/generator 将ast生成code
    const { code } = generate(ast)

    return code
  }

其它代码生成逻辑类似，有不确定如何生成的部分可参考上方提供的链接完成代码转换再去生成。

若有通过babel转换无法生成的代码，可通过正则来完成。

例如以下 umi-models 代码：

*__dicData({ payload }, { call, put }) {
      const response = yield call(__dicData, payload);
      if (response && response.errorCode === 0) {
        yield put({
          type: 'updateDic',
          payload: response.data,
        });
      } else {
        message.error(response && response.errorMessage || '请求失败')
      }
    }

基础代码可通过 yieldExpression 生成，但是转换之后无function之后的 * 符号，反复差了文档之后没有解决办法，最后只能将生成完的code利用正则替换来解决。

如果大家有遇到类似的问题欢迎讨论~

问题

1. 目前使用的编辑器组件为 braft-editor ，但是结合antd使用initialValue不生效，必须使用setFieldsValue。但是使用useEffects时会默认添加props.form作为依赖并且props.form会不断变化而触发死循环，目前无奈只有禁用eslint react-hooks/exhaustive-deps。

useEffect(() => {
    props.form.setFieldsValue({
      editorArea: BraftEditor.createEditorState(current.editorArea),
      editorArea2: BraftEditor.createEditorState(current.editorArea2)
    });
  }, [current.editorArea, current.editorArea2]);

1. 生成的代码怎么删除未使用的依赖？使用eslint --fix不会删除未使用的变量定义。
2. 初始化之后的代码要修改怎么办？因当前方法只会完成代码初始化过程，以后修改的过程暂无思路解决。

功能API

参数规范参考 react-antd-admin

功能配置包含三个基础配置文件:

config.json

配置列表

upload

pagination

dictionary

dataSchema.json

配置列表

actions

querySchema.json

配置列表

参考

• react-antd-admin
• AST语法转换器
• babel-types-api