浅析如何使用JavaScript轻松实现数据转换_Javascript

之前写了一篇《typescript装饰器之我们是这么处理项目数据转换的》，有很多朋友私信和评论说，如果没有 typescript 和 装饰器，纯 javascript 有没有什么好的数据转换的方案呢？

很遗憾，还真有，虽然没有 typescript 那么优雅，但是也足够好用。

这里用到了 getter/setter，以及 object 原型链相关的知识。

一、假设需求

1. 后端返回的数据

这里我们先假设从后端来了个 json 长这样：

{
  id: 1,
  nickname: 'hamm',
  age: 18,
  sex: 1,
  createtime: 1707021296000,
  bio: '一些废话，前端不需要的字段'
}

其中，id createtime 是固定返回的公共属性。

2. 前端类型声明

基类

class baseentity {
  id;
  createtime;
}

用户类

class user extends baseentity {
  nickname;
  age;
  sex;
}

3. 转换要求

转换到类时

createtime 转为 date类型；
前端使用 gender 作为性别字段，且需要根据 1/0 显示男女；
前端没有 bio 字段，需要过滤掉。

转换到 json 时

createtime 转回后端需要的时间戳
gender 还原回后段需要的 sex，并且转换为 1/0

二、实现思路

正如我们之前有篇关于几个有关getter/setter的小故事文章中提到，我们可以用 getter/setter 来拦截数据达到转换数据的目的：

1. 基于基类实现 fromjson 静态方法

class baseentity {
  id;
  createtime;

  static fromjson(json) {
    const user = new this();
    const filteredjson = object.keys(json).reduce((item, key) => {
      if (user.hasownproperty(key)) {
        item[key] = json[key];
      }
      if (user.__proto__.hasownproperty(key)) {
        item[key] = json[key];
      }
      return item;
    }, {});
    const entity = object.assign(user, filteredjson);
    if (entity.createtime) {
      entity.createtime = new date(entity.createtime);
    }
    return entity;
  }
}

class userentity extends baseentity {
  nickname;
  age;
  gender;
  get sex() {
    return this.gender;
  }
  set sex(value) {
    if (value === undefined || value === null) {
      this.gender = undefined
    }else{
      this.gender = value === 1 ? '男' : '女';
    }
  }
}

const json = {
  id: 1,
  nickname: 'hamm',
  age: 18,
  sex: 1,
  createtime: 1707021296000,
  bio: '一些废话，前端不需要的字段'
}
console.log("json", json)
const user = userentity.fromjson(json)
console.log("entity", user)

其中，我们通过读取 getter/setter 以及本身的属性，来确定哪些是直接赋值，哪些是走set方法，哪些不存在的需要忽略。

2.调试输出，美滋滋

json {
  id: 1,
  nickname: 'hamm',
  age: 18,
  sex: 1,
  createtime: 1707021296000,
  bio: '一些废话，前端不需要的字段'
}
entity userentity {
  id: 1,
  createtime: 2024-02-04t04:34:56.000z,
  nickname: 'hamm',
  age: 18,
  gender: '男'
}

3. 实现动态方法的 tojson

接下来，我们需要将 baseentity 添加一个 tojson 方法，用于将实体转换为 json 格式，且给 userentity 的 sex getter 做一下数据转换：

class baseentity {
  id;
  createtime;

  static fromjson(json) {
    const user = new this();
    const filteredjson = object.keys(json).reduce((item, key) => {
      if (user.hasownproperty(key)) {
        item[key] = json[key];
      }
      if (user.__proto__.hasownproperty(key)) {
        item[key] = json[key];
      }
      return item;
    }, {});
    const entity = object.assign(user, filteredjson);
    if (entity.createtime) {
      entity.createtime = new date(entity.createtime);
    }
    return entity;
  }

  tojson() {
    const proto = object.getprototypeof(this);
    const ownproperties = object.getownpropertynames(this);
    const getters = object.getownpropertynames(proto).filter(key => {
      const descriptor = object.getownpropertydescriptor(proto, key);
      return descriptor && typeof descriptor.get === 'function';
    });
    const json = {}
    getters.foreach(key => {
      if (this.__proto__.hasownproperty(key)) {
        json[key] = this[key]
        this[key] = undefined
      }
    })
    ownproperties.foreach(key => {
      if (this.hasownproperty(key)) {
        json[key] = this[key]
        this[key] = undefined
      }
    })
    if (json.createtime && typeof json.createtime === 'object') {
      json.createtime = json.createtime.valueof()
    } else {
      json.createtime = undefined
    }
    return json.parse(json.stringify(json))
  }
}

class userentity extends baseentity {
  nickname;
  age;
  gender;
  get sex() {
    if (this.gender === undefined || this.gender === null) {
      return undefined
    }
    return this.gender === '男' ? 1 : 0;
  }
  set sex(value) {
    if (value === undefined || value === null) {
      this.gender = undefined
    }else{
      this.gender = value === 1 ? '男' : '女';
    }
  }
}

const user = new userentity()
user.id = 1
user.nickname = "hamm"
user.age = 18
user.gender = "男"
user.createtime = new date()
console.log("entity", user)
console.log("json", user.tojson())

4. 继续调试输出，继续美滋滋

entity userentity {
  id: 1,
  createtime: 2024-10-23t19:37:07.521z,
  nickname: 'hamm',
  age: 18,
  gender: '男'
}
json { sex: 1, id: 1, createtime: 1729712227521, nickname: 'hamm', age: 18 }

三、完整代码如下

class baseentity {
  id;
  createtime;

  static fromjson(json) {
    const user = new this();
    const filteredjson = object.keys(json).reduce((item, key) => {
      if (user.hasownproperty(key)) {
        item[key] = json[key];
      }
      if (user.__proto__.hasownproperty(key)) {
        item[key] = json[key];
      }
      return item;
    }, {});
    const entity = object.assign(user, filteredjson);
    if (entity.createtime) {
      entity.createtime = new date(entity.createtime);
    }
    return entity;
  }

  tojson() {
    const proto = object.getprototypeof(this);
    const ownproperties = object.getownpropertynames(this);
    const getters = object.getownpropertynames(proto).filter(key => {
      const descriptor = object.getownpropertydescriptor(proto, key);
      return descriptor && typeof descriptor.get === 'function';
    });
    const json = {}
    getters.foreach(key => {
      if (this.__proto__.hasownproperty(key)) {
        json[key] = this[key]
        this[key] = undefined
      }
    })
    ownproperties.foreach(key => {
      if (this.hasownproperty(key)) {
        json[key] = this[key]
        this[key] = undefined
      }
    })
    if (json.createtime && typeof json.createtime === 'object') {
      json.createtime = json.createtime.valueof()
    } else {
      json.createtime = undefined
    }
    return json.parse(json.stringify(json))
  }
}

class userentity extends baseentity {
  nickname;
  age;
  gender;
  get sex() {
    if (this.gender === undefined || this.gender === null) {
      return undefined
    }
    return this.gender === '男' ? 1 : 0;
  }
  set sex(value) {
    if (value === undefined || value === null) {
      this.gender = undefined
    }else{
      this.gender = value === 1 ? '男' : '女';
    }
  }
}

const json = {
  id: 1,
  nickname: 'hamm',
  age: 18,
  sex: 1,
  createtime: 1707021296000,
  bio: '一些废话，前端不需要的字段'
}
console.log("json",json)
const user = userentity.fromjson(json)
console.log("entity", user)
console.log("json", user.tojson())