从数据库到前端，使用 enum 代替 constant number

在我经历过的几个以node为主的后端项目中，都有一个文件 constant.js。顾名思义，里边保存着各类常量，而大可能是字符串与数字的对应关系。

可是在实际工做中，根据数字来调试至关费劲，先不说后端代码中 where (status === 1) 这种可避免的神奇操做。(PS: 虽然我在吐槽它，可是有时我也会犯，给后来不熟悉业务者一脸懵逼...)。在数据库中查询也会遇到一些问题。

记得在咱们数据库中，有一个用户表，其中一个字段 user_type 中 1和2表明学生和老师，刚开始还能够轻易分清，后来文档对列的注释给搞反了，自此每次查询以前我都须要先查一遍数据库的注释，试想一下若是此时它是一个 enum('STUDENT', 'TEACHER') 的值，则能够轻易分清了，不须要再记各类数字了

如下以一个 TODO 的三种状态 TODO，DONE 以及 DOING 来描述下数据库，后端和前端如何传输以及展现

本文地址 shanyue.tech/post/consta…

使用数字

在数据库中使用数字来表示状态，有多是 Base 1 的 123，也有多是 Base 0 的 012。不过最重要的是要记得在数据库中对列添加注释

-- mysql 能够直接注释
create table todo (
  status smallint default 1 comment "1: TODO, 2: DOING, 3: DONE";
)

-- postgres 在 comment 中进行注释
create table todo (
  status smallint default 1;
)
comment on column todo.status is '1: TODO, 2: DOING, 3: DONE';
复制代码

在后端为了筛选条件下避免如下状况的出现，须要维护一个 constant 的变量

const where = {
  // 为了不直接出现 1
  Status: 1
}
复制代码

使用 Status 来维护一个常量，response 表明返给前端的数据

const Status = {
  TODO: 1,
  DOING: 2,
  DONE: 3
}

const where = {
  Status: Status.TODO
}

const response = [{
  status: Status.TODO
}]
复制代码

在前端维护一个数字至中文展现的映射

const status_show = {
  1: '待办',
  2: '进行中',
  3: '已完成'
}

const url = '/api/todos?status=1'
复制代码

但在这种状况下，在进行接口联调时仍会是 1/2/3，不便于调试

使用 enum

在 postgres 中添加 todos_status 的 type

create type todo_status as enum ('UNDO', 'DOING', 'DONE');

create table todo (
  status todo_status default 'UNDO',
);
复制代码

在后端能够直接在筛选条件中使用字符串

const where = {
  Status: 'TODO'
}
复制代码

若是为了不使用字符串打错了字符，可使用 typescript 的 const enum 在编译器发现问题

const enum Status {
    TODO = 'TODO',
    DOING = 'DOING',
    DONE = 'DONE'
}

const where = {
  Status: Status.TODO
}
复制代码

编译以后的 javascript 代码以下

var where = {
    Status: "TODO" /* TODO */
};
复制代码

在前端维护一个常量至中文展现的映射，能够看出请求的 url 对于调试与可读性已经很友好了

const status_show = {
  TODO: '待办',
  DOING: '进行中',
  DONE: '已完成'
}

const url = '/api/todos?status=TODO'
复制代码

使用 graphql

数据库依然使用 enum 来表示 TODO 的状态

在 graphql 中，使用如下 Schema 表示 TODO，TodoStatus 以及查询列表的 query。TodoStatus 可使用 enum 来表示

enum TodoStatus {
  DONE 
  DOING
  UNDO
}

type Todo {
  id: ID!
  status: TodoStatus!
}

type Query {
  todos (
    status: TodoStatus
  ): [Poem!]
}
复制代码

使用如下 query 筛选 todos

query TODOS ($status: TodoStatus) {
  todos (status: $status) {
    id
    status
  }
}
复制代码