コントロールのトランザクション

通常のコントロールメソッド、イベントセットメソッド、Web サービスコントロールのコールバックメソッドではトランザクションが使用可能です。このトピックでは、コントロールのトランザクションサポートの概要について説明します。

トランザクションの動作

メソッド、イベントセットメソッド、コールバックメソッドのトランザクションの動作は、@TransactionAttribute アノテーションによって指定されます。以下に、@TransactionAttribute で修飾された Web サービスコールバックの例を示します。

public interface MyServiceControl extends ServiceControl
{

    @ServiceControl.HttpSoapProtocol
    @ServiceControl.SOAPBinding(style = ServiceControl.SOAPBinding.Style.RPC, use = ServiceControl.SOAPBinding.Use.ENCODED)
    @EventSet(unicast=false)
    public interface Callback    {
        @TransactionAttribute(TransactionAttributeType.REQUIRES)
        public void onCallback(java.lang.String message);
    }
  
    public void requestCallback(); 
}

上記の例の TransactionAttributeType.REQUIRES は、トランザクションがコールバックスレッド内で既に開始した場合はそのトランザクションを使用し、それ以外の場合はコールバックメソッドが呼び出される直前に新しいトランザクションを開始するということを意味します。処理の結果に応じて、トランザクションはコミット、ロールバック、ロールバックとしてマークされる (他の場所で開始した場合) のいずれかになります。

@TransactionAttribute には、6 つの有効な設定があります。

REQUIRED - クライアントがトランザクション内で実行中の場合、メソッドまたはコールバックはクライアントのトランザクション内で実行されます。クライアントがトランザクションに関連付けられていない場合は、メソッドまたはコールバックが実行する前に、インターセプタが新しいトランザクションを開始します。ほとんどのコントロールの実行時管理トランザクションでは、REQUIRED が使用されます。これはデフォルトの設定です。

REQUIRES_NEW - クライアントがトランザクション内で実行中の場合、コントロールのランタイムはクライアントのトランザクションをサスペンドし、新しいトランザクションを開始して、メソッドまたはコールバックの呼び出しを委託します。さらに、メソッドまたはコールバックの終了後、クライアントのトランザクションを再開します。クライアントがトランザクションに関連付けられていない場合は、メソッドまたはコールバックが実行する前に、コントロールのランタイムが新しいトランザクションを開始します。

MANDATORY - クライアントがトランザクション内で実行中の場合、メソッドまたはコールバックはクライアントのトランザクション内で実行されます。クライアントがトランザクションに関連付けられていない場合は、コントロールのランタイムが ControlException を送出します。メソッドまたはコールバックがクライアントのトランザクションを使用する必要がある場合は、MANDATORY 属性を使用します。

NOT_SUPPORTED - クライアントがトランザクション内で実行中で、コントロール Bean のメソッドまたはコールバックを呼び出す場合、メソッドまたはコールバックを呼び出す前に、コントロールのランタイムがクライアントのトランザクションをサスペンドします。メソッドまたはコールバックの終了後、コントロールのランタイムはクライアントのトランザクションを再開します。クライアントがトランザクションに関連付けられていない場合は、コントロールのランタイムは、メソッドまたはコールバックが実行する前に新しいトランザクションを開始しません。トランザクションを必要としないメソッドまたはコールバックの場合は、NOT_SUPPORTED 属性を使用します。トランザクションはオーバーヘッドが伴うので、この属性を使用するとパフォーマンスが向上する可能性があります。

SUPPORTS - クライアントがトランザクション内で実行中で、コントロール Bean のメソッドまたはコールバックを呼び出す場合、メソッドまたはコールバックはトランザクション内で実行されます。クライアントがトランザクションに関連付けられていない場合は、コントロールのランタイムは、メソッドまたはコールバックが実行する前に新しいトランザクションを開始しません。メソッドまたはコールバックのトランザクションの動作は常に同じとは限らないので、SUPPORTS 属性は注意して使用する必要があります。

NEVER - クライアントがトランザクション内で実行中で、コントロール Bean のメソッドまたはコールバックを呼び出す場合、コントロールのランタイムは ControlException を送出します。クライアントがトランザクションに関連付けられていない場合は、コントロールのランタイムは、メソッドまたはコールバックが実行する前に新しいトランザクションを開始しません。

例外処理

チェック済み例外 (RuntimeException ではなく Exception のサブクラスの例外) は、他の例外と処理が異なります。

アノテーション属性 rollbackOnCheckedException を使用して、チェック済み例外への応答を制御することができます。

    @TransactionAttribute( rollbackOnCheckedException=<boolean> )

rollbackOnCheckedException が true の場合、コントロールのメソッドまたはコールバックによってチェック済み例外が発生すると、トランザクションはロールバック (またはロールバックとしてマーク) されます。デフォルトでは、rollbackOnCheckedException は false に設定されています。デフォルトの動作は、メソッドまたはコールバック呼び出しによってチェック済み例外が送出される場合でも、トランザクションは自動的にロールバックされないということです。コントロールのメソッドまたはコールバックの呼び出しによってシステム例外 (java.lang.RuntimeException と java.lang.Error のサブクラスの例外) が発生する場合、トランザクションは自動的にロールバック (またはロールバックとしてマーク) されます。