BeanUtils——JavaBean相互转换及字典翻译

JavaBean相互转换

在升级公司架构过程中，发现有大量Entity与DTO相互转换的问题，并且其中还伴随DTO中的数据字典翻译，所以特意写个工具类，主要利用spring提供的BeanUtils工具类，用redis翻译字典

其中功能包括：

• 翻译JavaBean中带有@CacheFormat的属性

   /**
    * 翻译当前类中需要翻译的字典值
    *
    * @param source 待翻译的对象
    */
   public static <T> void dataFormatter(T source) {     //判断原对象是否为null
       Assert.notNull(source, "待翻译的原对象不能为null");     //获取所有属性并翻译字典
       Field[] declaredFields = source.getClass().getDeclaredFields();     //翻译字典：找出所有含有@CacheFormatter的属性
       Stream<Field> fieldStream = Arrays.stream(declaredFields)             //排除没有注解@CacheFormatter的字段
               .filter(field -> field.isAnnotationPresent(CacheFormat.class));     //翻译
       doFormatter(fieldStream, source, source.getClass());
   }

• 翻译List

   /**
    * 翻译当前集合类中需要翻译的字典值
    *
    * @param sources 待翻译的集合对象
    */
   public static <T> void dataFormatter(List<T> sources) {     //当翻译的集合为空时,返回空的集合
       if (sources == null || sources.isEmpty()) {         return;
       }
  
       Class targetClass = sources.get(0).getClass();     //获取所有属性并翻译字典
       Field[] declaredFields = targetClass.getDeclaredFields();     //翻译字典：找出所有含有@CacheFormat的属性集合
       List<Field> formatterFields = Arrays.stream(declaredFields)             //排除没有注解@CacheFormat的字段
               .filter(field -> field.isAnnotationPresent(CacheFormat.class))
             .collect(Collectors.toList());     //循环列表（并行操作）
       sources.parallelStream().forEach(target -> {         //翻译
           doFormatter(formatterFields.stream(), target, targetClass);
       });
  }

• Entity 与DTO互转

  /**
   * 把原对象转换成目标类的对象，并翻译目标类的属性字典
   * 只针对目标类没有范型或者范型与原对象一样
   * @param source      原对象
   * @param targetClass 目标类
   * @return 目标对象
   */public static <T> T dataConvert(Object source, Class<T> targetClass) {
  
      Assert.isTrue(source != null && targetClass != null, "原对象或目标class不能为null");
  
      T target = BeanUtils.instantiateClass(targetClass);    //把目标对象的属性设置成原对象中对应的属性
      BeanUtils.copyProperties(source, target);
  
      dataFormatter(target);    return target;
  }/**
   * 实体属性互转
   *
   * @param source 原对象
   * @param target 目标对象
   * @return 目标对象
   */public static <T> T dataObjConvert(Object source, T target) {
  
      Assert.isTrue(source != null && target != null, "待转换的原对象或目标对象不能为null");    //转换
      BeanUtils.copyProperties(source, target);    //翻译
      dataFormatter(target);    return target;
  }

• List

  /**
   * 批量把原对象转换成目标对象，并翻译目标对象的属性字典
   * 如果想返回指定类型的集合即List的子类,参考{@link  HyBeanUtils#dataConverts2}
   *
   * @param sources     原对象集合
   * @param targetClass 目标对象的类
   * @return 返回转换后的目标集合
   */public static <T, E> List<T> dataConverts(List<E> sources, Class<T> targetClass) {
  
      Assert.notNull(targetClass, "转换的目标Class不能为null");    //当翻译的集合为空时,返回空的集合
      if (sources == null || sources.isEmpty()) {
          List<T> targetList = new ArrayList<>();        return targetList;
      }    //获取原集合的类型
      Class<? extends List> aClass = sources.getClass();    //目标集合
      List<T> targetList = BeanUtils.instantiateClass(aClass);    //把目标对象的属性设置成原对象中对应的属性（并行操作）
      sources.parallelStream().forEach(item -> {
          T target = BeanUtils.instantiateClass(targetClass);
          BeanUtils.copyProperties(item, target);
          targetList.add(target);
      });    //翻译字典
      dataFormatter(targetList);    return targetList;
   }

