Apcoordinator ユーザーズガイド

4.8.1 トランザクション管理機能が提供する機能

トランザクション管理機能は、Apcoordinatorがトランザクションの開始、コミット、ロールバックを制御する機能です。アプリケーションでトランザクションの開始、終了をプログラムする必要がなく、トランザクションの制御が容易になります。

トランザクション管理機能を使用すると、Apcoordinatorは次のようにトランザクションを制御します。

• ビジネスクラスのメソッドのうちコマンドマップで指定されたもの(以降、ビジネスメソッドと呼びます)を呼び出す直前にトランザクションを開始します。
• 呼び出したビジネスメソッドが正常に終了した場合には、トランザクションをコミットします。
• 以下の場合にはトランザクションをロールバックします。
  • ビジネスメソッドがロールバック例外を発生した場合。デフォルトでは、以下がロールバック例外として使用されます。設定によりロールバック例外を追加することが可能です。
    • java.lang.RuntimeExceptionとそのサブクラス
    • java.lang.Errorとそのサブクラス
  • com.fujitsu.uji.DispatchContextクラスのsetRollbackOnlyメソッドが呼び出された場合。この場合、ビジネスメソッドがロールバック例外を発生しなくても、ビジネスメソッドの終了後にトランザクションをロールバックします。例外を発生させずにロールバックさせたい場合にこのsetRollbackOnlyを使用します。
  • ビジネスクラス再試行機能を使用しており、ビジネスクラスが再試行される場合。

Apcoordinatorで管理できるのは、 以下のインタフェースによって制御できるトランザクションです。

javax.transaction.UserTransactionインタフェース

UserTransactionはトランザクション制御用のインタフェースであり、JTA(Java Transaction API)仕様によって定義されています。 一般に、EJB, JMS, JDBCのトランザクションを制御する場合に使用します。

java.sql.Connectionインタフェース

データベースとの接続を表すインタフェースであり、JDBC仕様で定義されています。アプリケーションサーバに依存せずに直接データベースにアクセスする場合に使用します。

上記以外のインタフェースについては、アダプタを作成することによってApcoordinatorで管理できる場合があります。アダプタの作成方法はJDBCのトランザクションの制御で説明します。

デフォルトでは、UserTransactionインタフェースによってトランザクションを制御します。java.sql.Connectionインタフェースによる制御を利用する方法はJDBCのトランザクションの制御で説明します。

UserTransactionインタフェースによるトランザクション制御を選択し、 アプリケーションサーバとしてInterstageを使用する場合、トランザクションを連携させることのできるアプリケーションの種別と、トランザクションで制御できるリソースは以下のようになります。

• トランザクションを連携させることのできるアプリケーションの種別: 以下の組み合わせの場合は、呼び出し元が開始したトランザクション上で呼び出し先のアプリケーションを実行させることができます。

  呼び出し元のアプリケーション	呼び出し先のアプリケーション
  	分散トランザクションを使用しない場合	分散トランザクションを使用する場合
  Webアプリケーション 電子フォームアプリケーション 携帯端末対応アプリケーション	呼び出し元と同じIJServer上のEJB (*1)(*2)	(分散トランザクションは使用できません)
  EJBセションBean	呼び出し元と同じIJServer上のEJB (*1)	同一マシン内のIJServer上で動作するEJB (*1)(*3)
  SOAPサーバアプリケーション	呼び出し元と同じIJServer上のEJB (*1)(*2)	(分散トランザクションは使用できません)

  (*1) 呼び出されるEJBが、呼び出し元のトランザクション上で動作するように設定されている必要があります。そのため、呼び出されるEJBのトランザクション管理種別はContainerに設定し、トランザクション属性はMandatory, Required, Supportsのいずれかに設定します。
  (*2) IJServerのタイプとして「WebアプリケーションとEJBアプリケーションを同一JavaVMで運用」を使用します。
  (*3) 呼び出し元と呼び出し先のIJServerは以下のどちらかのタイプである必要があります。また、両方で分散トランザクションを使用するように設定が必要です。
  • EJBアプリケーションのみ運用
  • WebアプリケーションとEJBアプリケーションを別JavaVMで運用
  
  
• トランザクションで制御できるリソース: トランザクションを開始してから終了するまでの間に使用できるリソースは以下のとおりです。使用したリソースは、トランザクションによる制御の対象となります。

  分散トランザクションの使用有無	トランザクションで制御できるリソース
  使用しない	JDBCデータソース (*1)(*2)
  使用する	JDBCデータソース (*3) JMSコネクションファクトリ (*3) connectorコネクションファクトリ (*3)

  (*1)トランザクションを開始してから終了するまでの間に使用できるデータソースは1個のみです。また、そのデータソースを2回以上使用する場合は、同一のユーザIDとパスワードを使用する必要があります。
  (*2)InterstageにJDBCデータソースを登録する必要があります。登録にはInterstage管理コンソールを使用します。
  (*3)Interstageにリソースを登録する必要があります。また、そのリソースは分散トランザクション連携が可能である必要があります。リソースの登録にはInterstage管理コンソールを使用します。

トランザクションに参加できるリソースは、アプリケーションサーバなどの実行環境に依存します。