封面:DDD实践:实现阿里技术提到的变更追踪.png

王有志,一个分享硬核Java技术的互金摸鱼侠 加入Java人的提桶跑路群:共同富裕的Java人

去年我们在重构项目中落地了DDD,当时花了点时间研究了下阿里巴巴大淘宝技术发布的《阿里技术专家详解DDD系列》,其中第三讲《阿里技术专家详解DDD系列 第三讲 - Repository模式》中提到了一项技术—变更追踪
简单来说,变更追踪是记录对象进行业务操作后发生的改变,通过这些改变来决定如何更新数据库,文章中提到了两种实现变更追踪方案:

  1. 基于Snapshot的方案:当数据从DB里取出来后,在内存中保存一份snapshot,然后在数据写入时和snapshot比较。常见的实现如Hibernate。
  2. 基于Proxy的方案:当数据从DB里取出来后,通过weaving的方式将所有setter都增加一个切面来判断setter是否被调用以及值是否变更,如果变更则标记为Dirty。在保存时根据Dirty判断是否需要更新。常见的实现如Entity Framework。

不过由于只给出了Snapshot方案的部分实现代码,导致很多读者对产生了疑惑。
图1:评论.png
我们在工程实践中借鉴了Snapshot方案的设计,并根据自身的业务情况做出了一些调整,下面就和大家分享我们在工程中的实践。
叠“BUFF”

  • 今天的主题是实现变更追踪而不是DDD,所以尽量不要把DDD的“战火”引过来;
  • 以下代码未经过严格的测试,可能存在BUG,欢迎大家批评指正和讨论。

    开始前的准备工作

    聚合与Repository接口的定义

    正式开始前,我们先做一些简单的准备工作,主要是DDD设计中的接口定义,首先是定义接口Aggregate和Identifier: ```java public interface Aggregate extends Serializable { ID getId(); }

public interface Identifier extends Serializable { Serializable value(); }

  1. 接着定义Repository接口并提供3个基础能力:
  2. ```java
  3. public interface Repository<T extends Aggregate<ID>, ID extends Identifier> {
  4. /**
  5. * 保存
  6. * @param aggregateRoot
  7. * @throws IllegalAccessException
  8. */
  9. void save(T aggregateRoot) throws IllegalAccessException;
  10. /**
  11. * 删除
  12. * @param aggregateRoot
  13. */
  14. void remove(T aggregateRoot);
  15. /**
  16. * 查询
  17. * @param identifier
  18. * @return
  19. */
  20. T find(ID identifier);
  21. }

Repository是Service(业务逻辑)与DAO(Data Access Object,数据访问对象)间的“桥梁”,用于隔离业务逻辑与数据库之间的依赖,帮助我们屏蔽在数据库发生变更时对业务逻辑产生的影响,这点是DDD设计相关的内容,我们在这里不过多的讨论。

领域对象与Repository服务的定义

我们定义一个简单书籍和图片的实体:

  1. @Getter
  2. @Setter
  3. public class Book implements Aggregate<BookId> {
  4. private BookId bookId;
  5. private String bookName;
  6. private String bookDesc;
  7. private Long words;
  8. private List<Image> images;
  9. private List<String> contents;
  10. @Override
  11. public BookId getId() {
  12. return this.bookId;
  13. }
  14. }
  15. @Getter
  16. @Setter
  17. public class BookId implements Identifier {
  18. private Long bookId;
  19. @Override
  20. public Serializable value() {
  21. return this.bookId;
  22. }
  23. }
  24. @Getter
  25. @Setter
  26. public class Image implements Aggregate<ImageId> {
  27. private ImageId imageId;
  28. private String imageUrl;
  29. @Override
  30. public ImageId getId() {
  31. return this.imageId;
  32. }
  33. }
  34. @Getter
  35. @Setter
  36. public class ImageId implements Identifier {
  37. private long imageId;
  38. @Override
  39. public Serializable value() {
  40. return this.imageId;
  41. }
  42. }

在有些DDD的实践规范中,实体中是不允许出现Getter方法和Setter方法的,这里为了方便提供测试数据,直接使用了lombok的注解添加Getter方法和Setter方法。
最后我们来定义实体Book的Repository服务:

  1. public interface BookRepository extends Repository<Book, BookId> {
  2. }
  3. public class BookRepositoryImpl implements BookRepository {
  4. @Override
  5. public void save(Book aggregateRoot) {
  6. // 实现保存逻辑
  7. }
  8. @Override
  9. public void remove(Book aggregateRoot) {
  10. // 实现删除逻辑
  11. }
  12. @Override
  13. public Book find(BookId identifier) {
  14. Book book = new Book();
  15. // 实现查询逻辑
  16. return book;
  17. }
  18. }

BookRepository接口的意义是方便自定义Repository方法,BookRepositoryImpl是BookRepository具体的实现,这里我们只使用3个基础功能即可,具体的实现逻辑是调用DAO实现增删改查,并借助Convert工具实现DO与实体的转换,我们这里就省略这部分内容了,实际上是我懒得写了

