org.opengion.fukurou.db

## インタフェース Transaction

- 既知の実装クラスのリスト:
    TransactionImpl, TransactionReal

      public interface Transaction

       コネクションを共有して、トランザクションを実現するインターフェースです。

       基本的には、TransactionTag で利用されますが、一部、このオブジェクトを
       渡して、直接、利用するケースもあります。

       トランザクション の実クラスには、リアルタイムで commit,rollback を行う、
       TransactionReal クラスと、内部にキャッシュされた コネクションを、終了時点で
       一括処理を行う、TransactionImpl があります。
       TransactionTag で利用するのが、TransactionImpl で、トランザクション処理を行わない
       ケースで利用するのが、TransactionReal クラスになります。
       TransactionReal クラス は、トランザクション処理を｢行わない｣場合に、共通ロジックを
       提供するために用意されたクラスです。

  変更履歴:

    5.1.9.0 (2010/08/01) 新規作成

  バージョン
    5.0
  作成者
    Kazuhiko Hasegawa
  導入されたバージョン:
    JDK6.0,

- - ### メソッドのサマリー

    All Methods Instance Methods Abstract Methods
    修飾子とタイプ | メソッドと説明
    --- | ---
    `boolean` | `close()` トランザクションの、終了時処理を行います。
    `boolean` | `close(boolean errFlag)` トランザクションの、終了時処理を行います。
    `boolean` | `commit()` コミット処理が行われた場合に、内部フラグ(isCommit)を true にセットします。
    `Connection` | `getConnection(String dbid)` 指定のDBID に対応した、Connection オブジェクトを返します。
    `boolean` | `rollback()` ロールバック処理が行われた場合に、内部フラグ(isRollback)を true にセットします。

- - ### メソッドの詳細

    - #### getConnection

          Connection getConnection(String dbid)

      指定のDBID に対応した、Connection オブジェクトを返します。 内部Mapに存在していれば、そのコネクションを、存在しなければ、 新しく作成します。
      パラメータ:
        `dbid` - 接続先ID
      戻り値:
        指定のDBID に対応した、コネクションオブジェクト

    - #### commit

          boolean commit()

      コミット処理が行われた場合に、内部フラグ(isCommit)を true にセットします。 １回でもコミットが行われており、ロールバックが行われていなければ、 コミットされます。 検索処理のみで、エラーが発生していない場合は、コミットも行われないケースがあります。
      戻り値:
        正常:true/異常:false

    - #### rollback

          boolean rollback()

      ロールバック処理が行われた場合に、内部フラグ(isRollback)を true にセットします。 １回でもロールバックが行われていれば、最終的にはロールバックされます。
      戻り値:
        正常:true/異常:false

    - #### close

          boolean close()

      トランザクションの、終了時処理を行います。 それまでの処理は、すべて正常に処理できた場合に、使用します。 close( false ) と同じです。
      戻り値:
        正常:true/異常:false
      関連項目:
        `close( boolean )`

    - #### close

          boolean close(boolean errFlag)

      トランザクションの、終了時処理を行います。 引数は、正常かどうかを判定するフラグです。異常の場合は、true をセットします。 ここでは、実際には何もしませんが、内部的にエラーフラグをセットします。 (エラーの場合のみセット。リセットはされません) 一度でも、エラーが発生したコネクションは、破棄します。それ以外は、プールに戻します。
      パラメータ:
        `errFlag` - エラー状態 [true:/false:通常]
      戻り値:
        正常:true/異常:false

Webアプリケーションフレームワーク openGion
Copyright (c) 2009 The openGion Project.