時間屬性

範例：使用時間集合 (Java)

時間收集是實作時間屬性的簡單方法。時間收集的基本表示法和介面類似於地圖：提供使用日期作為索引的取得和放入操作。事實上，地圖是其良好的後援收集。

類別 TemporalCollection...

  private Map contents = new HashMap();
  public Object get(MfDate when) {
    /** returns the value that was effective on the given date */
    Iterator it = milestones().iterator();
    while (it.hasNext()) {
      MfDate thisDate = (MfDate) it.next();
      if (thisDate.before(when) || thisDate.equals(when)) return contents.get(thisDate);
    }
    throw new IllegalArgumentException("no records that early");
  }
  public void put(MfDate at, Object item) {
    /** the item is valid from the supplied date onwards */
    contents.put(at,item);
    clearMilestoneCache();
  }

地圖包含依據其生效的開始日期索引的值。里程碑方法會以反向順序傳回這些金鑰。然後，取得方法會透過這些里程碑找出正確的金鑰。當您較可能要求最近的值時，此演算法最有效。

如果您存取時間收集的頻率高於更新頻率，快取里程碑收集可能是值得的。

類別 TemporalCollection...

  private List _milestoneCache;
  private List milestones() {
    /** a list of all the dates where the value changed, returned in order
    latest first */
    if (_milestoneCache == null)
      calculateMilestones();
    return _milestoneCache;
  }
  private void calculateMilestones() {
    _milestoneCache = new ArrayList(contents.size());
    _milestoneCache.addAll(contents.keySet());
    Collections.sort(_milestoneCache, Collections.reverseOrder());
  }
  private void clearMilestoneCache() {
    _milestoneCache = null;
  }

當您編寫時間收集時，很容易為客戶建立地址時間收集。

類別 Customer...

  private TemporalCollection addresses = new SingleTemporalCollection();
  public Address getAddress(MfDate date) {
    return (Address) addresses.get(date);
  }
  public Address getAddress() {
    return getAddress(MfDate.today());
  }
  public void putAddress(MfDate date, Address value) {
    addresses.put(date, value);
  }

使用時間收集最大的問題之一是，如果您必須將收集持續存在於關聯式資料庫中，則對應到表格並非完全直接。基本上，關聯式資料庫需要使用效能。這通常表示您需要建立交集表格作為日期範圍的位置。部分此程式碼可以概括為時間收集類別，但需要一些明確的對應程式碼。

範例：實作雙時間屬性 (Java)

在思考雙時間屬性的運作方式之前，值得思考它必須做什麼。基本上，雙時間屬性允許我們儲存歷史資訊，並在兩個面向中保留完整歷程。因此，我們建立像這樣的歷程。

類別 Tester...

  private Customer martin;
  private Address franklin = new Address ("961 Franklin St");
  private Address worcester = new Address ("88 Worcester St");
  public void setUp () {
    MfDate.setToday(new MfDate(1996,1,1));
    martin = new Customer ("Martin");
    martin.putAddress(new MfDate(1994, 3, 1), worcester);
    MfDate.setToday(new MfDate(1996,8,10));
    martin.putAddress(new MfDate(1996, 7, 4), franklin);
    MfDate.setToday(new MfDate(2000,9,11));
  }

請注意更新的節奏。當我們儲存雙時間歷程時，記錄日期永遠是今天。因此，在我們的測試中，我們會先變更目前日期，然後將資訊儲存在歷程中。當我們將資訊放入歷程中時，我們會提供實際日期。

產生的歷程如下所示。

類別 Tester...

  private MfDate jul1 = new MfDate(1996, 7, 1);
  private MfDate jul15 = new MfDate(1996, 7, 15);
  private MfDate aug1 = new MfDate(1996, 8, 1);
  private MfDate aug10 = new MfDate(1996, 8, 10);
  public void testSimpleBitemporal () {
    assertEquals("jul1 as at aug 1", worcester, martin.getAddress(jul1, aug1));
    assertEquals("jul1 as at aug 10",worcester, martin.getAddress(jul1, aug10));
    assertEquals("jul1 as at now",worcester, martin.getAddress(jul1));

    assertEquals("jul15 as at aug 1", worcester, martin.getAddress(jul15, aug1));
    assertEquals("jul15 as at aug 10",franklin, martin.getAddress(jul15, aug10));
    assertEquals("jul15 as at now",franklin, martin.getAddress(jul15));
  }

正如您可以使用時間收集實作時間屬性的許多複雜性一樣，您也可以定義雙時間收集來處理雙時間屬性的許多複雜性。

基本上，雙時間收集是時間收集，其元素是時間收集。每個時間收集都是記錄歷程的圖片。

我們將首先探討如何從集合中取得資訊。最新的時間集合代表實際歷程記錄日期為現在。因此，僅有實際日期的取得方法會使用此目前的實際歷程記錄。

類別 BitemporalCollection...

  private SingleTemporalCollection contents = new SingleTemporalCollection();
  public BitemporalCollection() {
    contents.put(MfDate.today(), new SingleTemporalCollection());
  }
  public Object get(MfDate when) {
    return currentValidHistory().get(when);
  }
  private SingleTemporalCollection currentValidHistory() {
    return (SingleTemporalCollection) contents.get();
  }

(類別 SingleTemporalCollection 僅是我上面討論的香草時間集合，我稍後會說明兩者之間的關係。)

若要取得真實的雙時間值，我們會使用同時具有實際日期和記錄日期的取得器。

類別 BitemporalCollection...

  public Object get(MfDate validDate, MfDate transactionDate) {
    return validHistoryAt(transactionDate).get(validDate);
  }
  private TemporalCollection validHistoryAt(MfDate transactionDate) {
    return (TemporalCollection) contents.get(transactionDate);
  }

我們接著可以在網域類別中使用雙時間集合。

類別 Customer...

  BitemporalCollection addresses = new BitemporalCollection();
  public Address getAddress(MfDate actualDate) {
    return (Address) addresses.get(actualDate);
  }
  public Address getAddress(MfDate actualDate, MfDate recordDate) {
    return (Address) addresses.get(actualDate, recordDate);
  }
  public Address getAddress() {
    return (Address) addresses.get();
  }

每次更新集合時，我們都需要保留實際歷程記錄的舊副本。

類別 BitemporalCollection...

  public void put(MfDate validDate, Object item) {
    contents.put(MfDate.today(), currentValidHistory().copy());
    currentValidHistory().put(validDate,item);
  }
  public void put(Object item) {
    put(MfDate.today(),item);
  }

雙時間集合支援與一維時間集合非常類似的介面。因此，我們可以為時間集合建立介面，並為一維和二維集合提供個別的實作。這讓雙時間集合可以替換一維時間集合，讓將一維時間屬性重構為雙時間屬性變得容易。

在這個案例中，我使用 時間點，實際日期和記錄日期都具有日期粒度。雖然這讓範例寫起來更簡單，但最好為記錄時間使用更精細的粒度。問題在於，如果你在下午 2 點修改記錄，下午 3 點執行計費程序，然後在下午 4 點再次修改記錄。使用目前的實作，適當的值雖然不會完全遺失，但不容易取得。另一個方法（商業上經常使用）是僅在營業日結束時執行計費等工作，且在計費完成後不再允許在當天進行任何更新。計費後更新會取得計費完成後一天的記錄日期。同樣地，這種功能可以輕鬆新增到適當的時間集合類別。