クラス JmsMessageEndpointManager
- 実装されたすべてのインターフェース:
Aware
、BeanNameAware
、DisposableBean
、InitializingBean
、Lifecycle
、Phased
、SmartLifecycle
、MessageListenerContainer
GenericMessageEndpointManager
の拡張。ActivationSpec 構成の JMS 固有のサポートを追加します。 エンドポイントをアクティブ化するためにプロバイダー固有の JCA 1.5 ActivationSpec オブジェクトに変換される共通の JmsActivationSpecConfig
オブジェクトを定義できます。
注 : この JCA ベースのエンドポイントマネージャーは、標準の JMS MessageListener
EE エンドポイントのみをサポートしています。JCA エンドポイント管理規約で現在の JMS Session
EE を取得できないため、Spring の SessionAwareMessageListener
バリアントはサポートされていません。
- 導入:
- 2.5
- 作成者:
- Juergen Hoeller, Stephane Nicoll
- 関連事項:
フィールドサマリー
インターフェース org.springframework.context.SmartLifecycle から継承されたフィールド
DEFAULT_PHASE
コンストラクターのサマリー
メソッドのサマリー
修飾子と型メソッド説明void
メッセージエンドポイントを準備し、"autoStartup" フラグが "true" に設定されている場合は自動的にアクティブ化します。このエンドポイントマネージャーがリスナーをアクティブにするために使用する必要があるJmsActivationSpecConfig
オブジェクトを返します。名前で宛先を解決するために使用するDestinationResolver
を返します。Message
EE があれば、それを変換するために使用できるMessageConverter
を返します。このエンドポイントの JMS MessageListener を返します。応答を送信するときに使用するQosSettings
を返すか、ブローカーのデフォルトを使用する必要がある場合はnull
を返します。boolean
パブリッシュ / サブスクライブドメイン(Topics
EE)が使用されているかどうかを返します。boolean
返信先がパブリッシュ / サブスクライブドメイン(Topics
EE)を使用するかどうかを返します。void
setActivationSpecConfig
(JmsActivationSpecConfig activationSpecConfig) このエンドポイントマネージャーがそのリスナをアクティブにするために使用する必要があるJmsActivationSpecConfig
オブジェクトを指定します。void
setActivationSpecFactory
(JmsActivationSpecFactory activationSpecFactory) 具体的な JCA 1.5 ActivationSpec オブジェクトのファクトリを設定し、JmsActivationSpecConfig
オブジェクトに基づいて JCA ActivationSpecs を作成します。void
setBeanName
(StringSE beanName) このメッセージエンドポイントの名前を設定します。void
setDestinationResolver
(DestinationResolver destinationResolver) 宛先名の解決に使用する DestinationResolver を JCA 1.5 ActivationSpec の「宛先」プロパティに設定します。void
setMessageListener
(MessageListenerEE messageListener) このエンドポイントの JMS MessageListener を設定します。void
setTransactionManager
(ObjectSE transactionManager) エンドポイント呼び出しのラップに使用する XA トランザクションマネージャーを設定し、そのような各トランザクションにエンドポイントリソースを参加させます。void
setupMessageListener
(ObjectSE messageListener) 使用するメッセージリスナーを設定します。クラス org.springframework.jca.endpoint.GenericMessageEndpointManager から継承されたメソッド
destroy, getActivationSpec, getMessageEndpointFactory, getPhase, getResourceAdapter, isAutoStartup, isRunning, setActivationSpec, setAutoStartup, setMessageEndpointFactory, setPhase, setResourceAdapter, start, stop, stop
クラス java.lang.ObjectSE から継承されたメソッド
clone, equalsSE, finalize, getClass, hashCode, notify, notifyAll, toString, wait, waitSE, waitSE
インターフェース org.springframework.context.SmartLifecycle から継承されたメソッド
getPhase, isAutoStartup, stop
コンストラクターの詳細
JmsMessageEndpointManager
public JmsMessageEndpointManager()
メソッドの詳細
setMessageListener
このエンドポイントの JMS MessageListener を設定します。これは、専用 JmsMessageEndpointFactory を構成するためのショートカットです。
getMessageListener
このエンドポイントの JMS MessageListener を返します。setTransactionManager
エンドポイント呼び出しのラップに使用する XA トランザクションマネージャーを設定し、そのような各トランザクションにエンドポイントリソースを参加させます。渡されるオブジェクトは、Spring の
TransactionFactory
インターフェースを実装するトランザクションマネージャー、またはプレーンなTransactionManager
EE です。トランザクションマネージャーが指定されていない場合、エンドポイント呼び出しは XA トランザクションにラップされません。特定のプロバイダーのローカルトランザクションオプションについては、リソースプロバイダーの ActivationSpec ドキュメントを参照してください。
これは、専用 JmsMessageEndpointFactory を構成するためのショートカットです。
setActivationSpecFactory
具体的な JCA 1.5 ActivationSpec オブジェクトのファクトリを設定し、JmsActivationSpecConfig
オブジェクトに基づいて JCA ActivationSpecs を作成します。このファクトリは、具体的な JMS プロバイダ (たとえば ActiveMQ) に依存します。デフォルトの実装では、プロバイダのクラス名から ActivationSpec のクラス名を推測し (たとえば同じパッケージの "ActiveMQResourceAdapter" → "ActiveMQActivationSpec" )、JCA 1.5 仕様の ActivationSpec 属性 (さらにいくつかの自動検出型ベンダー固有属性) を設定します。
setDestinationResolver
宛先名の解決に使用する DestinationResolver を JCA 1.5 ActivationSpec の「宛先」プロパティに設定します。指定しない場合、宛先名は単に文字列として渡されます。指定した場合、宛先名は最初に Destination オブジェクトに解決されます。
DestinationResolver は通常 JmsActivationSpecFactory で指定されることに注意してください(
StandardJmsActivationSpecFactory.setDestinationResolver(org.springframework.jms.support.destination.DestinationResolver)
を参照)。これは、デフォルトの JmsActivationSpecFactory をパラメーター化するためのショートカットです。以前に設定された可能性があるカスタム JmsActivationSpecFactory を置き換えます。setActivationSpecConfig
このエンドポイントマネージャーがそのリスナをアクティブにするために使用する必要があるJmsActivationSpecConfig
オブジェクトを指定します。この構成オブジェクトは、
JmsActivationSpecFactory
を介して具象 JCA 1.5 ActivationSpec オブジェクトに変換されます。getActivationSpecConfig
このエンドポイントマネージャーがリスナーをアクティブにするために使用する必要があるJmsActivationSpecConfig
オブジェクトを返します。何も設定されていない場合はnull
を返します。setBeanName
このメッセージエンドポイントの名前を設定します。Spring の Bean ファクトリ内で定義されると、Bean 名が自動的に入力されます。- 次で指定:
- インターフェース
BeanNameAware
のsetBeanName
- パラメーター:
beanName
- ファクトリ内の Bean の名前。この名前は、ファクトリで使用される実際の Bean 名であり、最初に指定した名前とは異なる場合があります。特に内部 Bean 名の場合、実際の Bean 名は "#..." サフィックスを追加することで一意になります。必要に応じて、BeanFactoryUtils.originalBeanName(String)
メソッドを使用して、元の Bean 名(サフィックスなし)を抽出します。
afterPropertiesSet
クラスからコピーされた説明:GenericMessageEndpointManager
メッセージエンドポイントを準備し、"autoStartup" フラグが "true" に設定されている場合は自動的にアクティブ化します。- 次で指定:
- インターフェース
InitializingBean
のafterPropertiesSet
- オーバーライド:
- クラス
GenericMessageEndpointManager
のafterPropertiesSet
- 例外:
ResourceExceptionEE
setupMessageListener
インターフェースからコピーされた説明:MessageListenerContainer
使用するメッセージリスナーを設定します。そのメッセージリスナー型がサポートされていない場合、IllegalArgumentException
SE をスローします。- 次で指定:
- インターフェース
MessageListenerContainer
のsetupMessageListener
getMessageConverter
インターフェースからコピーされた説明:MessageListenerContainer
Message
EE があれば、それを変換するために使用できるMessageConverter
を返します。- 次で指定:
- インターフェース
MessageListenerContainer
のgetMessageConverter
getDestinationResolver
インターフェースからコピーされた説明:MessageListenerContainer
名前で宛先を解決するために使用するDestinationResolver
を返します。- 次で指定:
- インターフェース
MessageListenerContainer
のgetDestinationResolver
isPubSubDomain
public boolean isPubSubDomain()インターフェースからコピーされた説明:MessageListenerContainer
- 次で指定:
- インターフェース
MessageListenerContainer
のisPubSubDomain
isReplyPubSubDomain
public boolean isReplyPubSubDomain()インターフェースからコピーされた説明:MessageListenerContainer
返信先がパブリッシュ / サブスクライブドメイン(Topics
EE)を使用するかどうかを返します。それ以外の場合は、ポイントツーポイントドメイン(Queues
EE)が使用されます。デフォルトでは、値は
MessageListenerContainer.isPubSubDomain()
と同じです。- 次で指定:
- インターフェース
MessageListenerContainer
のisReplyPubSubDomain
getReplyQosSettings
インターフェースからコピーされた説明:MessageListenerContainer
応答を送信するときに使用するQosSettings
を返すか、ブローカーのデフォルトを使用する必要がある場合はnull
を返します。- 次で指定:
- インターフェース
MessageListenerContainer
のgetReplyQosSettings