差異調整

例：単一の電力使用量の調整（Java）

ここでは、電力使用量の例をもう一度取り上げて、差異調整でこれを行う方法を示します。基本的な設定コードを次に示します。

class ExampleTester...

  public void setUp() {
      MfDate.setToday(2004, 4, 1);
      watson = sampleCustomer();
      original = new Usage(Unit.KWH.amount(50),
                           new MfDate(2004, 3, 31),
                           watson);
      eventList.add(original);
      eventList.process();
      MfDate.setToday(2004, 6, 1);
      replacement = new Usage(Unit.KWH.amount(70),
                              new MfDate(2004, 3, 31),
                              watson);
      adjustment = new DifferenceAdjustment(replacement, original);
      eventList.add(adjustment);
      eventList.process();
  }

class DifferenceAdjustment…

  public DifferenceAdjustment(MfDate whenOccurred,
                              Subject subject,
                              List<AccountingEvent> oldEvents,
                              List<AccountingEvent> newEvents)
  {
      super(whenOccurred, subject);
      this.oldEvents = oldEvents;
      this.newEvents = newEvents;
  }

この同じサンプルコードは、複数のイベントの調整にも機能しますが、当然ながら設定コードはやや長くなります。

差異調整を行うためのロジックは、調整イベントのプロセスメソッドにあります。

class DifferenceAdjustment…

  public void process() {
      assert !isProcessed;
      adjust();
      markProcessed();
  }
  void adjust() {
      getCustomer().beginAdjustment();
      reverseOldEvents();
      processReplacements();
      getCustomer().commitAdjustment(this);
      recordSecondaryEvents();
  }

調整の基本的なロジックは、シャドウアカウントを構築し、シャドウアカウントで逆転調整を使用して処理を実行し、次に差異調整を転記することです。

最初のステップは、シャドウアカウントを作成することです。

class Customer...

  public void beginAdjustment() {
      assert ! isAdjusting();
      savedRealAccounts = accounts;
      accounts = copyAccounts(savedRealAccounts);
  }
  private boolean isAdjusting() {
      return null != savedRealAccounts;
  }
  public Map<AccountType, Account> copyAccounts(Map<AccountType, Account> from) {
       Map<AccountType, Account> result = new HashMap<AccountType, Account>();
       for (AccountType t : from.keySet()) result.put(t, from.get(t).copy());
       return result;
   }

顧客にシャドウの作成（および後の調整の転記）の責任を負わせました。それは顧客にとって不適切な責任かもしれませんが、調整によってアカウントをコピーすると、顧客の内部構造があまりにも多く公開されてしまいます。これは、システムが責任を処理する方法に依存する決定の1つであり、これについて一般的に言えることはほとんどありません。独自の状況に応じて、シャドウイングの知識がどこに存在するべきかを適切に選択する必要があります。

これで並列モデルで動作するようになったため、元のイベントのすべてのエントリを反転させて置換を処理することにより、逆転調整を使用できます。

class uses...

  void reverseOldEvents() {
      for (AccountingEvent e : oldEvents)
          e.reverse();
  }
  void processReplacements() {
      for (AccountingEvent e : newEvents) e.process();
  }

class AccountingEvent...

  public void reverse() {
      assert isProcessed();
      for (Entry e : getResultingEntries()) reverseEntry(e);
      for(AccountingEvent ev : getSecondaryEvents()) ev.reverse();
  }

  public void reverseEntry(Entry arg) {
      Entry reversingEntry = new Entry(arg.getAmount().negate(), arg.getDate());
      Account targetAccount = subject.accountFor(arg.getAccount().type());
      targetAccount.post(reversingEntry);
   }

ここでの逆転の対象アカウントは、エントリが存在するアカウントと同じアカウントではありません。なぜなら、シャドウエントリではなく、元のイベントを介して到達した実際のエントリを参照しているからです。ただし、逆転エントリはシャドウアカウントに作成する必要があります。

逆転の転記が完了したら、顧客は差異調整を実際のアカウントに転記できます。

class Customer...

  public void commitAdjustment(Adjustment adjustment) {
      assert isAdjusting();
      for (AccountType t : AccountType.values())
           adjustAccount(t, adjustment);
      endShadowAccounts();
  }
  public void adjustAccount(AccountType type, Adjustment adjustment) {
       Account correctedAccount = accounts.get(type);
       Account originalAccount = savedRealAccounts.get(type);
       Money difference = correctedAccount.balance().subtract(originalAccount.balance());
       Entry result = new Entry(difference, MfDate.today());
       originalAccount.post(result);
       adjustment.addResultingEntry(result);
   }
 public void endShadowAccounts() {
      assert isAdjusting();
      accounts = savedRealAccounts;
      savedRealAccounts = null;
  }