dadiyang / equator

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

属性比对器

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

原理

使用反射得到两个对象的属性(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 方法，如果你需要对某些特殊属性进行特殊的比对，则可以覆盖此方法

结构图

equator's Issues

typo in pom hamcrest-core scope

equator/pom.xml

Line 49 in 270b50c

<scope>tests</scope>

scope for org.hamcrest:hamcrest-core should be test rather than tests.

GetterBaseEquator getDiffFields 第二个val是null

Equator equator = new GetterBaseEquator();
List diff = equator.getDiffFields(house1, house2);

比较两个对象后，第二个对象的val设置是null，不是对象里的值

equator.getDiffFields

java.lang.IllegalArgumentException: object is not an instance of declaring class

是否可以考虑加 排除某些属性的方法？

是否可以考虑加 排除某些属性的方法？

比如User对象里都有id这个属性
一个是我数据库查出来的 带有id的值
另一个是我构造器出来的没有id的值
我只想对比除了id以外的其他属性值是否相等