<!-- Hutool工具包 -->    
<dependency>
        <groupId>cn.hutool</groupId>
        <artifactId>hutool-all</artifactId>
        <version>5.8.25</version>
    </dependency>
    <!-- Jackson依賴 -->
    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-databind</artifactId>
        <version>2.9.2</version>
    </dependency>

/**
 * 用于標(biāo)記字段需要進行脫敏處理的注解
 *
 * @author shijun
 * @date 2024/07/09
 */
@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.FIELD)
@JacksonAnnotationsInside
@JsonSerialize(using = DesensitizeSerializer.class)
public @interface Desensitize {

    /**
     * 脫敏類型
     */
    DesensitizeType type() default DesensitizeType.DEFAULT;

    /**
     * 脫敏起始位置
     */
    int startInclude() default 0;

    /**
     * 脫敏結(jié)束位置
     */
    int endExclude() default 0;
    
}

/**
 * 脫敏類型枚舉類
 */
public enum DesensitizeType {

    /**
     * 默認(rèn)脫敏
     */
    DEFAULT,
    /**
     * 自定義脫敏
     */
    CUSTOM_RULE,
    /**
     * 手機號脫敏
     */
    PHONE,
    /**
     * 電子郵件脫敏
     */
    EMAIL,
    /**
     * 身份證號脫敏
     */
    ID_CARD,
    /**
     * 銀行卡號脫敏
     */
    BANK_CARD,
    /**
     * 地址脫敏
     */
    ADDRESS,
    /**
     * 中文姓名脫敏
     */
    CHINESE_NAME,
    /**
     * 密碼脫敏
     */
    PASSWORD,
}

/**
 * 脫敏序列化器，用于在序列化字符串時根據(jù)不同的脫敏類型進行數(shù)據(jù)脫敏。
 *
 * @author shijun
 * @date 2024/07/08
 */
public class DesensitizeSerializer extends JsonSerializer<String> implements ContextualSerializer {

    /**
     * 脫敏類型，默認(rèn)為DEFAULT
     */
    private DesensitizeType type;
    /**
     * 脫敏起始位置
     */
    private int startInclude;
    /**
     * 脫敏結(jié)束位置
     */
    private int endExclude;

    public DesensitizeSerializer() {
        this.type = DesensitizeType.DEFAULT;
    }


    public DesensitizeSerializer(DesensitizeType type) {
        this.type = type;
    }

    /**
     * 序列化字符串時調(diào)用，根據(jù)脫敏類型對字符串進行相應(yīng)的脫敏處理。
     *
     * @param value       待序列化的字符串
     * @param gen         JSON生成器，用于寫入處理后的字符串
     * @param serializers 序列化器提供者，用于獲取其他序列化器
     * @throws IOException 如果序列化過程中發(fā)生I/O錯誤
     */
    @Override
    public void serialize(String value, JsonGenerator gen, SerializerProvider serializers) throws IOException {
        switch (type) {
            case CUSTOM_RULE:
                // 這里是對字符串的startInclude到endExclude字段進行隱藏處理，如果想要實現(xiàn)兩端保留，可以考慮使用StrUtil的replace方法
                gen.writeString(StrUtil.hide(value, startInclude, endExclude));
                break;
            case PHONE:
                gen.writeString(DesensitizedUtil.mobilePhone(value));
                break;
            case EMAIL:
                gen.writeString(DesensitizedUtil.email(value));
                break;
            case ID_CARD:
                gen.writeString(DesensitizedUtil.idCardNum(value, 1, 2));
                break;
            case BANK_CARD:
                gen.writeString(DesensitizedUtil.bankCard(value));
                break;
            case ADDRESS:
                gen.writeString(DesensitizedUtil.address(value, 8));
                break;
            case CHINESE_NAME:
                gen.writeString(DesensitizedUtil.chineseName(value));
                break;
            case PASSWORD:
                gen.writeString(DesensitizedUtil.password(value));
                break;
            default:
                gen.writeString(value);
                break;
        }
    }

    /**
     * 根據(jù)上下文信息創(chuàng)建自定義的序列化器，用于處理帶有@Desensitize注解的屬性。
     *
     * @param prov     序列化器提供者，用于獲取其他序列化器
     * @param property 當(dāng)前屬性的信息，用于獲取注解和屬性類型
     * @return 自定義的序列化器實例
     */
    @Override
    public JsonSerializer<?> createContextual(SerializerProvider prov, BeanProperty property) {
        if (property != null) {
            Desensitize annotation = property.getAnnotation(Desensitize.class);
            if (annotation != null) {
                this.type = annotation.type();
                if (annotation.type() == DesensitizeType.CUSTOM_RULE) {
                    this.startInclude = annotation.startInclude();
                    this.endExclude = annotation.endExclude();
                }
            }
        }
        return this;
    }

}

@Data
public class UserDTO {

    /**
     * 用戶姓名
     */
    @Desensitize(type = DesensitizeType.CHINESE_NAME)
    private String name;

    /**
     * 用戶手機號
     */
    @Desensitize(type = DesensitizeType.PHONE)
    private String phoneNumber;

    /**
     * 用戶電子郵件地址
     */
    @Desensitize(type = DesensitizeType.EMAIL)
    private String email;

    /**
     * 用戶密碼
     */
    @Desensitize(type = DesensitizeType.PASSWORD)
    private String password;

    /**
     * 用戶身份證號碼
     */
    @Desensitize(type = DesensitizeType.ID_CARD)
    private String idCard;

    /**
     * 用戶銀行卡號
     */
    @Desensitize(type = DesensitizeType.BANK_CARD)
    private String bankCard;

    /**
     * 用戶地址
     */
    @Desensitize(type = DesensitizeType.ADDRESS)
    private String address;

    /**
     * 游戲名稱
     */
    @Desensitize(type = DesensitizeType.CUSTOM_RULE, startInclude = 2, endExclude = 6)
    private String gameName;
}

@RestController
@RequestMapping("/test")
public class TestController {
    
    @GetMapping("/desensitize")
    public UserDTO getUser() {
        UserDTO userDTO = new UserDTO();
        userDTO.setName("孫大圣");
        userDTO.setEmail("shijun@163.com");
        userDTO.setPhoneNumber("12345678901");
        userDTO.setPassword("123456");
        userDTO.setAddress("遼寧省盤錦市興隆臺區(qū)紅村鄉(xiāng)441號");
        userDTO.setIdCard("447465200912089605");
        userDTO.setBankCard("6217000000000000000");
        userDTO.setGameName("超級無敵大鐵錘");
        return userDTO;
    }

}