• 这个是List转换的升级版 T

  /**
   * 返回指定类型的方法,这里的类型必须是List的子类
   * 批量把原对象转换成目标对象，并翻译目标对象的属性字典,
   *
   * @param sources     原对象集合
   * @param targetClass 目标对象的类
   * @param returnType  返回值类型
   * @return 返回转换后的目标集合
   */public static <T, E, R extends List<T>> R dataConverts2(List<E> sources, Class<T> targetClass, Class<R> returnType) {
  
      Assert.notNull(targetClass, "转换的目标Class不能为null");
      Assert.notNull(returnType, "返回值类型Class不能为null");    //当翻译的集合为空时,返回空的集合
      if (sources == null || sources.isEmpty()) {        return null;
      }    //目标集合
      R targetList = BeanUtils.instantiateClass(returnType);    //把目标对象的属性设置成原对象中对应的属性（并行操作）
      sources.parallelStream().forEach(item -> {
          T target = BeanUtils.instantiateClass(targetClass);
          BeanUtils.copyProperties(item, target);
          targetList.add(target);
      });    //翻译字典
      dataFormatter(targetList);    return targetList;
  }

• 上述所用到的公共方法

  /**
   * 对目标类需要翻译的字段进行翻译
   *
   * @param stream
   * @param target      目标对象
   * @param targetClass 目标对象类
   */private static <T> void doFormatter(Stream<Field> stream, Object target, Class<T> targetClass) {    //排除目标对象中字段值为null的字段
      stream.filter(field -> {
          PropertyDescriptor propertyDescriptor = BeanUtils.getPropertyDescriptor(targetClass, field.getName());        Object invoke = null;        try {
              invoke = propertyDescriptor.getReadMethod().invoke(target, new Object[]{});
          } catch (IllegalAccessException e) {
              logger.warn("待翻译的字段的get是无法访问的", e);
          } catch (InvocationTargetException e) {
              logger.warn("调用待翻译的字段的get方法时报错", e);
          } catch (Exception e) {
              logger.warn("确保属性有get,set方法", e);
          }        return invoke != null;        //遍历需要翻译的字段
      }).forEach(field -> {
          CacheFormat annotation = field.getAnnotation(CacheFormat.class);        //缓存系统编号，如果不指定则默认为当前系统编号
          String systemCode = "system_code";        if (StringUtils.isNotBlank(annotation.systemCode())) {
              systemCode = annotation.systemCode();
          }        //缓存key，如果不指定，则默认为字段名称
          String key = annotation.key();        if (StringUtils.isBlank(key)) {
              key = field.getName();
          }        //判断注解@CacheFormatter是否指定把字典翻译到另一个字段上
          String formatterField = annotation.destination();        if (StringUtils.isBlank(formatterField)) {            //当注解中不指定其他字段时，默认翻译到加注解的属性上
              formatterField = field.getName();
          }        try {
              PropertyDescriptor orginPropertyDescriptor = BeanUtils.getPropertyDescriptor(targetClass, field.getName());            Object value = orginPropertyDescriptor.getReadMethod().invoke(target, new Object[]{});            //设置目标字段值
              PropertyDescriptor propertyDescriptor = BeanUtils.getPropertyDescriptor(targetClass, formatterField);            //取缓存
              String cacheValue = RedisUtils.hget(systemCode +":valueset:" + key, value + "");            //如果数据字典中查询不到,则取业务缓存中取
              if (StringUtils.isBlank(cacheValue)) {
                  cacheValue = RedisUtils.hget(systemCode + ":valueset:" + key, value + "");
              }
  
              Assert.hasLength(cacheValue, "在缓存" + key + "中没有找到" + value + "对应的缓存");            //设置缓存值到属性字段中
              propertyDescriptor.getWriteMethod().invoke(target, cacheValue);
  
          } catch (IllegalAccessException e) {
              logger.warn("待翻译的字段的set是无法访问的", e);
          } catch (InvocationTargetException e) {
              logger.warn("调用待翻译的字段的set方法时报错", e);
          } catch (Exception e) {
              e.printStackTrace();
              logger.warn("调用待翻译的字段的set方法时报错,推测类型不匹配", e);
          }
      });
  
  }

• 注解 CacheFormat

  @Target(ElementType.FIELD)
  @Retention(RetentionPolicy.RUNTIME)
  @Documentedpublic @interface CacheFormat {  /**
     *  缓存key
     * @return
     */
    String key();  /**
     * 指定翻译值存放字段, 例如:userType的翻译结果放到userTypeName上
     * @return
     */
    String destination() default "";  /**
     * 系统编号
     * @return
     */
    String systemCode() default "";

注意：该翻译只关注第一层即当前对象的属性，并不会递归翻译

比如：当前类有一个属性为对象实例，该对象也有被@CacheFormat注解的属性

这时该工具类不会去翻译这个属性中的属性，需要开发者先用当前工具类转换该属性

然后再设置到目标类中

原文出处：https://www.cnblogs.com/liruiloveparents/p/9378661.html