变更追踪的实现

RepositorySupport的实现

变更追踪的核心是在调用Repository的基础能力时进行实体对象的追踪,并在保存时对比实体对象的变化,具体的执行逻辑如下:

  • 调用Repository#find时,复制实体对象的快照,添加的变更追踪的容器中;
  • 调用Repository#save时,对比当前实体对象与快照,返回两者间的差异;
  • 调用Repository#remove时,删除变更追踪容器中实体对象的快照。

在我们的工程实践中,核心设计采用了阿里巴巴在《阿里技术专家详解DDD系列 第三讲 - Repository模式》给出的方案,但在具体的实现细节上,我们做了一些调整,接下来就和大家分享下我们的设计。
首先来实现通用支撑类RepositorySupport,提供可复用的变更追踪能力:

  1. public abstract class RepositorySupport<T extends Aggregate<ID>, ID extends Identifier> implements Repository<T, ID> {
  2. private final AggregateTracingManager<T, ID> aggregateTracingManager;
  3. public RepositorySupport() {
  4. this.aggregateTracingManager = new ThreadLocalTracingManager<>();
  5. }
  6. /**
  7. * 由继承RepositorySupport的子类实现
  8. */
  9. protected abstract T onSelect(ID id);
  10. protected abstract void onInsert(T aggregate);
  11. protected abstract void onUpdate(T aggregate, AggregateDifference<T, ID> aggregateDifference);
  12. protected abstract void onDelete(T aggregate);
  13. /**
  14. * 主动追踪
  15. * @param id
  16. * @return
  17. */
  18. public void attach(T aggregate) {
  19. this.aggregateTracingManager.attach(aggregate);
  20. }
  21. /**
  22. * 差异对比
  23. * @param aggregate
  24. * @return
  25. * @throws IllegalAccessException
  26. */
  27. protected AggregateDifference<T, ID> different(T aggregate) throws IllegalAccessException {
  28. return this.aggregateTracingManager.different(aggregate);
  29. }
  30. /**
  31. * 解除追踪
  32. * @param id
  33. * @return
  34. */
  35. public void detach(T aggregate) {
  36. this.aggregateTracingManager.detach(aggregate);
  37. }
  38. @Override
  39. public T find(ID identifier) {
  40. T aggregate = this.onSelect(identifier);
  41. if (aggregate != null) {
  42. this.aggregateTracingManager.attach(aggregate);
  43. }
  44. return aggregate;
  45. }
  46. @Override
  47. public void save(T aggregate) throws IllegalAccessException {
  48. AggregateDifference<T, ID> aggregateDifference = this.aggregateTracingManager.different(aggregate);
  49. if (DifferenceTypeEnum.ADDED.equals(aggregateDifference.getDifferentType())) {
  50. this.onInsert(aggregate);
  51. } else {
  52. this.onUpdate(aggregate, aggregateDifference);
  53. }
  54. this.aggregateTracingManager.merge(aggregate);
  55. }
  56. @Override
  57. public void remove(T aggregate) {
  58. this.onDelete(aggregate);
  59. this.aggregateTracingManager.detach(aggregate);
  60. }
  61. }

我们依次对通用支撑类RepositorySupport中的成员变量和方法进行说明。
首先是RepositorySupport中唯一的成员变量AggregateTracingManager,该类的功能是完成变更追踪快照的管理,包括对象追踪,差异对比和解除追踪等
接着是继承RepositorySupport的实现类需要重写的方法:

  • RepositorySupport#onSelect,由RepositorySupport中实现的Repository#find调用,与直接实现Repository#find相同,通过DAO查询数据,并转换为实体对象;
  • RepositorySupport#onInsert,由RepositorySupport中实现的Repository#save调用,与直接实现Repository#save类似,通过DAO保存数据,此时为新增数据的保存;
  • RepositorySupport#onUpdate,由RepositorySupport中实现的Repository#save调用,与直接实现Repository#save类似,通过DAO保存数据,此时为修改数据的保存;
  • RepositorySupport#onDelete,由RepositorySupport中实现的Repository#remove调用,与直接实现Repository#remove相同,通过DAO删除数据。

接着是Repository中定义的提供变更追踪能力的方法:

  • RepositorySupport#attach,主动追踪,当实体的Repository接口中自定义查询方法时,实现类可以通过该方法实现对象的变更追踪;
  • RepositorySupport#different,差异对比,当实体的Repository接口中自定义保存方法时,实现类可以通过该方法获取当前实体对象与快照的差异;
  • RepositorySupport#detach,解除追踪,当实体的Repository接口中自定义删除方法时,实现类可以通过该方法解除对象的变更追踪。

