Springboot 为了偷懒，我封装了一个自适配的数据单位转换工具类

电玩女神 2023-09-24 19:54 9阅读 0赞

# 前言 #

平时做一些统计数据，经常从数据库或者是从接口获取出来的数据，单位是跟业务需求不一致的。

比如， 我们拿出来的 **分**， 实际上要是**元**

又比如，我们拿到的数据需要 **乘以100** 返回给前端做 百分比展示

又比如， 千分比转换

又比如，拿出来的金额需要**变成 万为单位**

又比如，需要**保留2位小数**

......

等等等等。

平时我们怎么搞？  
很多时候拿到的是一个数据集合list，就需要去遍历然后根据每个DTO的属性去做相关单位转换。

一直get 完 set ，get 完 set ，get 完 set ，get 完 set ，get 完 set ，人都麻了。

![25b5ddddbc5046d5a7598e2ef730f64c.png][]

就像这样：

![a14591736c04455bb6c25a933f7adfeb.png][]

所以，如果通过反射自动匹配出来一些操作转换，是不是就看代码看起来舒服一点，人也轻松一点。

**答案： 是的**

然后，我就搞了。

# 正文 #

##    **本篇内容简要：** ##

### **① 初步的封装，通过map去标记需要转换的 类属性字段** ###

### **② 进一步的封装， 配合老朋友自定义注解搞事情** ###

> **产品：**
> 
> 支付总金额 换成万 为单位， 方便运营统计 ；
> 
> 那个什么计数，要是百分比的 ；
> 
> 然后还有一个是千分比；
> 
> 另外，还有2个要保留2位小数；
> 
> 还有啊，那个。。。。。。
> 
> **我：**
> 
> 别说了，喝口水吧。

拿到的数据都在这个DTO里面 ：

![8d3c0fd1646c4befab98c3599268a2e1.png][]

开始封装：

## **① 初步的封装，通过map去标记需要转换的 类属性字段** ##

###    思路玩法： ###

a.通过反射拿出字段  
b.配合传入的转换标记Map 匹配哪些字段需要操作  
c.然后从map取出相关字段的具体操作是什么，然后执行转换操作  
d.重新赋值

① 简单弄个枚举，列出现在需求上的转换操作类型

UnitConvertType.java

/**
     * @Author : JCccc
     * @CreateTime : 2023/01/14
     * @Description :
     **/
    public enum UnitConvertType {
    
        /**
         * 精度
         */
        R,
        /**
         * 万元
         */
        B,
        /**
         * 百分
         */
        PERCENTAGE,
        /**
         * 千分
         */
        PERMIL
    }

② 核心封装的转换函数

UnitConvertUtil.java

