com.github.dadiyang:equator

Sonatype helps open source projects to set up Maven repositories on https://oss.sonatype.org/

License

License

GroupId

GroupId

com.github.dadiyang
ArtifactId

ArtifactId

equator
Last Version

Last Version

1.0.4
Release Date

Release Date

Type

Type

jar
Description

Description

Sonatype helps open source projects to set up Maven repositories on https://oss.sonatype.org/
Source Code Management

Source Code Management

https://github.com/dadiyang/equator

Download equator

How to add to project

<!-- https://jarcasting.com/artifacts/com.github.dadiyang/equator/ -->
<dependency>
    <groupId>com.github.dadiyang</groupId>
    <artifactId>equator</artifactId>
    <version>1.0.4</version>
</dependency>
// https://jarcasting.com/artifacts/com.github.dadiyang/equator/
implementation 'com.github.dadiyang:equator:1.0.4'
// https://jarcasting.com/artifacts/com.github.dadiyang/equator/
implementation ("com.github.dadiyang:equator:1.0.4")
'com.github.dadiyang:equator:jar:1.0.4'
<dependency org="com.github.dadiyang" name="equator" rev="1.0.4">
  <artifact name="equator" type="jar" />
</dependency>
@Grapes(
@Grab(group='com.github.dadiyang', module='equator', version='1.0.4')
)
libraryDependencies += "com.github.dadiyang" % "equator" % "1.0.4"
[com.github.dadiyang/equator "1.0.4"]

Dependencies

test (1)

Group / Artifact Type Version
junit : junit jar 4.12

Project Modules

There are no modules declared in this project.

属性比对器

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

原理

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

结构图

结构图

Versions

Version
1.0.4
1.0.3
1.0.2
1.0.1
1.0.0