最后是RepositorySupport中对Repository接口的实现,实现中确定了RepositorySupport#onSelectRepositorySupport#onInsertRepositorySupport#onUpdateRepositorySupport#onDelete方法的调用时机,并通过AggregateTracingManager来管理追踪对象:

  • RepositorySupport#find的实现中,通过RepositorySupport#onSelect查询实体对象,并决定是否调用AggregateTracingManager#attach进行变更追踪;
  • RepositorySupport#save的实现中,调用AggregateTracingManager#different获取当前实体对象与快照间的差异,并根据差异的类型选择执行RepositorySupport#onInsertRepositorySupport#onUpdate,最后调用AggregateTracingManager#merge将变更后的对象合并到变更追踪容器中;
  • RepositorySupport#remove的实现中,调用RepositorySupport#onDelete删除数据,并调用AggregateTracingManager#detach解除对象的追踪。

    AggregateTracingManager的实现

    AggregateTracingManager提供了管理变更追踪的能力,接口设计如下:

    1. public interface AggregateTracingManager<T extends Aggregate<ID>, ID extends Identifier> {
    2. /**
    3. * 变更追踪
    4. * @param aggregate
    5. */
    6. void attach(T aggregate);
    7. /**
    8. * 解除追踪
    9. * @param aggregate
    10. */
    11. void detach(T aggregate);
    12. /**
    13. * 对比差异
    14. * @param aggregate
    15. * @return
    16. */
    17. AggregateDifference<T, ID> different(T aggregate) throws IllegalAccessException;
    18. /**
    19. * 合并变更
    20. * @param aggregate
    21. */
    22. void merge(T aggregate);
    23. }

    接着提供一个AggregateTracingManager的实现类,我们的工程中同样选择了ThreadLocal来实现线程隔离:

    1. public class ThreadLocalTracingManager<T extends Aggregate<ID>, ID extends Identifier> implements AggregateTracingManager<T, ID> {
    2. private final ThreadLocal<TraceContext<T, ID>> context;
    3. public ThreadLocalTracingManager() {
    4. this.context = ThreadLocal.withInitial(MapContext::new);
    5. }
    6. @Override
    7. public void attach(T aggregate) {
    8. this.context.get().tracing(aggregate.getId(), aggregate);
    9. }
    10. @Override
    11. public void detach(T aggregate) {
    12. this.context.get().remove(aggregate.getId());
    13. }
    14. @Override
    15. public AggregateDifference<T, ID> different(T aggregate) throws IllegalAccessException {
    16. T snapshot = this.context.get().find(aggregate.getId());
    17. return DifferentUtils.different(snapshot, aggregate);
    18. }
    19. @Override
    20. public void merge(T aggregate) {
    21. attach(aggregate);
    22. }
    23. }

    最后是定义变更追踪中用于存储快照的容器TraceContext接口:

    1. public interface TraceContext<T extends Aggregate<ID>, ID extends Identifier> {
    2. void add(ID id, T aggregate);
    3. T find(ID id);
    4. void remove(ID id);
    5. }

    TraceContext的功能比较简单,提供了3个方法:

  • void add(ID id, T aggregate),添加追踪对象;

  • T find(ID id),获取追踪对象的快照;
  • void remove(ID id),删除追踪对象。

这里我提供一个使用HashMap做存储容器的简单实现:

  1. public class MapContext<T extends Aggregate<ID>, ID extends Identifier> implements TraceContext<T, ID> {
  2. private final Map<ID, T> snapshots;
  3. public MapContext() {
  4. this.snapshots = new HashMap<>();
  5. }
  6. @Override
  7. public void add(ID id, T aggregate) {
  8. T snapshot = SnapshotUtils.snapshot(aggregate);
  9. this.snapshots.put(aggregate.getId(), snapshot);
  10. }
  11. @Override
  12. public T find(ID id) {
  13. for (Map.Entry<ID, T> entry : this.snapshots.entrySet()) {
  14. ID entryId = entry.getKey();
  15. if (id.getClass().equals(entryId.getClass()) && entryId.value().equals(id.value())) {
  16. return entry.getValue();
  17. }
  18. }
  19. return snapshots.get(id);
  20. }
  21. @Override
  22. public void remove(ID id) {
  23. this.snapshots.remove(id);
  24. }
  25. }

至此,我们已经完成了变更追踪的整体框架。实际上我们在工程中实现的AggregateTracingManager和TraceContext会更加复杂,并添加了一些具有我司特色的功能,这里大家可以根据各自的情况做出不同的实现。

变更追踪中的工具类实现

由于《阿里技术专家详解DDD系列 第三讲 - Repository模式》文中的重点是介绍变更追踪这项技术,因此忽略了几个较为关键的工具类的实现,导致很多人在落地这项技术上遇到了困境,这里我结合工程中的实践,结合我个人的思考,给大家提供一个设计思路。

SnapshotUtils的实现

