/equator

一个用于比较两个对象的所有属性是否全部相等,并且可以获取所有不相等的属性的比对器

Primary LanguageJavaApache License 2.0Apache-2.0

属性比对器

一个用于比较两个对象的属性是否相等,并且可以获取所有不相等的属性的比对器

原理

使用反射得到两个对象的属性(field或者getter方法),比对该属性的值

注意事项

  1. 如果有一个对象为空,则认为该对象的所有属性都为空
  2. 基于getter方法的对比器,会忽略 getClass() 方法
  3. 属性比对默认使用 Objects.deepEquals 方法进行比对,如果是集合类,会转换为数组进行对比
  4. 支持比对两个不同类型的对象,默认只比对两个类字段的交集,即两个类都有的字段才比对,可以设置 bothExistFieldOnly 配置,字段不存在和 null 视为相等

使用

加入依赖

加入 maven 依赖

<dependency>
    <groupId>com.github.dadiyang</groupId>
    <artifactId>equator</artifactId>
    <version>1.0.4</version>
</dependency>

或者下载 equator-1.0.4.jar ,并添加到 classpath 下。

调用方法

这里提供了GetterBaseEquator和FieldBaseEquator两个实现类,分别对应基于getter方法和基于属性的比对器,可以根据自己的需要进行选择

Equator equator = new GetterBaseEquator();
// 支持比对两个不同类型的对象,默认只比对两个类字段的交集,即两个类都有的字段才比对
User user1 = new User(...);
UserDTO user2 = new UserDTO(...);

// 判断属性是否完全相等
equator.isEquals(user1, user2);

// 获取不同的属性
List<FieldInfo> diff = equator.getDiffFields(user1, user2);

扩展

AbstractEquator中定义了 isFieldEquals 方法,如果你需要对某些特殊属性进行特殊的比对,则可以覆盖此方法

结构图

结构图