Skip to content

Latest commit

 

History

History
201 lines (152 loc) · 7.73 KB

README.md

File metadata and controls

201 lines (152 loc) · 7.73 KB

Transformer

Security Rating Reliability Rating Maintainability Rating
GitHub GitHub code size GitHub last commit

🎉🎉🎉

全新的2.X版本来了,代码全部重构,拥抱spring体系,功能更全面,性能更强劲。

简介 / Transformer

Transformer是一款功能全面的字段转换工具,只需要几个简单的注解,即可实现各种姿势的字段转换,抛弃连表查询和累赘的转换逻辑,让开发更简单。

2.X 版已在生产环境稳定运行一年,功能更强大,性能更优越,JMH测试百万数据转换仅需0.15秒

image

场景 / Situation

你在查询数据对象返回给前端时是否也有以下场景:

  1. 枚举值编码转换成文本(如性别Sex,“1”要转换成“男”)需要手动转换
  2. 数据字典值转换成文本(如订单状态order_status,“1”要转换成“已下单”)需要手动转换
  3. 数据对象中的外键id要转换成name,因使用连表查询从而不得已放弃了MybatisPlus的单表增强查询功能
  4. 自定义字段转换场景(如年龄介于10-17为少年,18-45为青年...),但代码缺少可复用性,想复用的时候不顺畅

以上转换场景你会发现都是固定的逻辑,却要在各个不同的需求中重复编写,影响业务开发的效率,Transformer正是用来解决这些问题的。

功能 / Features

  • 多种类型的转换(数据字典转换、枚举转换、表外键转换、跨服务转换等其他自定义转换)
  • 开箱即用,极简的API设计,对业务代码无侵入
  • 支持处理包装类型(如返回值Page、ResultWrapper这种包装类拆包后才是真正的数据)
  • 支持自定义转换注解,增强扩展性(支持redis、本地缓存)
  • 支持嵌套字段的转换 【2.0.0已支持】
  • 转换配置缓存,转换配置首次处理后不再重复处理,节省反射开销 【2.1.0已支持】
  • 转换结果缓存,同一线程转换结果放入ThreadLocal,提高批量转换的性能 【2.1.0已支持】
  • 多线程转换,进一步提高批量转换的性能

如果你有好的想法或建议,欢迎提issues或PR :)

快速上手 / Quick Start

1. 定义VO对象,增加转换注解

例如学生信息如下所示,返回给前端前须将其中的数值转换成可读文本

{
  "id": 1, 
  "name": "周杰伦", 
  "sex": 1,        // 性别,1-男,2-女,存储在枚举类Sex.class中
  "classId": 32,   // 班级id
  "hobby": 2       // 爱好,0-无爱好,1-学习,2-音乐,3-运动...(存储在数据字典表中,分组名为"hobby")
}

StudentVO.java定义,增加相应的几个文本字段,并加上转换注解:

/** 学生信息VO */
@Data
public class StudentVO {
    private Long id;
    // 姓名
    private String name;

    // 性别值
    private Integer sex;

    // 性别(枚举转换,Sex是性别枚举类)
    @TransformEnum(Sex.class)
    private String sexName;

    // 爱好code
    private Integer hobby;

    // 爱好名称(数据字典转换,字典的组为"hobby")
    @TransformDict(group = "hobby")
    private String hobbyName;

    // 班级id
    private Long classId;

     //班级名称(自定义转换——通过班级表的id转换成班级名称)
    @TransformClass
    private String className;
}

在文本字段上使用转换注解,其中@TransformEnum@TransformDict为内置注解,@TransformClass为自定义注解,组件支持自定义注解来提高扩展性,自定义注解的使用说明见下文wiki

2. 在查询接口的方法上添加@Transform注解,大功告成!

/** 学生接口 */
@RestController
@RequestMapping("/student")
public class StudentController {

 /**
  * 查询学生信息
  * 加上@Transform注解开启字段转换
  */
 @Transform
 @GetMapping("/{id}")
 public StudentVO getStudent(@PathVariable Long id) {
     StudentVO student = ...
     // 这里假设从数据库查询出来的数据如下:
     // {
     //   "id": 1, 
     //   "name": "周杰伦", 
     //   "sex": 1,         // 性别,1-男,2-女
     //   "hobby": 2,       // 爱好,0-无爱好,1-学习,2-音乐,3-运动,...
     //   "classId": 32     // 班级id
     
     // }
     return student;
 }

}

3. 测试

前端访问http://localhost:8080/student/1,响应结果如下:

{
"id": 1,
"name": "Jay",
"sex": 1,
"sexName": "",
"hobby": 2,
"hobbyName": "音乐"
"classId": 32,
"className": "三年二班"
}

完整示例代码见项目中transform-demo模块的StudentController

依赖 / Dependency

<dependency>
    <groupId>io.github.luo-zhan</groupId>
    <artifactId>transform-spring-boot-starter</artifactId>
    <version>2.1.2-RELEASE</version>
</dependency>

<!-- MybatisPlus扩展,增加外键id转换和Page类解包功能,非必须 -->
<dependency>
    <groupId>io.github.luo-zhan</groupId>
    <artifactId>transform-extension-for-mybatis-plus</artifactId>
    <version>2.1.2-RELEASE</version>
</dependency>

 <!-- MybatisFlex扩展,增加外键id转换和Page类解包功能,非必须 -->
 <dependency>
     <groupId>io.github.luo-zhan</groupId>
     <artifactId>transform-extension-for-mybatis-flex</artifactId>
     <version>2.1.2-RELEASE</version>
 </dependency>

性能 / JMH

使用JMH基准测试工具,分别测试了普通转换(transform),嵌套转换(transformNest)对一万、十万、百万数据的平均处理时间。

JMH测试报告如下:
CPU:Intel(R) Core(TM) i7-10700 CPU @ 2.90GHz
Benchmark                         (number)   Mode     Score   Error   Units
TransformBenchmark.transform         10000   avgt     1.130           ms/op
TransformBenchmark.transform        100000   avgt    16.337           ms/op
TransformBenchmark.transform       1000000   avgt   159.852           ms/op
TransformBenchmark.transformNest     10000   avgt     4.019           ms/op
TransformBenchmark.transformNest    100000   avgt    48.355           ms/op
TransformBenchmark.transformNest   1000000   avgt   469.017           ms/op

注意:以上测试未包含IO访问,如果涉及IO访问,由于组件设计了转换结果缓存,所以转换性能将与IO耗时以及请求数据重复率有很大关系,所以具体性能还需根据实际情况而定。

测试代码详见transform-demo模块的TransformBenchmark类。

开源协议 / License

Transformer is under the Apache-2.0 License.

使用文档 / WIKI

这里仅简单介绍效果,更多功能的详细说明请参阅 WIKI

讨论 / Discussions

有任何问题或想说的,欢迎提issues或者来讨论组内畅所欲言

💬进入讨论组