SnapshotUtils用于实现Aggregate的拷贝,因为在MapContext#find方法的实现中是通过类型与值的对比来获取对象,因此我们在SnapshotUtils的实现中只需要实现深拷贝即可:

  1. public class SnapshotUtils {
  2. @SuppressWarnings("unchecked")
  3. public static <T extends Aggregate<ID>, ID extends Identifier> T snapshot(T aggregate) throws IOException, ClassNotFoundException {
  4. ByteArrayOutputStream byteArrayOutputStream = new ByteArrayOutputStream();
  5. ObjectOutputStream objectOutputStream = new ObjectOutputStream(byteArrayOutputStream);
  6. objectOutputStream.writeObject(aggregate);
  7. ByteArrayInputStream byteArrayInputStream = new ByteArrayInputStream(byteArrayOutputStream.toByteArray());
  8. ObjectInputStream objectInputStream = new ObjectInputStream(byteArrayInputStream);
  9. T snapshot = (T) objectInputStream.readObject();
  10. objectOutputStream.close();
  11. byteArrayOutputStream.close();
  12. objectInputStream.close();
  13. byteArrayInputStream.close();
  14. return snapshot;
  15. }
  16. }

据我推测阿里巴巴大淘宝技术在文中使用的SnapshotUtils中除了Identifier外的其余字段是深拷贝,我们的实践中允许Identifier也进行深拷贝,所以可以通过序列化与反序列化的方式进行深拷贝。
除了序列化的方式外,还有很多其他的方式可以实现深拷贝,我见过使用JSON工具来回倒腾实现深拷贝,或者可以使用BeanUtil等等。
Tips:有些工具的使用是有前提的,比如需要Getter和Setter方法,又或者使用序列化的方式需要继承Serializable接口。

使用Java Objec Diff实现DiffUtils

DiffUtils用于实现两个Java对象间的对比,因为此类需求较少所以市面上可供使用的开源工具并不是很多,相对来说Java Objec Diff是使用较为广泛的开源项目,不过该项目最新版本是2018年更新的0.95版本,作者应该是停止维护Java Object Diff了,或是由于该项目属于工具类项目,目前已经达到了较为完备的状态,不需要进行太多的维护工作了。
我们先来使用Java Objec Diff项目实现一个简单的Java对象对比工具,引入Java Objec Diff的依赖:

  1. <dependency>
  2. <groupId>de.danielbechler</groupId>
  3. <artifactId>java-object-diff</artifactId>
  4. <version>0.95</version>
  5. </dependency>

基于Java Objec Diff项目构建DiffUtils,这里给出一个简单的实现:

  1. public class DiffUtils {
  2. public static EntityDiff diff(Object snapshot, Object obj) {
  3. DiffNode diffNode = ObjectDifferBuilder.buildDefault().compare(obj, snapshot);
  4. if (!diffNode.hasChanges()) {
  5. return EntityDiff.EMPTY;
  6. }
  7. EntityDiff entityDiff = new EntityDiff();
  8. entityDiff.setHasChanges(true);
  9. diffNode.visit((node, visit) -> {
  10. boolean hasChanges = node.hasChanges();
  11. Object objValue = node.canonicalGet(obj);
  12. Object snapshotValue = node.canonicalGet(snapshot);
  13. // 处理其他的逻辑和构建EntityDiff对象
  14. });
  15. return entityDiff;
  16. }
  17. }
  18. @Getter
  19. @Setter
  20. public class EntityDiff {
  21. public static final EntityDiff EMPTY = new EntityDiff();
  22. private boolean hasChanges;
  23. // 省略其余属性的实现
  24. public EntityDiff() {
  25. }
  26. }

EntityDiff的结构可以根据自身工程的需求进行定制化,我这里只是为了展示如何通过Java Objec Diff项目构建DiffUtils。

具有我司特色的DifferentUtils

接下来就该我来献丑了。
图2:献丑了.png
因为我们有一些定制化的需求(具体原因已经记不得了),所以当时没有选择使用Java Objec Diff项目而是实现了具有我司特色的Java对象的对比工具类DifferentUtils。
首先是我们定义的4种差异状态:

  1. public enum DifferenceType {
  2. /**
  3. * 新增
  4. */
  5. ADDED(),
  6. /**
  7. * 删除
  8. */
  9. REMOVED(),
  10. /**
  11. * 修改
  12. */
  13. MODIFIED(),
  14. /**
  15. * 无变化
  16. */
  17. UNTOUCHED()
  18. }

接着我们对结果进行了封装,分为两层,第一层是标记Aggregate差异的AggregateDifference:

  1. @Getter
  2. @Setter
  3. public class AggregateDifference<T extends Aggregate<ID>, ID extends Identifier> {
  4. /**
  5. * 快照对象
  6. */
  7. private T snapshot;
  8. /**
  9. * 追踪对象
  10. */
  11. private T aggregate;
  12. /**
  13. * 差异类型
  14. */
  15. private DifferenceType differentType;
  16. /**
  17. * 字段差异
  18. */
  19. private Map<String, FieldDifference> fieldDifferences;
  20. }

