会計トランザクション

例：2本立ての例（Java）

2本立てと多本立ての両方のケースのサンプルコードを示します。まずは簡単な2本立てのケースから始めます。

実際、2本立てのケースでは、単純な会計トランザクションオブジェクトが必要です。

public class AccountingTransaction {
  private Collection entries = new HashSet();
  public AccountingTransaction(Money amount, Account from, Account to, MfDate date) {
    Entry fromEntry = new Entry (amount.negate(), date);
    from.addEntry(fromEntry);
    entries.add(fromEntry);
    Entry toEntry = new Entry (amount, date);
    to.addEntry(toEntry);
    entries.add(toEntry);
  }

これにより、トランザクション処理以外の方法で項目を作成できないように、項目のコンストラクターを制限する必要があります。Javaでは、これはコンストラクターのパッケージアクセスとコーディング規約の組み合わせです。

会計トランザクションコンストラクターを直接使用するのではなく、勘定オブジェクトに適切なメソッドを提供することが理にかなっています。

  void withdraw(Money amount, Account target, MfDate date) {
    new AccountingTransaction (amount, this, target, date);
  }

これにより、操作のコードがはるかに扱いやすくなります。

public void testBalanceUsingTransactions() {
  revenue = new Account(Currency.USD);
  deferred = new Account(Currency.USD);
  receivables = new Account(Currency.USD);
  revenue.withdraw(Money.dollars(500), receivables, new MfDate(1,4,99));
  revenue.withdraw(Money.dollars(200), deferred, new MfDate(1,4,99));
  assertEquals(Money.dollars(500), receivables.balance());
  assertEquals(Money.dollars(200), deferred.balance());
  assertEquals(Money.dollars(-700), revenue.balance());
}

例：多本立ての例（Java）

多本立てトランザクションの作成には労力がかかり、検証が必要なため、多本立てのケースははるかに厄介です。この場合、Proposed Objectを使用して、トランザクションを徐々に組み立て、すべての部品が揃ったら勘定に転記します。

このアプローチでは、個別のメソッド呼び出しを通じてトランザクションに項目を追加できる必要があります。すべてのトランザクションが揃ったら、トランザクションを勘定に転記できます。転記する前に、すべての項目の合計がゼロになることを確認する必要があります。転記したら、トランザクションに項目を追加することはできなくなります。

フィールドとコンストラクターからコードを公開します。

public class AccountingTransaction {
    private MfDate date;
    private Collection entries = new HashSet();
    private boolean wasPosted = false;
    public AccountingTransaction(MfDate date) {
    this.date = date;
    }

この例では、トランザクション全体に1つの日付を使用しています。これは古い英国の銀行では対応できませんが、説明を少し簡単にすることができます。

addメソッドは、トランザクションがまだ転記されていない場合に、トランザクションに項目を追加します。

class Transaction...
  public void add (Money amount, Account account) {
    if (wasPosted) throw new ImmutableTransactionException
          ("cannot add entry to a transaction that's already posted");
    entries.add(new Entry (amount, date, account, this));
  }

この場合、項目とトランザクションと勘定の両方との間の双方向の関連付けを維持するために、異なる項目クラスを使用しています。（項目は不変なので、双方向リンクの維持がはるかに簡単になります。）

class Entry...
    private Money amount;
    private MfDate date;
    private Account account;
    private AccountingTransaction transaction;
    Entry(Money amount, MfDate date, Account account, AccountingTransaction transaction) {
    // only used by AccountingTransaction
    this.amount = amount;
    this.date = date;
    this.account = account;
    this.transaction = transaction;
    }

トランザクションに項目を追加したら、トランザクションを転記できます。

class AccountingTransaction...
  public void post() {
    if (!canPost())
      throw new UnableToPostException();
    Iterator it = entries.iterator();
    while (it.hasNext()) {
      Entry each = (Entry) it.next();
      each.post();
    }
    wasPosted = true;
    }
    public boolean canPost(){
    return balance().isZero();
    }
    private Money balance() {
    if (entries.isEmpty()) return Money.dollars(0);
    Iterator it = entries.iterator();
    Entry firstEntry = (Entry) it.next();
    Money result = firstEntry.amount();
    while (it.hasNext()) {
      Entry each = (Entry) it.next();
      result = result.add(each.amount());
    }
    return result;
    }
class Entry...
  void post() {
    // only used by AccountingTransaction
    account.addEntry(this);
    }

その後、次のようなコードでトランザクションを使用できます。

    AccountingTransaction multi = new AccountingTransaction(new MfDate(2000,1,4));
    multi.add(Money.dollars(-700), revenue);
    multi.add(Money.dollars(500), receivables);
    multi.add(Money.dollars(200), deferred);
    multi.post();
    assertEquals(Money.dollars(500), receivables.balance());
    assertEquals(Money.dollars(200), deferred.balance());
    assertEquals(Money.dollars(-700), revenue.balance());

このような設定と転記の手順は、多本立てトランザクションの使用が非常に厄介である理由を示しています。良いニュースは、一部の時間に2本立てトランザクションしか必要ない場合、多本立てトランザクションを使用して2本立てインターフェースを実装できることです。

class Account...
  void withdraw(Money amount, Account target, MfDate date) {
    AccountingTransaction trans = new AccountingTransaction(date);
    trans.add(amount.negate(), this);
    trans.add(amount, target);
    trans.post();
    }