import lombok.extern.slf4j.Slf4j;
    import java.lang.reflect.Field;
    import java.math.BigDecimal;
    import java.util.ArrayList;
    import java.util.HashMap;
    import java.util.List;
    import java.util.Map;
    
    /**
     * @Author : JCccc
     * @CreateTime : 2023/01/14
     * @Description :
     **/
    @Slf4j
    public class UnitConvertUtil {
    
        public static <T> void unitMapConvert(List<T> list, Map<String, UnitConvertType> propertyMap) {
            for (T t : list) {
                Field[] declaredFields = t.getClass().getDeclaredFields();
                for (Field declaredField : declaredFields) {
                    if (propertyMap.keySet().stream().anyMatch(x -> x.equals(declaredField.getName()))) {
                        try {
                            declaredField.setAccessible(true);
                            Object o = declaredField.get(t);
                            UnitConvertType unitConvertType = propertyMap.get(declaredField.getName());
                            if (o != null) {
                                if (unitConvertType.equals(UnitConvertType.PERCENTAGE)) {
                                    BigDecimal bigDecimal = ((BigDecimal) o).multiply(new BigDecimal(100)).setScale(2, BigDecimal.ROUND_HALF_UP);
                                    declaredField.set(t, bigDecimal);
                                }
                                if (unitConvertType.equals(UnitConvertType.PERMIL)) {
                                    BigDecimal bigDecimal = ((BigDecimal) o).multiply(new BigDecimal(1000)).setScale(2, BigDecimal.ROUND_HALF_UP);
                                    declaredField.set(t, bigDecimal);
                                }
                                if (unitConvertType.equals(UnitConvertType.B)) {
                                    BigDecimal bigDecimal = ((BigDecimal) o).divide(new BigDecimal(10000)).setScale(2, BigDecimal.ROUND_HALF_UP);
                                    declaredField.set(t, bigDecimal);
                                }
                                if (unitConvertType.equals(UnitConvertType.R)) {
                                    BigDecimal bigDecimal = ((BigDecimal) o).setScale(2, BigDecimal.ROUND_HALF_UP);
                                    declaredField.set(t, bigDecimal);
                                }
                            }
                        } catch (Exception ex) {
                            log.error("处理失败");
                            continue;
                        }
    
                    }
                }
            }
        }
        
        public static void main(String[] args) {
    
            //获取模拟数据
            List<MySumReportDTO> list = getMySumReportList();
    
            Map<String, UnitConvertType> map =new HashMap<>();
            map.put("payTotalAmount", UnitConvertType.B);
            map.put("jcAmountPercentage", UnitConvertType.PERCENTAGE);
            map.put("jcCountPermillage", UnitConvertType.PERMIL);
            map.put("length", UnitConvertType.R);
            map.put("width", UnitConvertType.R);
            unitMapConvert(list,map);
            System.out.println("通过map标识的自动转换玩法："+list.toString());
    
        }
    
        private static List<MySumReportDTO> getMySumReportList() {
            MySumReportDTO mySumReportDTO = new MySumReportDTO();
            mySumReportDTO.setPayTotalAmount(new BigDecimal(1100000));
            mySumReportDTO.setJcAmountPercentage(BigDecimal.valueOf(0.695));
            mySumReportDTO.setJcCountPermillage(BigDecimal.valueOf(0.7894));
            mySumReportDTO.setLength(BigDecimal.valueOf(1300.65112));
            mySumReportDTO.setWidth(BigDecimal.valueOf(6522.12344));
    
            MySumReportDTO mySumReportDTO1 = new MySumReportDTO();
            mySumReportDTO1.setPayTotalAmount(new BigDecimal(2390000));
            mySumReportDTO1.setJcAmountPercentage(BigDecimal.valueOf(0.885));
            mySumReportDTO1.setJcCountPermillage(BigDecimal.valueOf(0.2394));
            mySumReportDTO1.setLength(BigDecimal.valueOf(1700.64003));
            mySumReportDTO1.setWidth(BigDecimal.valueOf(7522.12344));
    
    
            List<MySumReportDTO> list = new ArrayList<>();
    
            list.add(mySumReportDTO);
            list.add(mySumReportDTO1);
            return list;
        }
       
    
    }

代码简析：

![37f1648ed4bb4a6e9fa8f9f526712951.png][]

看看怎么调用的：

>     public static void main(String[] args) {
>     
>         //获取模拟数据
>         List<MySumReportDTO> list = getMySumReportList();
>         System.out.println("转换前："+list.toString());
>         Map<String, UnitConvertType> map =new HashMap<>();
>         map.put("payTotalAmount", UnitConvertType.B);
>         map.put("jcAmountPercentage", UnitConvertType.PERCENTAGE);
>         map.put("jcCountPermillage", UnitConvertType.PERMIL);
>         map.put("length", UnitConvertType.R);
>         map.put("width", UnitConvertType.R);
>         unitMapConvert(list,map);
>         System.out.println("通过map标识的自动转换玩法："+list.toString());
>         
>     }

代码简析：

![ff5ddf2745b64b3a9882ebcea20b1157.png][]

效果：  
  
