DDD中Diff的应用(JAVERS)的封装_weihubeats的博客

Github

构造diff

如果我们要比较两个对象，我们需要先构建一个比较器出来，即 diff
构造方式如下:
Javers javers = JaversBuilder.javers()
          .withListCompareAlgorithm(LEVENSHTEIN_DISTANCE)
          .build();
这里需要注意的是 List comparing algorithms这个参数，即比较算法，官方推荐使用的是LEVENSHTEIN_DISTANCE.通过看源码我们可以看到有如下三种比较器
  
Levenshtein: 是最智能的比较算法，一般推荐使用。但是需要注意的是如果比较元素超过300个以上效率就会变得很慢
Simple：主要优点是速度快，计算复杂度线性，主要缺点是输出过于冗长
Set: 如果您不关心集合的顺序，请选择 Set 算法。在进行比较之前，JaVers 会将所有 list 转换为 set。此算法产生最简洁的输出(只有 ValueAdded 和 ValueRemoved) 
 这里虽然有三种，但是我们最为常用的还是Levenshtein 
这里我们用一个例子测试看看 
Student.class 
@Data
@ToString
public class Student {
    private int id;
    private String name;
    private int age;
    List<Teacher> teachers;
    public Student(int id, String name, int age) {
        this.id = id;
        this.name = name;
        this.age = age;
 这里需要注意的是Studetn.class 中有一个 @Id注解，如果没有id，就没法区分对象比对的时候是否为新增对象了，只能比对出是修改和删除，即使我们想要比较出的是新增，实际也比较不出。所以这里需要注意，所以如果我们在新增对象比较的时候，如果没有id，框架又会报错，所以新增的对象我们可以给他一个随机的负数id 
Teacher.class 
@Data
public class Teacher {
    private String name;
    private String age;
@Test
    public void changeTest() {
        Javers javers = JaversBuilder.javers().withListCompareAlgorithm(LEVENSHTEIN_DISTANCE).build();
        Student old = new Student(1, "韩信", 22);
        Teacher teacher = new Teacher();
        teacher.setName("韩信的老师");
        teacher.setAge("33");
        old.setTeachers(Lists.newArrayList(teacher));
        Student newObj = new Student(1, "阿离", 32);
        Teacher teacher1 = new Teacher();
        teacher1.setName("阿离的老师");
        teacher1.setAge("44");
        newObj.setTeachers(Lists.newArrayList(teacher1));
        Diff diff = javers.compare(old, newObj);
        System.out.println(diff.prettyPrint());
        Changes changes = diff.getChanges();
        for (Change change : changes) {
            if ((change instanceof NewObject)) {
                System.out.println("新增改动: " + change);
//                change.getAffectedObject().ifPresent(System.out::println);
                System.out.println("新增");
            if ((change instanceof ObjectRemoved)) {
                System.out.println("删除改动: " + change);
//                change.getAffectedObject().ifPresent(System.out::println);
            if ((change instanceof ValueChange)) {
                System.out.println("修改改动: " + change);
//                change.getAffectedObject().ifPresent(System.out::println);

 可以看到我们拿到了所有的变化值 
这里我们改变的对象一边有如下三种 
NewObject 新增
ObjectRemoved 删除
PropertyChange 修改 
其中PropertyChange又细分为： 
ContainerChange 集合修改
MapChange map修改
ReferenceChange 实体引用修改
ValueChange 普通值的修改 
我们将上面的代码作一行改动 
        Diff diff = javers.compare(old, null);
运行结果:
  
对于集合的比对，我们一般使用 
javers.compareCollections()
@Test
    public void compareCollections() {
        Javers javers = JaversBuilder.javers().withListCompareAlgorithm(LEVENSHTEIN_DISTANCE).build()




    
;
        Student old = new Student(1, "韩信", 22);
        Teacher teacher = new Teacher();
        teacher.setName("韩信的老师");
        teacher.setAge("33");
        old.setTeachers(Lists.newArrayList(teacher));
        Student newObj = new Student(1, "阿离", 32);
        Teacher teacher1 = new Teacher();
        teacher1.setName("阿离的老师");
        teacher1.setAge("44");
        newObj.setTeachers(Lists.newArrayList(teacher1));
        Student newObj2 = new Student(2, "奏", 18);
        Teacher teacher2 = new Teacher();
        teacher2.setName("奏的老师");
        teacher2.setAge("22");
        newObj2.setTeachers(Lists.newArrayList(teacher2));
        Diff diff = javers.compareCollections(Lists.newArrayList(old),
                Lists.newArrayList(newObj, newObj2), Student.class);
        System.out.println(diff.prettyPrint());
        Changes changes = diff.getChanges();
        for (Change change : changes) {
            if ((change instanceof NewObject)) {
                System.out.println("新增改动: " + change);
//                change.getAffectedObject().ifPresent(System.out::println);
            if ((change instanceof ObjectRemoved)) {
                System.out.println("删除改动: " + change);
//                change.getAffectedObject().ifPresent(System.out::println);
            if ((change instanceof ValueChange)) {
                System.out.println("修改改动: " + change);
//                change.getAffectedObject().ifPresent(System.out::println);
有了上面的这些方法，我们就可以基于上面的改动对我们聚合根CRUD的一些封装。 
封装CRUD
 
public <T> void objectChangeFunction(Consumer<T> addConsume,
                                         Consumer<T> updateConsume,
                                         Consumer<T> deleteConsume,
                                         Class<T> clazz) {
        Changes changes = this.diff.getChanges();
        for (Change change : changes) {
            if ((change instanceof NewObject && Objects.nonNull(addConsume))) {
                change.getAffectedObject().ifPresent(item -> addConsume.accept((T) item));
                return;
            if ((change instanceof ObjectRemoved && Objects.nonNull(deleteConsume))) {
                change.getAffectedObject().ifPresent(item -> deleteConsume.accept((T) item));
                return;
            if ((change instanceof ValueChange && Objects.nonNull(updateConsume))) {
                change.getAffectedObject().ifPresent(item -> updateConsume.accept((T) item));
                return;
使用也非常简单 
Diff plutusDiff = javers.compare(old, new);
objectChangeFunction(add -> qualityCheckDAO.saveStudent(student),
                update -> qualityCheckDAO.updateStudent(student),
                null, Student.class);
 这里我们主要是介绍JAVERS的基本使用，所以对封装成为工具类这一块就不作过多说明，自己可以基于JAVERS去为自己项目作一些工具类的封装 
自定义比较器
 
有时候我们需要自定义一些字段类型的比较器，JAVERS也提供了扩展接口,只需要CustomValueComparator接口即可
 这里我们自定义一个BigDecimal比较器,来控制比较的小数位数 
public class CustomBigDecimalComparator implements CustomValueComparator<BigDecimal> {
    private int significantDecimalPlaces;
    public CustomBigDecimalComparator(int significantDecimalPlaces) {
        this.significantDecimalPlaces = significantDecimalPlaces;
    @Override
    public boolean equals(BigDecimal a, BigDecimal b) {
        return round(a).equals(round(b));
    @Override
    public String toString(BigDecimal value) {
        return round(value).toString();
    private BigDecimal round(BigDecimal val) {
        return val.setScale(significantDecimalPlaces, RoundingMode.HALF_DOWN);
@Test
    public void test() {
        Javers javers = JaversBuilder.javers()
                .registerValue(BigDecimal.class,
                        new CustomBigDecimalComparator(2)).build();
        int size = javers.compare(new ValueObject(new BigDecimal("1.123")),
                new ValueObject(new BigDecimal("1.124"))).getChanges().size();
        System.out.println(size == 0);
    static class ValueObject {
        BigDecimal value;
        List<BigDecimal> values;
        public ValueObject(BigDecimal value) {
            this.value = value;
 这里的CustomValueComparator的设计有点类似于Mybatis的类型转换Handler。javaer还可以自定义属性比较器,实现接口CustomPropertyComparator即可，这里感兴趣自己去了解，就不做过多讲解 
JAVERS提供的一些注解总共有如下几种 
@Entity
 
将给定的类(及其所有子类)声明为 Entity 类型 
@ValueObject
 
将给定的类(及其所有子类)声明为 Value Object 类型。 
@Value
 
@DiffIgnore
 
@ShallowReference
 
@IgnoreDeclaredProperties
 
@TypeName
 
声明一个实体的 id 属性,没有id无法比对出是否为新增对象 
@DiffIgnore
 
比对时可以忽略的属性 
@DiffInclude
 
@ShallowReference
 
声明一个属性为浅引用。只能用于实体类型属性。目标 Entity 实例的所有属性(Id 除外)都被忽略。 
@PropertyName
 
 官网提供了这么多注解，实际我也没用过这么多，用的比较多的还是@Id和`@DiffIgnore，限于篇幅，就不作过多解释，在实际中需要使用时可参考官方文档 
                                    Javers
在开发过程中遇到需求，比较数据库中的原数据与新修改要写入库中的数据。这个实体类是比较复杂的。例如有基本类型，BigDecimal类型，自定义类型，Date类型，List集合，Set集合，Map集合等。在比较复杂的类的情况下，使用Objects的equals是不适用的。所以为了解决这个问题，可以使用Javers库中的compare方法来解决该问题
 <!-- https://mvnrepository.com/artifact/org.javers/javers-core --&gt
什么是JaVers
 JaVers是用于审核数据更改的轻量级Java库。
 我们都使用版本控制系统作为源代码，那么为什么不使用专门的框架来提供Java对象（实体，POJO，数据对象）的审核跟踪呢？
查看我们的网站
您可以在找到有关JaVers项目的最新信息。 查看我们的页面。
构建并测试JaVers
 克隆我们的github仓库
git clone https://github.com/javers/javers.git
cd javers
编译JaVers并运行单元测试
./gradlew build
运行环境自检，以检查JaVers是否与您的JDK版本兼容
./gradlew javers-core:run
问题与贡献
我们很乐意为您提供问题和贡献！
 您可以报告错误或功能请求。 应该在提问。 我们会回答他们。 在创建问题之前，请阅读我们
                                    在开发过程中遇到需求，比较数据库中的原数据与新修改要写入库中的数据。这个实体类是比较复杂的。例如有基本类型，BigDecimal类型，自定义类型，Date类型，List集合，Set集合，Map集合等。在比较复杂的类的情况下，使用Objects的equals是不适用的。所以为了解决这个问题，可以使用Javers库中的compare方法来解决该问题`
POM.XML引用
<dependency>
            <groupId>org.javers</groupId&gt
                                    DDD作为一种系统分析的方法论，最大的问题是如何在项目中实践。而在实践过程中必然会面临许多的问题，「模式」是系统架构领域中一种常见的手段，能够帮助开发人员与架构师在遭遇某种较为棘手，或是陌生的问题时，参考已有的成熟经验与解决方案，从而优雅的解决自己项目中的问题。从本期开始，我会开始介绍DDD中一些常见的模式，包括这些模式的背景，作用，优缺点，以及在使用过程中需要注意的地方。而本次的主角就是
CQRS，中文名为命令查询职责分离。
毋庸置疑「领域」在DDD中占据了核心的地
                                    在开发应用程序时，我们经常需要存储有关数据如何随时间变化的信息。此信息可用于更轻松地调试应用程序并满足设计要求。在本文中，我们将讨论 JaVers 工具，该工具允许您通过记录数据库实体状态的更改来自动执行此过程。Javers如何工作？库的操作基于以 JSON 格式在专用表中存储有关业务数据实体的信息。JaVers允许您将这些信息存储在等数据库中。使用另一方面，如果您决定使用其中一个为了提供适当的算法来比较不同版本的对象，JaVers 对几种数据类型进行操作：实体、和。
                                    在Java世界中，有两种数据审计工具：Envers和JaVers。 Envers已经存在了很长时间，它被认为是主流。 JaVers提供全新的方法和技术独立性。 如果您考虑哪种工具更适合您的项目，本文是一个很好的起点。本文分为三个部分。首先，是高层次的比较。 在第二部分中，我将展示用于管理组织结构的简单演示应用程序 Javers和Envers进行的数据审计。 在第三部分中，我将检查这两种工具如何应对对审计数据的查询。目录JaVers和Envers之间有两个很大的区别：Envers是Hibernate插件。 它
                                    在某个项目中，某些文件包含^ M作为换行符分隔符。  分散这些文件显然是不可能的，因为git-diff认为它是整个文件只是一行。 
  如何与之前的版本区别开来？ 
  有没有像“在分辨时将^ M
                                    有这样两个文件：程序清单1 ：hello.c#include int main(void){    char msg[] = "Hello world!";        puts(msg);    printf("Welcome to use diff commond./n");        return 0;    }程序清单2：hello_diff.c#include #include i
                                    上一篇我们算是粗略的介绍了一下DDD，我们提到了实体、值类型和领域服务，也稍微讲到了DDD中的分层结构。但这只能算是一个很简单的介绍，并且我们在上篇的末尾还留下了一些问题，其中大家讨论比较多的，也是我本人之前有一些疑问的地方就是Repository。我之前觉得IRepository和三层里面的IDAL很像，为什么要整出这么个东西来；有人说用EF的话就不需要Repository了；IRepository是鸡肋等等。我觉得这些问题都很好，我自己也觉得有问题，带着这些问题我们就来看一看Repository在DDD中到底起着一个什么样的角色，它为什么存在？有一句真理不是说“存在即合理”么？那我们就要找
       公司业务接入银行存管后，由存管银行负责投资者交易清算与资金交收。涉及跟第三方交易必须通过对账来保证资金的一致性。对账一般有两种，单向对账跟双向对账。由于公司所有资金流动都以银行为准，采用单向对账的方式。
单向对账：一般拿第三方支付机构或银行流水，与自己系统进行对账，防...
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifa...