時間依存プロパティ

例：時間依存コレクションの使用（Java）

時間依存コレクションは、時間依存プロパティを実装する簡単な方法です。時間依存コレクションの基本的な表現とインターフェースは、マップに似ています。日付をインデックスとして使用するget操作とput操作を提供します。実際、マップは時間依存コレクションの優れたバッキングコレクションになります。

class 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();
  }

マップには、有効になった開始日でインデックス付けされた値が含まれています。milestonesメソッドは、これらのキーを逆順に返します。次に、getメソッドはこれらのマイルストーンを処理して、正しいキーを見つけます。このアルゴリズムは、最新の値を要求する可能性が高い場合に最適に機能します。

時間依存コレクションを更新するよりもアクセスする方が多い場合は、マイルストーンコレクションをキャッシュする価値があるかもしれません。

class 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;
  }

時間依存コレクションが記述されると、顧客の住所の時間依存コレクションを簡単に作成できます。

class 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);
  }

時間依存コレクションを使用する際の最大の問題の1つは、コレクションをリレーショナルデータベースに永続化する必要がある場合です。テーブルへのマッピングはそれほど簡単ではありません。基本的に、リレーショナルデータベースは有効性を使用する必要があります。これは多くの場合、日付範囲の場所として交差テーブルを作成する必要があることを意味します。このコードの一部は時間依存コレクションクラスに一般化できますが、いくつかの明示的なマッピングコードが必要になります。

例：時間両依存プロパティの実装（Java）

時間両依存プロパティの仕組みを考える前に、それが何をすべきかを考える価値があります。基本的に、時間両依存プロパティを使用すると、履歴情報を長期にわたって保存し、両方の次元で完全な履歴を保持できます。そのため、次のような履歴を構築します。

class 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));
  }

更新のリズムに注目してください。時間両依存履歴を保存する場合、記録日は常に今日です。そのため、テストでは、最初に現在の日付を変更してから、履歴に情報を保存します。履歴に情報を格納するときは、実際の日付を指定します。

結果の履歴は次のようになります。

class 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));
  }

時間依存プロパティの複雑さの多くを時間依存コレクションを使用して実装できるのと同様に、時間両依存プロパティの複雑さの多くを処理するために時間両依存コレクションを定義することもできます。

基本的に、時間両依存コレクションとは、要素が時間依存コレクションである時間依存コレクションです。各時間依存コレクションは、レコード履歴の画像です。

最初に、コレクションから情報を取得する方法を見てみましょう。最新の時間依存コレクションは、記録日が現在である実際の履歴を表しています。そのため、実際の日付のみを持つ取得メソッドはこの現在の実際の履歴を使用します。

class 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は、上記で説明したバニラ時間依存コレクションです。2つの関係については後で説明します。）

真の時間両依存値を取得するには、実際の日付と記録日の両方を持つゲッターを使用します。

class BitemporalCollection...

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

次に、ドメインクラスで時間両依存コレクションを使用できます。

class 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();
  }

コレクションを更新するたびに、実際の履歴の古いコピーを保持する必要があります。

class 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);
  }

時間両依存コレクションは、1次元時間依存コレクションと非常によく似たインターフェースをサポートしています。そのため、時間依存コレクションのインターフェースを作成し、1次元コレクションと2次元コレクションに対して別々の実装を提供できます。これにより、時間両依存コレクションを1次元時間依存コレクションの代わりに使用できるため、1次元時間依存プロパティを時間両依存プロパティに簡単にリファクタリングできます。

この場合、実際の日付と記録日の両方に日付粒度を持つ時間ポイントを使用しています。これにより、例の作成は簡単になりますが、記録時間にはより細かい粒度を使用する方が良い場合があります。ここでの問題は、午後2時にレコードを変更し、午後3時に請求プロセスを実行し、午後4時に再度変更した場合です。現在の実装では、適切な値は完全に失われるわけではありませんが、取得するのは簡単ではありません。ビジネスでよく使用されるもう1つのアプローチは、営業日の終わりにのみ請求などの処理を行い、請求が行われた後はその日にそれ以上の更新を許可しないことです。請求後の更新には、請求が行われた翌日の記録日が付与されます。繰り返しますが、この種の機能は、適切な時間依存コレクションクラスに簡単に追加できます。