第二层是比较Aggregate字段差异的FieldDifference:

  1. @Getter
  2. @Setter
  3. public class FieldDifference {
  4. /**
  5. * 字段名
  6. */
  7. private String name;
  8. /**
  9. * 字段类型
  10. */
  11. private Type type;
  12. /**
  13. * 快照值
  14. */
  15. private Object snapshotValue;
  16. /**
  17. * 当前值
  18. */
  19. private Object tracValue;
  20. /**
  21. * 差异类型
  22. */
  23. private DifferenceType differenceType;
  24. }

以及3个实现类,标记Java中原生类型的JavaTypeFieldDifference,标记集合类型的CollectionFieldDifference,以及标记实现Aggregate接口的AggregareFieldDifference:

  1. public class JavaTypeFieldDifference extends FieldDifference {
  2. }
  3. @Getter
  4. @Setter
  5. public class CollectionFieldDifference extends FieldDifference {
  6. /**
  7. * 集合元素差异
  8. */
  9. private List<FieldDifference> elementDifference;
  10. public CollectionFieldDifference(String name, Type type, Object snapshotValue, Object tracValue) {
  11. super(name, type, snapshotValue, tracValue);
  12. this.elementDifference = new ArrayList<>();
  13. }
  14. public CollectionFieldDifference(String name, Type type, Object snapshotValue, Object tracValue, DifferenceType differenceType) {
  15. super(name, type, snapshotValue, tracValue, differenceType);
  16. this.elementDifference = new ArrayList<>();
  17. }
  18. }
  19. @Getter
  20. @Setter
  21. public class AggregareFieldDifference extends FieldDifference {
  22. private Map<String, FieldDifference> fieldDifferences;
  23. private final Identifier identifier;
  24. public AggregareFieldDifference(String name, Type type, Object snapshotValue, Object tracValue, DifferenceType differenceType, Identifier identifier) {
  25. super(name, type, snapshotValue, tracValue, differenceType);
  26. this.identifier = identifier;
  27. this.fieldDifferences = new HashMap<>();
  28. }
  29. }

可以看到,我们在工程实践中并不支持Map类型的字段进行对比,这是因为在我们落地的DDD工程规范中,实现Aggregate接口的类中不允许出现Map类型的字段,只允许Java的8种基础类型(包装类型),String,List,值对象以及实体。
准备工作完成后,我们开始实现DifferentUtils,首先定义方法声明,与上面的DiffUtils#diff存在一些差异,主要在泛型的使用上:

  1. public class DifferentUtils {
  2. public static <T extends Aggregate<ID>, ID extends Identifier> AggregateDifference<T, ID> different(T snapshot, T aggregate) throws IllegalAccessException {
  3. // 待实现
  4. }
  5. }

接着我们处理两个入参可能为null的情况进行处理,总计有4种情况:

  • snapsho == null && aggregate == null,此时认为是DifferenceType.UNTOUCHED
  • snapshot == null && aggregate != null,此时认为是DifferenceType.ADDED
  • snapshot != null && aggregate == null,此时认为是DifferenceType.REMOVED
  • snapshot != null && aggregate != null,这种情况需要对比字段的差异。

此时我们可以得到用于入参为null时,返回DifferenceType的方法:

  1. private static DifferenceType basicDifferentType(Object snapshot, Object aggregate) {
  2. if (snapshot == null && aggregate == null) {
  3. return DifferenceType.UNTOUCHED;
  4. }
  5. if (snapshot == null) {
  6. return DifferenceType.ADDED;
  7. }
  8. if (aggregate == null) {
  9. return DifferenceType.REMOVED;
  10. }
  11. return null;
  12. }

我们直接在DifferentUtils#different中调用DifferentUtils#basicDifferentType,并补充snapshot和aggregate均不为null时的处理:

  1. public static <T extends Aggregate<ID>, ID extends Identifier> AggregateDifference<T, ID> different(T snapshot, T aggregate) throws IllegalAccessException {
  2. DifferenceType basicDifferenceType = basicDifferentType(snapshot, aggregate);
  3. if (basicDifferenceType != null) {
  4. return new AggregateDifference<>(snapshot, aggregate, basicDifferenceType);
  5. }
  6. Field[] fields = ReflectionUtils.getFields(aggregate);
  7. // 标记Aggregate
  8. DifferenceType aggregateDifferentType = aggregateDifferentType(fields, snapshot, aggregate);
  9. // 构建AggregateDifference对象
  10. AggregateDifference<T, ID> aggregateDifference = new AggregateDifference<>(snapshot, aggregate, aggregateDifferentType);
  11. Map<String, FieldDifference> fieldDifferences = aggregateDifference.getFieldDifferences();
  12. // 对比字段差异
  13. setDifferences(snapshot, aggregate, fields, fieldDifferences);
  14. return aggregateDifference
  15. }

