15.3.4. 標準のアクティベーションプロパティーのマッピング
ActivationMapper を使用して、多くの administrators プロパティーがアクティベーション設定に自動的にマッピングされます。プロパティー、その場所、およびそれらの目的を以下の表に示します。
| 属性 | 場所 | Description |
|---|---|---|
| maxThreads | jms-listener | 同時に処理できるメッセージの最大数。 |
| dest-name | jms-message-filter | JMS 宛先名。 |
| dest-type | jms-message-filter | JMS 宛先タイプ、QUEUE または TOPIC。 |
| selector | jms-message-filter | JMS メッセージセレクター。 |
| providerAdapterJNDI | jms-jca-provider | JCA インフローがリモート JMS プロバイダーにアクセスするために使用できるプロバイダーアダプターの JNDI の場所。これは、デフォルトの JCA インフローアダプターによってサポートされる JBoss 固有のインターフェイスであり、必要に応じて他のインフローアダプターで使用できます。 |
ActivationMapper. インターフェイスを実装するクラスを指定すると、この動作を過剰に最適化できます。このクラスは、グローバルまたは個別のデプロイメント設定内で宣言できます。
指定された JCA アダプターに使用されるデフォルトのマッパーを定義するため、
jbossesb-properties.xml ファイルでグローバルに指定すると、設定されるプロパティーの名前は org.jboss.soa.esb.jca.activation.mapper.<adapter name> で、値は ActivationMapper のクラス名です。
以下の例は、JBoss JCA アダプター
jms-ra.rar のアクティベーション仕様でプロパティーをマップするために使用されるデフォルトの ActivationMapper の設定を示しています。
<properties name="jca">
<property name="org.jboss.soa.esb.jca.activation.mapper.jms-ra.rar"
value="org.jboss.soa.esb.listeners.jca.JBossActivationMapper"/>
</properties>
<properties name="jca">
<property name="org.jboss.soa.esb.jca.activation.mapper.jms-ra.rar"
value="org.jboss.soa.esb.listeners.jca.JBossActivationMapper"/>
</properties>
デプロイメント内で ActivationMapper を指定すると、グローバル設定が上書きされます。マッパーはリスナー、バス、または優先順位が同じ順序で指定できます。
以下は、リスナー設定内でマッパー設定を指定する例を示しています。
<jms-listener name="listener" busidref="bus" maxThreads="100">
<property name="jcaActivationMapper" value="TestActivationMapper"/>
</jms-listener>
<jms-listener name="listener" busidref="bus" maxThreads="100">
<property name="jcaActivationMapper" value="TestActivationMapper"/>
</jms-listener>
以下は、バス設定内でマッパー設定を指定する方法です。
<jms-bus busid="bus">
<property name="jcaActivationMapper" value="TestActivationMapper"/>
<jms-message-filter dest-type="TOPIC" dest-name="DestName"/>
</jms-bus>
<jms-bus busid="bus">
<property name="jcaActivationMapper" value="TestActivationMapper"/>
<jms-message-filter dest-type="TOPIC" dest-name="DestName"/>
</jms-bus>
以下は、プロバイダー設定内でマッパー設定を指定する方法です。