【免费】Bo字段转换

### Bo字段转换
字段转换使用的是hutool的BeanUtil#copyProperties，有兴趣的可以看一下它的源码。他会尽可能的忽略字段类型。例如：dto有一个id字段，类型是Long；bo有一个id字段，类型是String，它也会进行转换。
但是这里就涉及到一些需求：枚举类字段的转换、忽略字段的转换、字段加密（脱敏）。
#### 注解
提供转换注解，主要用于dto转换bo时的字段转换。
位于**com.lframework.starter.web.core.annotations.convert**包下。

##### 枚举类字段的转换
在bo的相应字段打上==@EnumConvert==注解。

```java
  /**
   * 地址类型
   */
  @ApiModelProperty("地址类型")
  @EnumConvert
  private Integer addressType;
```

==注意：这里需要dto的这个字段的类型是BaseEnum类型。==

#### 忽略字段的转换
有两种方式：注解方式、编码方式。
#### 注解方式
在bo的相应字段打上==@IgnoreConvert==注解。

```java
  /**
   * 地址类型
   */
  @ApiModelProperty("地址类型")
  @IgnoreConvert
  private Integer addressType;
```
#### 编码方式

在Bo类中重写convert方法。

```java
@Data
public class CustomerSettleCheckBizItemBo extends BaseBo<CustomerSettleCheckBizItemDto> {
    // ...省略字段

public CustomerSettleCheckBizItemBo() {

}

public CustomerSettleCheckBizItemBo(CustomerSettleCheckBizItemDto dto) {

super(dto);
    }

@Override
    public <A> BaseBo<CustomerSettleCheckBizItemDto> convert(CustomerSettleCheckBizItemDto dto) {

// 这里就是将bizType和calcType忽略转换
        return super.convert(dto, CustomerSettleCheckBizItemBo::getBizType,
            CustomerSettleCheckBizItemBo::getCalcType);
    }

@Override
    protected void afterInit(CustomerSettleCheckBizItemDto dto) {

// 这里再手动赋值
        this.bizType = dto.getBizType().getCode();
        this.calcType = dto.getCalcType().getCode();
    }
}
```

##### 字段加密（脱敏）
这里的加密指的是：将字段值的部分字符变成星号。
在bo的相应字段打上==@EncryptConvert==注解。

```java
  /**
   * API密钥
   */
  @ApiModelProperty("API密钥")
  @EncryptConvert
  private String apiSecret;
```
@EncryptConvert注解有一个属性：type，默认值是EncryType.AUTO。

EncryType的定义：

```java
public enum EncryType {
  // 自动
  AUTO,
  // 密码
  PASSWORD,
  //中文名
  CHINESE_NAME,
  //身份证号
  ID_CARD,
  //座机号
  FIXED_PHONE,
  //手机号
  MOBILE_PHONE,
  //电子邮件
  EMAIL,
  //中国大陆车牌，包含普通车辆、新能源车辆
  CAR_LICENSE,
  //银行卡
  BANK_CARD
}
```
除AUTO以外，其他类型是使用hutool的DesensitizedUtil工具类进行加密。
AUTO的规则是：将字符串的中间部分变成*。

```java
public static String autoEncrypt(CharSequence str) {
    if (StringUtil.isEmpty(str)) {
      return StringPool.ENCRYPT_STR;
    }

int len = str.length();
    int sub = len >> 1;
    if (sub <= 0) {
      return StringPool.ENCRYPT_STR;
    }

int sub2 = sub >> 1;
    if (sub2 <= 0) {
      // 字符串的length要么是2 要么是3
      return StringUtil.hide(str, 1, 2);
    }

return StringUtil.hide(str, sub - sub2, sub - sub2 + sub);
}
```