Class-Transformer库介绍

在前后端分离开发的过程中,前端开发人员如果想要避免因为接口字段不同造成效率下降的问题,就需要将后端传递的plainText中的字段进行转化。显然这里是在应用层面上使用了适配器模式。本文介绍一个js库实现对象字段名的转化功能。

1. Class-Transformer基本使用步骤

Class-Transformer是一个用于转换类实例的库,主要用于在对象之间进行数据映射。以下是使用Class-Transformer的基本步骤:

1.1 安装Class-Transformer

通过npm或yarn安装Class-Transformer库:

bash 复制代码
npm install class-transformer

或

bash 复制代码
yarn add class-transformer

1.2 创建类实体

定义需要进行转换的类实体,例如:

typescript 复制代码
// user.entity.ts
import { Expose } from 'class-transformer';

export class UserEntity {
  @Expose()
  id: number;

  @Expose()
  name: string;

  @Expose()
  email: string;
}

1.3 进行转换

在需要进行转换的地方,使用classToPlain或plainToClass方法进行对象的转换:

typescript 复制代码
// main.ts
import { classToPlain, plainToClass } from 'class-transformer';
import { UserEntity } from './user.entity';

const userObject = {
  id: 1,
  name: 'John Doe',
  email: 'john@example.com',
};

// 转换为UserEntity实例
const userInstance = plainToClass(UserEntity, userObject);

// 转换为普通JavaScript对象
const plainObject = classToPlain(userInstance);

2. Class-Transformer高级使用技巧

2.1 字段别名

通过@Expose装饰器设置字段的别名,用于在转换时更改字段名称:

typescript 复制代码
// user.entity.ts
import { Expose } from 'class-transformer';

export class UserEntity {
  @Expose({ name: 'userID' })
  id: number;

  @Expose({ name: 'fullName' })
  name: string;

  @Expose()
  email: string;
}

2.2 转换嵌套对象

Class-Transformer支持转换嵌套对象,使用@Type装饰器指定嵌套对象的类型:

typescript 复制代码
// user.entity.ts
import { Expose, Type } from 'class-transformer';
import { RoleEntity } from './role.entity';

export class UserEntity {
  @Expose()
  id: number;

  @Expose()
  name: string;

  @Expose()
  email: string;

  @Type(() => RoleEntity)
  @Expose()
  roles: RoleEntity[];
}

3. Class-Transformer在前后端通信中的字段转换功能

Class-Transformer在前后端通信中的字段转换功能主要体现在处理后端返回的数据或前端发送的数据时,通过定义类实体并使用转换方法,实现字段名称的映射。在使用axios进行网络请求时,我们可以在处理后端返回的数据时应用Class-Transformer进行字段转换。

举例说明

假设我们有一个后端API返回的用户信息如下:

json 复制代码
{
  "user_id": 1,
  "full_name": "John Doe",
  "email_address": "john@example.com"
}

而前端希望使用以下UserEntity类表示用户信息:

typescript 复制代码
// user.entity.ts
import { Expose } from 'class-transformer';

export class UserEntity {
  @Expose({ name: 'user_id' })
  id: number;

  @Expose({ name: 'full_name' })
  name: string;

  @Expose({ name: 'email_address' })
  email: string;
}

如果使用的是js的话那就是:

js 复制代码
const { plainToClass, Transform, Expose } = require('class-transformer');

class UserEntity {
  @Expose({ name: 'user_id' })
  id;

  @Expose({ name: 'full_name' })
  name;

  @Expose({ name: 'email_address' })
  email;
}

接下来,在前端进行网络请求时,可以使用axios获取后端返回的用户信息,并应用Class-Transformer进行字段转换:

typescript 复制代码
// user.service.ts
import axios from 'axios';
import { plainToClass } from 'class-transformer';
import { UserEntity } from './user.entity';

export async function getUserInfo(userId: number): Promise<UserEntity> {
  try {
    const response = await axios.get(`/api/user/${userId}`);
    
    // 后端返回的数据进行字段转换为UserEntity实例
    const userEntity = plainToClass(UserEntity, response.data);

    return userEntity;
  } catch (error) {
    console.error('Error fetching user info:', error);
    throw error;
  }
}

在这个例子中,getUserInfo函数使用axios获取后端返回的用户信息,然后通过Class-Transformer的plainToClass方法将后端返回的数据转换为前端定义的UserEntity实例,实现了字段名称的映射。这样,在前端业务逻辑中,我们可以直接使用UserEntity类表示用户信息,而不必关心后端返回的原始字段名称。这种映射关系的定义可以使前后端在数据传递时更加灵活和可维护。

相关推荐
SEO_juper32 分钟前
Node.js 全站 SEO 体检报告生成器:一次查完标题、描述、canonical、H1、图片
开发语言·前端·node.js·html·bash
木头左1 天前
【Node.js】Markdown 转带图片 Word 文档实战:docx 库转换器设计与 5 个踩坑
node.js·word·markdown·文档自动化
思特奇时空智能1 天前
大规模点要素地图渲染性能优化实践
vue.js·arcgis·性能优化·node.js·html·gis·webgl
w3296362713 天前
飞书接单到月度结算:我用一个 DSH 插件跑通鞋类采购 WMS,附 22 项验收
pdf·node.js·飞书·后端开发·ai agent
濮水大叔4 天前
Cabloy/Vona 为什么不需要 NestJS 的 Dynamic Module
typescript·node.js·nestjs
匠云创新4 天前
读完一万段要两分钟:我们把标书读取从 WPS 对象模型搬到了 docx 解析
性能优化·node.js
某哈压力大4 天前
SSH 突然 Connection reset?不是密钥坏了,是 OpenSSL 把 sshd 干趴了
前端·node.js·命令行
回眸&啤酒鸭4 天前
【回眸】Node.js 新手从零到一实战指南
node.js
浪遏4 天前
recruitment-cli:让 AI 接手求职招聘,从架构到一次发送超时
架构·typescript·node.js
沉默小管6 天前
我用 NestJS + Nuxt 3 做了个导航站,聊几个踩过的坑
node.js·seo