DifferentUtils#aggregateDifferentType方法,该方法用于对Aggregate进行标记:

  1. public static <T extends Aggregate<ID>, ID extends Identifier> DifferenceType aggregateDifferentType(Field[] fields, T snapshot, T aggregate) throws IllegalAccessException {
  2. DifferenceType differenceType = basicDifferentType(snapshot, aggregate);
  3. if (differenceType != null) {
  4. return differenceType;
  5. }
  6. boolean unchanged = true;
  7. for (Field field : fields) {
  8. field.setAccessible(true);
  9. // 处理需要跳过的情形
  10. if (shouldSkipClass(field.getType())) {
  11. continue;
  12. }
  13. if (Collection.class.isAssignableFrom(field.getType())) {
  14. ParameterizedType parameterizedType = (ParameterizedType) field.getGenericType();
  15. Class<?> parameterizedClass = (Class<?>) parameterizedType.getActualTypeArguments()[0];
  16. if (Aggregate.class.isAssignableFrom(parameterizedClass) || Map.class.isAssignableFrom(parameterizedClass)) {
  17. continue;
  18. }
  19. }
  20. // 对比字段差异
  21. Object aggregateValue = field.get(aggregate);
  22. Object snapshotValue = field.get(snapshot);
  23. if (snapshotValue == null && aggregateValue == null) {
  24. continue;
  25. } else if (snapshotValue == null) {
  26. unchanged = false;
  27. continue;
  28. }
  29. unchanged = snapshotValue.equals(aggregateValue) & unchanged;
  30. }
  31. return unchanged ? DifferenceType.UNTOUCHED : DifferenceType.MODIFIED;
  32. }
  33. private static boolean shouldSkipClass(Class<?> clazz) {
  34. return Identifier.class.isAssignableFrom(clazz) || Aggregate.class.isAssignableFrom(clazz) || Map.class.isAssignableFrom(clazz);
  35. }

因为该方法需要在其它位置复用,所以开始时先调用了DifferentUtils#aggregateDifferentType处理null的状态;接着是跳过需要特殊处理的类型,这些类型要么是单独处理,要么是不需要处理,以及当字段的类型为Collection时,某些泛型类型也不需要处理;最后是通过Object#equals方法进行对比,并返回相应的修改状态。
DifferentUtils#setDifferences的实现,该方法遍历Aggregate的字段,并对比每个字段的差异:

  1. private static <T extends Aggregate<ID>, ID extends Identifier> void setDifferences(T snapshot, T aggregate, Field[] fields, Map<String, FieldDifference> fieldDifferences) throws IllegalAccessException {
  2. for (Field field : fields) {
  3. if (Identifier.class.isAssignableFrom(field.getType())) {
  4. continue;
  5. }
  6. String filedName = ReflectionUtils.getFieldName(field);
  7. field.setAccessible(true);
  8. Object snapshotValue = snapshot == null ? null : field.get(snapshot);
  9. Object aggregateValue = aggregate == null ? null : field.get(aggregate);
  10. if (snapshotValue == null && aggregateValue == null) {
  11. continue;
  12. }
  13. // 对比每个字段的差异
  14. FieldDifference fieldDifference = compareFiled(field, snapshotValue, aggregateValue);
  15. fieldDifferences.put(filedName, fieldDifference);
  16. }
  17. }

DifferentUtils#compareFiled的实现,该方法将字段进行分类对比:

  1. @SuppressWarnings("unchecked")
  2. private static <T extends Aggregate<ID>, ID extends Identifier> FieldDifference compareFiled(Field field, Object snapshotValue, Object aggregateValue) throws IllegalAccessException {
  3. ComparableType comparableType = ComparableType.comparableType(aggregateValue == null ? snapshotValue : aggregateValue);
  4. if (ComparableType.AGGREGATE_TYPE.equals(comparableType)) {
  5. return compareAggregateType(field, (T) snapshotValue, (T) aggregateValue);
  6. } else if (ComparableType.COLLECTION_TYPE.equals(comparableType)) {
  7. return compareCollectionType(field, snapshotValue, aggregateValue);
  8. } else if (ComparableType.JAVA_TYPE.equals(comparableType)) {
  9. return compareJavaType(field, snapshotValue, aggregateValue);
  10. } else {
  11. throw new UnsupportedOperationException();
  12. }
  13. }
  14. /**
  15. * 可比较的字段类型
  16. */
  17. enum ComparableType {
  18. AGGREGATE_TYPE(),
  19. COLLECTION_TYPE(),
  20. JAVA_TYPE(),
  21. OTHER_TYPE();
  22. public static ComparableType comparableType(@NonNull Object obj) {
  23. if (obj instanceof Aggregate) {
  24. return AGGREGATE_TYPE;
  25. } else if (obj instanceof Collection) {
  26. return COLLECTION_TYPE;
  27. } else if (obj instanceof Map) {
  28. return OTHER_TYPE;
  29. } else {
  30. return JAVA_TYPE;
  31. }
  32. }
  33. }

