脱敏工具类和反脱敏组件使用指南

版本	新特性	日期
V0.0.8-SNAPSHOT	1、脱敏格式可根据区域进行配置；2、对登记序号为空提供支持；	xxx-xx-xx
V0.0.8-SNAPSHOT	1、新增注入@Service方式进行脱敏；2、将配置收入application-main.properties中，提供默认实现，需自定义的需自己修改配置；3、对脱敏入参进行判空，任意空则返回原文；	xxx-xx-xx
V0.0.8-SNAPSHOT	1、解决Base64特殊字符解密错误问题；2、支持多入参；3、支持GET方式；	xxx-xx-xx

最新版本为 V0.0.8-SNAPSHOT + V0.0.2-SNAPSHOT，暂时不会再升级版本，待测试通过发布1.0.0版本

脱敏工具类使用三板斧

1、引入pom依赖

   <!-- 反脱敏组件 -->
   <dependency>   
       <groupId>cn.com.xxx.xxx.revdesensitize</groupId>   
       <artifactId>BondeReverseDesensitize</artifactId>  
       <version>0.0.8-SNAPSHOT</version>
   </dependency> 

2、定义脫敏开发及加密key配置
配置文件application-main.properties中定义

#脫敏配置
desensite.open=yes
desensite.encryptKey=fixedDateNeedChangeEncryptKey

#脱敏格式
##固话，默认显示后四，范例：*******6666
desensite.formate.fixedphone.position.start=3
desensite.formate.fixedphone.position.end=4
#银行卡，默认显示前六后四，范例：622848******4568
desensite.formate.bankcrd.position.start=6
desensite.formate.bankcrd.position.end=4
#手机，默认显示前三后四，范例：189****3684
desensite.formate.mobile.position.start=3
desensite.formate.mobile.position.end=4
#身份证号码，默认显示前六后四，范例：330601********2015
desensite.formate.ctfnbr.position.start=6
desensite.formate.ctfnbr.position.end=4

desensite.open只有为no时候才不会进行脱敏返回原文，默认为yes自动进行脱敏；

脱敏格式，业务团队需自定义需要在自己配置到application-main.properties中（本地或者nacos都支持）；

3、调用脱敏工具类或者服务
为支持Nacos配置方式，提供注入@Service方式进行脱敏，推进优先使用该方式；

@Autowired
DesensiteService desensiteService;


logger.info("======service注入方式=======");
logger.info("手机脱敏后:{}", desensiteService.desensitize("18906712121","101010110101011010101", DesensiteConstant.TYPE_MOBILE));
logger.info("固话脱敏后:{}",desensiteService.desensitize("057136648878","101010110101011010101", DesensiteConstant.TYPE_FIX_PHONE));
logger.info("身份证脱敏后:{}",desensiteService.desensitize("330128199107356847","101010110101011010101", DesensiteConstant.TYPE_CTFNBR));
logger.info("银行卡号脱敏后:{}",desensiteService.desensitize("6228482462893085616","101010110101011010101", DesensiteConstant.TYPE_BANKCRD));

静态工具类调用方式：DesensiteUtil.desensitize(原字符串，登记序号，原字符串类型）

logger.info("手机脱敏后:{}", DesensiteUtil.desensitize("18906712121","1010101", DesensiteConstant.TYPE_MOBILE));
        logger.info("固话脱敏后:{}",DesensiteUtil.desensitize("057136648878","1010101", DesensiteConstant.TYPE_FIX_PHONE));
        logger.info("身份证脱敏后:{}",DesensiteUtil.desensitize("330128199107356847","1010101", DesensiteConstant.TYPE_CTFNBR));
        logger.info("银行卡号脱敏后:{}",DesensiteUtil.desensitize("6228482462893085616","1010101", DesensiteConstant.TYPE_BANKCRD));

反脱敏组件使用三板斧

1、引入pom依赖

   <!-- 反脱敏组件 -->
   <dependency>   
       <groupId>cn.com.xxx.xxx.revdesensitize</groupId>   
       <artifactId>BondeReverseDesensitize</artifactId>  
       <version>0.0.8-SNAPSHOT</version>
   </dependency>
   <!-- 反脱敏关联数据 -->
   <dependency>
       <groupId>cn.com.xxx.xxx.revdesensitize</groupId>
       <artifactId>BondeRevDesensitizeNeedData</artifactId>
       <version>0.0.2-SNAPSHOT</version>
    </dependency>

由于登记序号需要从当前登录用户的纳税人信息中获取，所以需要再依赖BondeRevDesensitizeNeedData公共jar；

2、配置组件扫描包路径

@ComponentScan(basePackages = {"cn.com.xxx"})
或者
<context:component-scan base-package="cn.com.xxx" />

确保能正确加载到反脱敏组件的相关Bean；

3、添加注解直接使用
Controller的方法上直接添加@ReverseDesensitization即可；
示例：

   /**
     * 对象接收
     * @param params
     * @return
     */
    @PostMapping("/submitJson")
    @ReverseDesensitization
    public String submit(@RequestBody User params) {
        logger.info("反脱敏后:{}", JSON.toJSONString(params));
        return JSON.toJSONString(params);
    }

    /**
     * 接收纯字符
     * @param desnsiteStr
     * @return
     */
    @PostMapping("/submitString")
    @ReverseDesensitization
    public String submit(@RequestBody String desnsiteStr) {
        logger.info("反脱敏后:{}", desnsiteStr);
        return desnsiteStr;
    }