![c4ee715fbec34ec7a744902412f13844.png][]

整个集合list的 对应字段都自动转换成功（转换逻辑想怎么样就自己在对应if里面调整、拓展）：

![9857e3da2ef84de3b69514129e6e9c6e.png][]

## **② 进一步的封装， 配合老朋友自定义注解搞事情** ##

实说实话，第一步的封装程度已经够用了，就是传map标识出来哪些需要转换，对应转换枚举类型是什么。

其实我感觉是够用的。

但是么，为了用起来更加方便，或者说 更加地可拓展， 那么配合自定义注解是更nice的。

开搞。

创建一个自定义注解 ，JcBigDecConvert.java

import java.lang.annotation.ElementType;
    import java.lang.annotation.Retention;
    import java.lang.annotation.RetentionPolicy;
    import java.lang.annotation.Target;
    
    /**
     * @Author : JCccc
     * @CreateTime : 2023/01/14
     * @Description :
     **/
    @Target(ElementType.FIELD)
    @Retention(RetentionPolicy.RUNTIME)
    public @interface JcBigDecConvert {
    
        UnitConvertType name();
    }

怎么用？ 就是在我们的报表DTO里面，去标记字段。

示例：

MyYearSumReportDTO.java  
  
ps： 可以看到我们在字段上面使用了自定义注解

import lombok.Data;
    import java.io.Serializable;
    import java.math.BigDecimal;
    
    /**
     * @Author : JCccc
     * @CreateTime : 2023/2/03
     * @Description :
     **/
    
    @Data
    public class MyYearSumReportDTO implements Serializable {
        private static final long serialVersionUID = 5285987517581372888L;
    
        //支付总金额
        @JcBigDecConvert(name=UnitConvertType.B)
        private BigDecimal payTotalAmount;
    
        //jc金额百分比
        @JcBigDecConvert(name=UnitConvertType.PERCENTAGE)
        private BigDecimal jcAmountPercentage;
    
        //jc计数千分比
        @JcBigDecConvert(name=UnitConvertType.PERMIL)
        private BigDecimal jcCountPermillage;
    
        //保留2位
        @JcBigDecConvert(name=UnitConvertType.R)
        private BigDecimal length;
    
        //保留2位
        @JcBigDecConvert(name=UnitConvertType.R)
        private BigDecimal width;
    
    
    }

然后针对配合我们的自定义，封一个转换函数，反射获取属性字段，然后解析注解，然后做对应转换操作。

![236a674b3903449f84e8f1557489c108.png][]

代码：

public static <T> void unitAnnotateConvert(List<T> list) {
            for (T t : list) {
                Field[] declaredFields = t.getClass().getDeclaredFields();
                for (Field declaredField : declaredFields) {
                        try {
                            if (declaredField.getName().equals("serialVersionUID")){
                                continue;
                            }
                            JcBigDecConvert myFieldAnn = declaredField.getAnnotation(JcBigDecConvert.class);
                            if(Objects.isNull(myFieldAnn)){
                                continue;
                            }
                            UnitConvertType unitConvertType = myFieldAnn.name();
                            declaredField.setAccessible(true);
                            Object o = declaredField.get(t);
                            if (Objects.nonNull(o)) {
                                if (unitConvertType.equals(UnitConvertType.PERCENTAGE)) {
                                    BigDecimal bigDecimal = ((BigDecimal) o).multiply(new BigDecimal(100)).setScale(2, BigDecimal.ROUND_HALF_UP);
                                    declaredField.set(t, bigDecimal);
                                }
                                if (unitConvertType.equals(UnitConvertType.PERMIL)) {
                                    BigDecimal bigDecimal = ((BigDecimal) o).multiply(new BigDecimal(1000)).setScale(2, BigDecimal.ROUND_HALF_UP);
                                    declaredField.set(t, bigDecimal);
                                }
                                if (unitConvertType.equals(UnitConvertType.B)) {
                                    BigDecimal bigDecimal = ((BigDecimal) o).divide(new BigDecimal(10000)).setScale(2, BigDecimal.ROUND_HALF_UP);
                                    declaredField.set(t, bigDecimal);
                                }
                                if (unitConvertType.equals(UnitConvertType.R)) {
                                    BigDecimal bigDecimal = ((BigDecimal) o).setScale(2, BigDecimal.ROUND_HALF_UP);
                                    declaredField.set(t, bigDecimal);
                                }
                            }
                        } catch (Exception ex) {
                            log.error("处理失败");
                        }
                }
            }
        }