DifferentUtils#compareJavaType的实现,该方法对比了Java类型字段的差异:

  1. private static FieldDifference compareJavaType(Field field, Object snapshotValue, Object aggregateValue) {
  2. String filedName = ReflectionUtils.getFieldName(field);
  3. Type type = field.getGenericType();
  4. DifferenceType differenceType = javaDifferentType(snapshotValue, aggregateValue);
  5. return new JavaTypeFieldDifference(filedName, type, snapshotValue, aggregateValue, differenceType);
  6. }
  7. public static DifferenceType javaDifferentType(Object snapshot, Object aggregate) {
  8. DifferenceType differenceType = basicDifferentType(snapshot, aggregate);
  9. if (differenceType != null) {
  10. return differenceType;
  11. }
  12. if (snapshot.equals(aggregate)) {
  13. return DifferenceType.UNTOUCHED;
  14. } else {
  15. return DifferenceType.MODIFIED;
  16. }
  17. }

DifferentUtils#compareAggregateType的实现,该方法对比实现Aggregate接口的类型的字段进行对比,通过递归不断向下深入直到类型为Java类型:

  1. private static <T extends Aggregate<ID>, ID extends Identifier> FieldDifference compareAggregateType(Field field, T snapshotValue, T aggregateValue) throws IllegalAccessException {
  2. String filedName = ReflectionUtils.getFieldName(field);
  3. Type type = field.getGenericType();
  4. Aggregate<?> notNullValue = snapshotValue == null ? aggregateValue : snapshotValue;
  5. Field[] entityFields = ReflectionUtils.getFields(notNullValue);
  6. Identifier id = notNullValue.getId();
  7. DifferenceType differenceType = aggregateDifferentType(entityFields, snapshotValue, aggregateValue);
  8. AggregareFieldDifference aggregareFieldDifference = new AggregareFieldDifference(filedName, type, snapshotValue, aggregateValue, differenceType, id);
  9. Map<String, FieldDifference> fieldDifferences = aggregareFieldDifference.getFieldDifferences();
  10. setDifferences(snapshotValue, aggregateValue, entityFields, fieldDifferences);
  11. return aggregareFieldDifference;
  12. }

DifferentUtils#compareCollectionType的实现,该方法用于对比集合类型的

  1. @SuppressWarnings("unchecked")
  2. private static <T extends Aggregate<ID>, ID extends Identifier> FieldDifference compareCollectionType(Field field, Object snapshotValue, Object aggregateValue) throws IllegalAccessException {
  3. String filedName = ReflectionUtils.getFieldName(field);
  4. Type type = field.getGenericType();
  5. ParameterizedType parameterizedType = (ParameterizedType) type;
  6. Class<?> genericityClass = (Class<?>) parameterizedType.getActualTypeArguments()[0];
  7. // 处理泛型为Java类型的集合
  8. if (!Aggregate.class.isAssignableFrom(genericityClass) && !Map.class.isAssignableFrom(genericityClass)) {
  9. Collection<?> snapshotValues = (Collection<?>) snapshotValue;
  10. Collection<?> aggregateValues = (Collection<?>) aggregateValue;
  11. DifferenceType differenceType = collectionDifferentType(genericityClass, snapshotValues, aggregateValues);
  12. return new CollectionFieldDifference(filedName, type, snapshotValue, aggregateValue, differenceType);
  13. }
  14. // 处理泛型为实现Aggreagte接口的类型的集合
  15. Collection<T> snapshotValues = (Collection<T>) snapshotValue;
  16. Collection<T> aggregateValues = (Collection<T>) aggregateValue;
  17. Map<Serializable, T> snapshotMap = snapshotValues.stream().collect(Collectors.toMap(snapshot -> snapshot.getId().value(), snapshot -> snapshot));
  18. Map<Serializable, T> aggregateMap = aggregateValues.stream().collect(Collectors.toMap(aggregate -> aggregate.getId().value(), aggregate -> aggregate));
  19. CollectionFieldDifference collectionFieldDifference = new CollectionFieldDifference(filedName, type, snapshotValue, aggregateValue);
  20. boolean unchanged = true;
  21. // snapshotMap与aggregateMap的交集,snapshotMap对aggregateMap的补集
  22. for (Serializable key : snapshotMap.keySet()) {
  23. T snapshotElement = snapshotMap.get(key);
  24. T aggregateElement = aggregateMap.get(key);
  25. FieldDifference fieldDifferent = compareFiled(field, snapshotElement, aggregateElement);
  26. unchanged = DifferenceType.UNTOUCHED.equals(fieldDifferent.getDifferenceType()) & unchanged;
  27. collectionFieldDifference.getElementDifference().add(fieldDifferent);
  28. }
  29. // aggregateMap对snapshotMap的补集
  30. for (Serializable key : aggregateMap.keySet()) {
  31. if (snapshotMap.get(key) != null) {
  32. continue;
  33. }
  34. T aggregateElement = aggregateMap.get(key);
  35. FieldDifference fieldDifferent = compareFiled(field, null, aggregateElement);
  36. unchanged = DifferenceType.UNTOUCHED.equals(fieldDifferent.getDifferenceType()) & unchanged;
  37. collectionFieldDifference.getElementDifference().add(fieldDifferent);
  38. }
  39. if (unchanged) {
  40. collectionFieldDifference.setDifferenceType(DifferenceType.UNTOUCHED);
  41. } else {
  42. collectionFieldDifference.setDifferenceType(DifferenceType.MODIFIED);
  43. }
  44. return collectionFieldDifference;
  45. }
  46. public static DifferenceType collectionDifferentType(Class<?> typeArguments, Collection<?> snapshot, Collection<?> aggregate) {
  47. if (CollectionUtils.isEmpty(snapshot) && CollectionUtils.isEmpty(aggregate)) {
  48. return DifferenceType.UNTOUCHED;
  49. }
  50. if (CollectionUtils.isEmpty(snapshot)) {
  51. return DifferenceType.ADDED;
  52. }
  53. if (CollectionUtils.isEmpty(aggregate)) {
  54. return DifferenceType.REMOVED;
  55. }
  56. if (specialHandingClass(typeArguments)) {
  57. return snapshot.size() == aggregate.size() ? DifferenceType.UNTOUCHED : DifferenceType.MODIFIED;
  58. }
  59. return snapshot.equals(aggregate) ? DifferenceType.UNTOUCHED : DifferenceType.MODIFIED;
  60. }
  61. private static boolean specialHandingClass(Class<?> clazz) {
  62. return shouldSkipClass(clazz) || Collection.class.isAssignableFrom(clazz);
  63. }

