腳本之家服務器常用軟件

快捷導航

使用Springboot封裝一個自適配的數據單位轉換工具類

更新時間：2023年03月08日 10:03:20 作者：小目標青年

我們在接收前臺傳輸的數據時,往往SpringBoot使用內置的數據類型轉換器把我們提交的數據自動封裝成對象等類型,下面這篇文章主要給大家介紹了關于使用Springboot封裝一個自適配的數據單位轉換工具類的相關資料,需要的朋友可以參考下

前言

平時做一些統(tǒng)計數據，經常從數據庫或者是從接口獲取出來的數據，單位是跟業(yè)務需求不一致的。

比如，我們拿出來的分，實際上要是元

又比如，我們拿到的數據需要 乘以100 返回給前端做百分比展示

又比如，千分比轉換

又比如，拿出來的金額需要變成萬為單位

又比如，需要保留2位小數

......

等等等等。

平時我們怎么搞？

很多時候拿到的是一個數據集合list，就需要去遍歷然后根據每個DTO的屬性去做相關單位轉換。

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

就像這樣：

所以，如果通過反射自動匹配出來一些操作轉換，是不是就看代碼看起來舒服一點，人也輕松一點。

答案：是的

然后，我就搞了。

本篇內容簡要：

① 初步的封裝，通過map去標記需要轉換的類屬性字段

② 進一步的封裝，配合老朋友自定義注解搞事情

產品：

支付總金額換成萬為單位，方便運營統(tǒng)計；

那個什么計數，要是百分比的；

然后還有一個是千分比；

另外，還有2個要保留2位小數；

還有啊，那個。。。。。。

我：

別說了，喝口水吧。

拿到的數據都在這個DTO里面：

開始封裝：

① 初步的封裝，通過map去標記需要轉換的類屬性字段

思路玩法：

a.通過反射拿出字段

b.配合傳入的轉換標記Map 匹配哪些字段需要操作

c.然后從map取出相關字段的具體操作是什么，然后執(zhí)行轉換操作

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;
    }
}

代碼簡析：

看看怎么調用的：

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());
}

代碼簡析：

效果：

整個集合list的對應字段都自動轉換成功（轉換邏輯想怎么樣就自己在對應if里面調整、拓展）：

② 進一步的封裝，配合老朋友自定義注解搞事情

實說實話，第一步的封裝程度已經夠用了，就是傳map標識出來哪些需要轉換，對應轉換枚舉類型是什么。

其實我感覺是夠用的。

但是么，為了用起來更加方便，或者說更加地可拓展，那么配合自定義注解是更nice的。

開搞。

創(chuàng)建一個自定義注解，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;
}

然后針對配合我們的自定義，封一個轉換函數，反射獲取屬性字段，然后解析注解，然后做對應轉換操作。

代碼：

    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：