写个调用示例看看效果：

public static void main(String[] args) {
            
            List<MyYearSumReportDTO> yearsList = getMyYearSumReportList();
            unitAnnotateConvert(yearsList);
            System.out.println("通过注解标识的自动转换玩法："+yearsList.toString());
        }
        
        private static List<MyYearSumReportDTO> getMyYearSumReportList() {
            MyYearSumReportDTO mySumReportDTO = new MyYearSumReportDTO();
            mySumReportDTO.setPayTotalAmount(new BigDecimal(1100000));
            mySumReportDTO.setJcAmountPercentage(BigDecimal.valueOf(0.695));
            mySumReportDTO.setJcCountPermillage(BigDecimal.valueOf(0.7894));
            mySumReportDTO.setLength(BigDecimal.valueOf(1300.65112));
            mySumReportDTO.setWidth(BigDecimal.valueOf(6522.12344));
            MyYearSumReportDTO mySumReportDTO1 = new MyYearSumReportDTO();
            mySumReportDTO1.setPayTotalAmount(new BigDecimal(2390000));
            mySumReportDTO1.setJcAmountPercentage(BigDecimal.valueOf(0.885));
            mySumReportDTO1.setJcCountPermillage(BigDecimal.valueOf(0.2394));
            mySumReportDTO1.setLength(BigDecimal.valueOf(1700.64003));
            mySumReportDTO1.setWidth(BigDecimal.valueOf(7522.12344));
            
            List<MyYearSumReportDTO> list = new ArrayList<>();
            list.add(mySumReportDTO);
            list.add(mySumReportDTO1);
            return list;
        }

效果也是很OK：  
![5a3ce77d7db44d578ee59b21a09a9beb.png][]

> 抛砖引玉，传递‘玩’代码思想，学编程，哎我就是玩。

好了，该篇就到这。

[25b5ddddbc5046d5a7598e2ef730f64c.png]: https://img-blog.csdnimg.cn/25b5ddddbc5046d5a7598e2ef730f64c.png
[a14591736c04455bb6c25a933f7adfeb.png]: https://img-blog.csdnimg.cn/a14591736c04455bb6c25a933f7adfeb.png
[8d3c0fd1646c4befab98c3599268a2e1.png]: https://img-blog.csdnimg.cn/8d3c0fd1646c4befab98c3599268a2e1.png
[37f1648ed4bb4a6e9fa8f9f526712951.png]: https://img-blog.csdnimg.cn/37f1648ed4bb4a6e9fa8f9f526712951.png
[ff5ddf2745b64b3a9882ebcea20b1157.png]: https://img-blog.csdnimg.cn/ff5ddf2745b64b3a9882ebcea20b1157.png
[c4ee715fbec34ec7a744902412f13844.png]: https://img-blog.csdnimg.cn/c4ee715fbec34ec7a744902412f13844.png
[9857e3da2ef84de3b69514129e6e9c6e.png]: https://img-blog.csdnimg.cn/9857e3da2ef84de3b69514129e6e9c6e.png
[236a674b3903449f84e8f1557489c108.png]: https://img-blog.csdnimg.cn/236a674b3903449f84e8f1557489c108.png
[5a3ce77d7db44d578ee59b21a09a9beb.png]: https://img-blog.csdnimg.cn/5a3ce77d7db44d578ee59b21a09a9beb.png