我们将Collection类型的字段分为两类,泛型为Java类型的和泛型为实现Aggregate接口的。当集合的泛型为Java类型时,只需要使用Object#equals方法进行对比即可;当集合的泛型为Collection或Aggregate时(集合的泛型不应该出现Map或Identifier),先对数量进行对比,标记整体的变化,接着来对比每个Aggregate的差异,并进行标记。
我的想法是,先将List<T>转换为Map<Serializable, T>,Map的key存储Id,value存储对象本身,这样可以得到两个Map:

  • Map<Serializable, T> snapshotMap
  • Map<Serializable, T> aggregateMap

先遍历snapshotMap,取出aggregateMap中Id与之对应的对象进行比较,并一一标记,这里处理的是snapshotMap与aggregateMap的交集,以及snapshotMap对aggregateMap的补集(即snapshotMap中有而aggregateMap中无的),实际上,我们这里处理的是snapshotMap的全集;再遍历aggregateMap,跳过snapshotMap中Id与之对应的对象,这里我们处理的是aggregateMap对snapshotMap的补集(即aggregateMap中有而snapshotMap中无的);这样,我们就处理完了两个集合中的元素,最后再根据每个元素对比的结果标记集合的差异类型即可。
好了,以上就是具有我司特色的DifferentUtils工具类的实现,因为没有研究过Java Object Diff的源码,因此不太清楚自己与大佬的差距究竟有多远,,欢迎大家提出自己的想法一起讨论。
Tips:鉴于保密的原因,DifferentUtils及相关类都经过不同程度的修改,且修改后的实现并没有经过严格的评审和测试,可能会出现各种各样的BUG~~

ReflectionUtils的实现

变更追踪的实现中还有一个反射相关的工具类ReflectionUtils,该工具类的实现可大可小,往小了可以像我下面实现的这样:

  1. public class ReflectionUtils {
  2. public static Field[] getFields(Object obj) {
  3. return obj.getClass().getDeclaredFields();
  4. }
  5. public static String getFieldName(Field field) {
  6. return field.getName();
  7. }
  8. }

往大了可以加入缓存等优化措施,例如ReflectionUtils#getFields加入缓存Map<Class<?>, Field[]> fieldMap,将首次获取到的结果添加到缓存中,以此来提高反射工具的性能。

结语

好了,到这里我们就一起实现了基于快照机制的变更追踪,文章中的代码还比较潦草,像是毛坯房,目的是和大家分享实现过程和设计,如果要真正的在生产环境中落地,还需要做“精装修”,这里举几个我们的“精装修”例子:

  • TraceContext的实现中,容器我们选择了WeakHashMap,用于实现“自动”执行AggregateTracingManager#detach
  • AggregateTracingManager中我们加入了配置项,实现某些功能的配置化,这里涉及定制业务就不过多展开了;
  • ReflectionUtils中加入了缓存机制,以此提高反射的效率。

好了,今天就到这里了,Bye~~

推荐阅读


如果本文对你有帮助的话,还请多多点赞支持。如果文章中出现任何错误,还请批评指正。最后欢迎大家关注分享硬核Java技术的金融摸鱼侠王有志,我们下次再见!