| @Transformer: 可能是最简单，但最强大的字段转换插件，一个注解搞定任意转换，让开发变得更加丝滑 | 您所在的位置：网站首页 › 性别转换软件下载 › @Transformer: 可能是最简单，但最强大的字段转换插件，一个注解搞定任意转换，让开发变得更加丝滑 |
@Transformer: 可能是最简单，但最强大的字段转换插件，一个注解搞定任意转换，让开发变得更加丝滑
|
Transformer
🎉🎉🎉 全新的2.X版本来了，代码全部重构，拥抱spring体系，功能更全面，性能更强劲。 简介 / TransformerTransformer是一款功能全面的字段转换工具，只需要几个简单的注解，即可实现各种姿势的字段转换，抛弃连表查询和累赘的转换逻辑，让开发更简单。 2.X 版已在生产环境稳定运行一年，功能更强大，性能更优越，JMH测试百万数据转换仅需0.15秒
你在查询数据对象返回给前端时是否也有以下场景： 枚举值编码转换成文本（如性别Sex，“1”要转换成“男”）需要手动转换 数据字典值转换成文本（如订单状态order_status，“1”要转换成“已下单”）需要手动转换 数据对象中的外键id要转换成name，因使用连表查询从而不得已放弃了MybatisPlus的单表增强查询功能 自定义字段转换场景（如年龄介于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 io.github.luo-zhan transform-spring-boot-starter 2.1.0-RELEASE io.github.luo-zhan transform-extension-for-mybatis-plus 2.1.0-RELEASE 性能 / 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类。 开源协议 / LicenseTransformer is under the Apache-2.0 License. 使用文档 / WIKI这里仅简单介绍效果，更多功能的详细说明请参阅 WIKI 讨论 / Discussions有任何问题或想说的，欢迎提issues或者来讨论组内畅所欲言 💬进入讨论组 |
【本文地址】