io.github.dddplus.model

类 DirtyMemento

java.lang.Object

io.github.dddplus.model.DirtyMemento

public final class DirtyMemento
extends Object

聚合根的脏数据备忘录，对聚合根内部状态变化进行追踪.

提升系统性能，因为降低了数据库交互.

DirtyMemento被Entity组合进去，用来(主动)通知Repository哪些状态改变了(变脏了/新增了/删除了).

通过这个机制，repo.save(entity);可以通过一个save方法支持所有的状态改变场景.

DirtyMemento仅限于一个聚合根；对于跨聚合根的情况，使用IUnitOfWork.

进阶应用：不仅普通聚合根上使用，IBag上也可以.

 

 class OrderEntity {
     private DirtyMemento dirtyMemento = new DirtyMemento();

     public void foo() {
         dirtyMemento.register(new FooHint(this));
     }
     public void bar() {
         dirtyMemento.merge(new BarHint(this));
     }
 }
 class OrderRepository {
     void persist(Order order) {
         DirtyMemento dirtyMemento = order.getDirtyMemento();
         if (dirtyMemento.isEmpty()) {
             return;
         }
         FooHint fooHint = dirtyMemento.firstHintOf(FooHint.class);
         dao.executeFoo(fooHint);
         BarHint barHint = dirtyMemento.firstHintOf(BarHint.class);
         dao.executeBar(barHint);
     }
     void persist(OrderBag bag) {
         RemoveOrderLineHint hint = dirtyMemento.firstHintOf(RemoveOrderLineHint.class);
         dao.batchUpdate(hint);
     }
 }
 class OrderBag implements IBag {
     private DirtyMemento dirtyMemento;
     public void removeOrderLine(OrderLine orderLine) {
         // ...
         dirtyMemento.register(new RemoveOrderLineHint(orderLine));
     }
 }
 
 

构造器概要

构造器

构造器和说明
DirtyMemento()

方法概要

限定符和类型	方法和说明
void	clear()
List<IDirtyHint>	dirtyHints() 当前的所有脏数据.
<T extends IDirtyHint> @NonNull List<T>	dirtyHintsOf(Class<T> hintClass) 根据指定hint class type，找到其所有的脏数据通知.
<T extends IDirtyHint> T	firstHintOf(Class<T> hintClass) 根据指定hint class type，找到已经注册的第一个脏数据通知.
boolean	isEmpty()
void	merge(@NonNull IMergeAwareDirtyHint hint) 合并脏数据通知：如未注册则注册，否则与现有那一个hint合并.
void	register(@NonNull IDirtyHint hint) 注册(追加)一个脏数据通知，以便Repository知道具体如何持久化.
int	size()

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

DirtyMemento

public DirtyMemento()

方法详细资料

register

public void register(@NonNull
                     @NonNull IDirtyHint hint)

注册(追加)一个脏数据通知，以便Repository知道具体如何持久化.

参数:

hint - the dirty hint with necessary data

merge

public void merge(@NonNull
                  @NonNull IMergeAwareDirtyHint hint)

合并脏数据通知：如未注册则注册，否则与现有那一个hint合并.

保证备忘录里，该IMergeAwareDirtyHint只保留一个

Merge on Write

参数:

hint - 脏数据通知

dirtyHints

public List<IDirtyHint> dirtyHints()

当前的所有脏数据.

返回:

all dirty hints

clear

public void clear()

isEmpty

public boolean isEmpty()

size

public int size()

firstHintOf

public <T extends IDirtyHint> T firstHintOf(Class<T> hintClass)

根据指定hint class type，找到已经注册的第一个脏数据通知.

类型参数:

T - hint class type

参数:

hintClass - concrete type of IDirtyHint

返回:

null if not found. ONLY returns the first registered hint of specified type

dirtyHintsOf

@NonNull
public <T extends IDirtyHint> @NonNull List<T> dirtyHintsOf(Class<T> hintClass)

根据指定hint class type，找到其所有的脏数据通知.

类型参数:

T - hint class type

参数:

hintClass - concrete type of IDirtyHint

返回:

will never returns null, but might be an empty list