由於軟件應用程序的不斷變化的性質,很可能事件定義也隨着時間而變化。由於事件存儲被認爲是隻讀和只追加(沒有修改和刪除)的數據源,所以應用程序必須能夠讀取所有事件,而不管它們何時添加。這時upcasting 出現了。
最初是面向對象編程的一個概念,“一個子類在需要的時候自動轉換成超類”,upcasting 概念也可以應用於事件溯源。upcast一個事件意味着將它從原來的結構轉換成新的結構。不像OOP的upcasting,事件的upcasting無法全部自動化完成,因爲舊的事件對新事件的結構是不瞭解的。手工編寫的Upcasters,必須提供指定如何將舊的結構upcast成新結構。
Upcasters類,獲取一個x版本的輸入事件,並且輸出爲零或更多版本x+1的新事件。此外,upcasters在一個鏈中被處理,這意味着一個upcaster的輸出發送到下一個upcaster的輸入。這允許你以增量的方式更新事件,爲每一個新事件版次編寫一個Upcaster ,使其小、隔離、並且容易理解。
注意
也許upcasting最大的好處是,它允許你做非破壞性重構,即完整的事件歷史仍然保持不變。
在本節中,我們將解釋如何編寫upcaster,描述隨着Axon不同的的Upcaster實現,並解釋事件的序列化形式如何影響寫upcasters。
允許upcaster看到什麼版本的序列化對象被接收,Event Store存儲版本號以及事件的完全限定名稱。這個版本號是由RevisionResolver生成,在序列化器中配置。Axon提供了幾個RevisionResolver的實現,比如AnnotationRevisionResolver,它檢查在事件有效負載上的@Revision註解,SerialVersionUIDRevisionResolver 使用Java Serialization API和FixedValueRevisionResolver所定義的serialVersionUID,它總是返回一個預定義的值。後者在注入當前應用程序版本時是有用的。這將允許你看哪個版本的應用程序生成一個特定的事件。
Maven用戶可以使用MavenArtifactRevisionResolver自動使用項目的版本。它使用項目獲取的groupId,artifactId版本初始化。因爲這隻適用由Maven創建的JAR文件,版本不總能通過IDE來解析。如果無法解析版本,則返回null。
編寫一個upcaster
事件的老版本:
@Revision("1.0")
public class ComplaintEvent {
private String id;
private String companyName;
// Constructor, getter, setter...
}
新版本的事件:
@Revision("2.0")
public class ComplaintEvent {
private String id;
private String companyName;
private String complain; // New field
// Constructor, getter, setter...
}
Upcaster:
// Upcaster from 1.0 revision to 2.0 revision
public class ComplaintEventUpcaster extends SingleEventUpcaster {
private static SimpleSerializedType targetType = new SimpleSerializedType(ComplainEvent.class.getTypeName(), "1.0");
@Override
protected boolean canUpcast(IntermediateEventRepresentation intermediateRepresentation) {
return intermediateRepresentation.getType().equals(targetType);
}
@Override
protected IntermediateEventRepresentation doUpcast(IntermediateEventRepresentation intermediateRepresentation) {
return intermediateRepresentation.upcastPayload(
new SimpleSerializedType(targetType.getName(), "2.0"),
org.dom4j.Document.class,
document -> {
document.getRootElement().addElement("complaint");
document.getRootElement().element("complaint").setText("no complaint description"); // Default value
return document;
}
);
}
}
Spring boot configuration:
@Configuration
public class AxonConfiguration {
@Bean
public SingleEventUpcaster myUpcaster() {
return new ComplaintEventUpcaster();
}
@Bean
public JpaEventStorageEngine eventStorageEngine(Serializer serializer,
DataSource dataSource,
SingleEventUpcaster myUpcaster,
EntityManagerProvider entityManagerProvider,
TransactionManager transactionManager) throws SQLException {
return new JpaEventStorageEngine(serializer,
myUpcaster::upcast,
dataSource,
entityManagerProvider,
transactionManager);
}
}
TODO - Describe
- Upcasters工作在中間的表現層
- 它們更新流到流
- 抽象一對一的upcasting實現
- 代碼示例
Content type conversion(內容類型轉換)
一個upcaster工作在給定內容類型上(如dom4j文檔)。upcasters之間提供額外的靈活性,內容類型在鏈接的upcasters之間可能會有所不同。Axon將嘗試使用ContentTypeConverters在內容類型之間自動地轉換。它將尋找從類型x到類型y最短的路徑,執行轉換並交值轉換成請求的upcaster。考慮到性能因素 ,如果receiving upcaster上的canUpcast方法產生true,轉換纔會被執行
ContentTypeConverters可能依賴於使用的序列化器類型。試圖把一個byte[]轉換成dom4j文檔,這沒有任何意義,除非使用序列化器把事件作爲XML來寫。確保UpcasterChain有權訪問serializer-specific ContentTypeConverters,你可以通過UpcasterChain的構造函數引用序列化器。
提示
爲了達到最佳性能,確保所有upcasters在同一鏈上(其中一個的輸出是另一個的輸入)處理相同的內容類型。
如果你需要不是由Axon提供的內容類型轉換,你可以使用ContentTypeConverter接口編寫一個自己的。
XStreamSerializer支持Dom4J像支持 XOM一樣作爲XML文檔表示。JacksonSerializer 支持Jackson的JsonNode。
作者:勇赴
鏈接:http://www.jianshu.com/p/e4e943937993
來源:簡書
著作權歸作者所有。商業轉載請聯繫作者獲得授權,非商業轉載請註明出處。