24.2. Java Connector Architecture (JCA) サブシステムの設定

JBoss EAP 6 設定ファイルの JCA サブシステムは、JCA コンテナおよびリソースアダプターデプロイメントの一般的な設定を制御します。
JCA サブシステムの主な要素

アーカイブの検証
  • この設定はデプロイメントユニット上でアーカイブの検証が実行されるかどうかを決定します。
  • アーカイブの検証に設定できる属性は下表のとおりです。

    表24.1 アーカイブ検証の属性

    属性デフォルト値説明
    enabledtrue
    アーカイブバリデーションが有効であるかどうかを指定します。
    fail-on-errortrue
    アーカイブバリデーションのエラーレポートによってデプロイメントが失敗するかどうかを指定します
    fail-on-warnfalse
    アーカイブバリデーションの警告レポートによってデプロイメントが失敗するかどうかを指定します。
  • アーカイブ検証が有効な状態で、アーカイブが Java EE Connector Architecture 仕様を正しく実装しない場合、デプロイメント中に問題を説明するエラーメッセージが表示されます。例は次のとおりです。
    Severity: ERROR
    Section: 19.4.2 
    Description: A ResourceAdapter must implement a "public int hashCode()" method. 
    Code: com.mycompany.myproject.ResourceAdapterImpl
    
    Severity: ERROR
    Section: 19.4.2
    Description: A ResourceAdapter must implement a "public boolean equals(Object)" method.
    Code: com.mycompany.myproject.ResourceAdapterImpl
  • アーカイブ検証が指定されていない場合は、アーカイブ検証が指定されているとみなされ、enabled 属性のデフォルトが true に設定されます。
Bean の検証
  • この設定はデプロイメントユニット上で Bean の検証 (JSR-303) が実行されるかどうかを決定します。
  • Bean の検証に設定できる属性は下表のとおりです。

    表24.2 Bean 検証の属性

    属性デフォルト値説明
    enabledtrue
    Bean バリデーションが有効であるかどうかを指定します。
  • Bean 検証が指定されていない場合は、Bean 検証が指定されているとみなされ、enabled 属性のデフォルトが true に設定されます。
ワークマネージャー
  • ワークマネージャーには次の 2 種類があります。
    デフォルトワークマネージャー
    デフォルトのワークマネージャーおよびそのスレッドプール。
    カスタムワークマネージャー
    カスタムワークマネージャーの定義およびそのスレッドプール。
  • ワークマネージャーに設定できる属性は下表のとおりです。

    表24.3 ワークマネージャーの属性

    属性説明
    name
    ワークマネージャーの名前を指定します。カスタムワークマネージャーは必須になります。
    short-running-threads
    標準の Work インスタンスのスレッドプール。ワークマネージャーごとに短時間実行されるスレッドプールが 1 つあります。
    long-running-threads
    LONG_RUNNING ヒントを設定する JCA 1.6 Work インスタンスのスレッドプール。各ワークマネージャーはオプションの長期スレッドプールを 1 つ持てます。
  • ワークマネージャーのスレッドプールに設定できる属性は下表のとおりです。

    表24.4 スレッドプールの属性

    属性説明
    allow-core-timeout
    コアスレッドがタイムアウトするかどうかを決定するブール値の設定。デフォルト値は false です。
    core-threads
    コアスレッドプールのサイズ。スレッドプールの最大サイズより小さくなければなりません。
    queue-length
    キューの最大長。
    max-thread
    スレッドプールの最大サイズ。
    keepalive-time
    ワーク実行後にスレッドプールが保持される期間を指定します。
    thread-factory
    スレッドファクトリーへの参照。
ブートストラップコンテキスト
  • カスタムのブートストラップコンテキストを定義するために使用されます。
  • ブートストラップコンテキストに設定できる属性は下表のとおりです。

    表24.5 ブートストラップコンテキストの属性

    属性説明
    name
    ブートストラップコンテキストの名前を指定します。
    workmanager
    このコンテキストに使用するワークマネージャーの名前を指定します。
キャッシュ済み接続マネージャー
  • 接続のデバッグ、およびトランザクションにおける接続の lazy enlistment のサポートに使用されます。また、接続がアプリケーションによって適切に使用およびリリースされるかどうかを追跡します。
  • キャッシュ済みの接続マネージャーに設定できる属性は下表のとおりです。

    表24.6 キャッシュ済み接続マネージャーの属性

    属性デフォルト値説明
    debugfalse
    接続を明示的に閉じるため、障害時に警告を出力します。
    errorfalse
    接続を明示的に閉じるため、障害時に例外が発生します。

手順24.1 管理コンソールを使用した JCA サブシステムの設定

JBoss EAP 6 の JCA サブシステムは、管理コンソールで設定できます。JCA 設定オプションは、サーバーがどのように実行されているかに応じて、管理コンソールの若干異なる場所に存在します。JCA 設定オプションは、どのようにサーバーが実行されているかに応じて、管理コンソールでの場所が若干異なります。
  1. 画面上部にある Configuration タブをクリックします。Connector メニューを展開し、JCA を選択します。
  2. サーバーがドメインモードで稼働している場合は、左上の Profiles ドロップダウンメニューからプロファイルを選択します。
  3. 3 つのタブを使用して JCA サブシステムを設定します。
    1. 共通設定

      Common Config タブには、キャッシュ済み接続マネージャー、アーカイブ検証、および Bean 検証 (JSR-303) の設定が含まれます。また、これらの各設定は独自のタブに含まれます。これらの設定を変更するには、適切なタブを開き、編集ボタンをクリックして必要な変更を行い、保存ボタンをクリックします。
      JCA 共通設定

      図24.1 JCA 共通設定

    2. ワークマネージャー

      Work Manager タブには、設定されたワークマネージャーのリストが含まれます。新しいワークマネージャーを追加および削除でき、スレッドプールをここで設定できます。各ワークマネージャーは短時間実行されるスレッドプールを 1 つ持つことができ、任意で長時間実行されるスレッドプールを 1 つ持つことができます。
      ワークマネージャー

      図24.2 ワークマネージャー

      選択したリソースアダプターで View をクリックすると、スレッドプール属性を設定できます。
      ワークマネージャースレッドプール

      図24.3 ワークマネージャースレッドプール

    3. ブートストラップコンテキスト

      Bootstrap Contexts タブには、設定されたブートストラップコンテキストのリストが含まれます。新しいブートストラップコンテキストオブジェクトを追加、削除、および設定できます。各ブートストラップコンテキストをワークマネージャーに割り当てる必要があります。
      ブートストラップコンテキスト

      図24.4 ブートストラップコンテキスト