パッケージ org.springframework.jms.support

クラス JmsAccessor

java.lang.ObjectSE
org.springframework.jms.support.JmsAccessor
実装されているすべてのインターフェース:
InitializingBean
既知の直属サブクラス
JmsDestinationAccessor
public abstract class JmsAccessor extends ObjectSE implements InitializingBean
JmsTemplate およびその他の JMS アクセスゲートウェイヘルパーの基本クラス。操作する JMS ConnectionFactoryEE などの共通プロパティを定義します。サブクラス JmsDestinationAccessor は、宛先関連のプロパティをさらに追加します。

直接使用するためのものではありません。JmsTemplate を参照してください。

導入:
1.2
作成者:
Juergen Hoeller, Sam Brannen
関連事項:

  • フィールドの詳細

    • logger

      protected final Log logger
      サブクラスで利用可能なロガー。

  • コンストラクターの詳細

    • JmsAccessor

      public JmsAccessor()

  • メソッドの詳細

    • setConnectionFactory

      public void setConnectionFactory(@Nullable ConnectionFactoryEE connectionFactory)
      JMS ConnectionsEE の取得に使用する ConnectionFactory を設定します。

    • getConnectionFactory

      @Nullable public ConnectionFactoryEE getConnectionFactory()
      このアクセッサが JMS ConnectionsEE を取得するために使用する ConnectionFactory を返します。

    • obtainConnectionFactory

      protected final ConnectionFactoryEE obtainConnectionFactory()
      実際に使用するために ConnectionFactory を取得します。
      戻り値:
      ConnectionFactory (非 null)
      例外:
      IllegalStateExceptionSE - ConnectionFactory セットがない場合
      導入:
      5.0

    • setSessionTransacted

      public void setSessionTransacted(boolean sessionTransacted)
      JMS SessionEE の作成時に使用されるトランザクションモードを設定します。デフォルトは "false" です。

      JTA トランザクション内では、create(Queue/Topic)Session(boolean transacted, int acknowledgeMode) メソッドに渡されたパラメーターは考慮されないことに注意してください。Jakarta EE トランザクションコンテキストに応じて、コンテナーはこれらの値に対して独自の決定を行います。同様に、これらのパラメーターは、ローカルで管理されるトランザクション内でも考慮されません。これは、この場合、アクセサーが既存の JMS セッションを操作するためです。

      このフラグを "true" に設定すると、管理対象トランザクションの外部で実行する場合は短いローカル JMS トランザクションが使用され、管理対象トランザクション（XA トランザクション以外）が存在する場合は同期されたローカル JMS トランザクションが使用されます。これには、ローカル JMS トランザクションがメイントランザクション（ネイティブ JDBC トランザクションの場合もあります）と一緒に管理され、JMS トランザクションがメイントランザクションの直後にコミットされるという効果があります。

      関連事項:

    • isSessionTransacted

      public boolean isSessionTransacted()
      このアクセサーによって使用される JMS sessionsEE がトランザクションされることになっているかどうかを返します。
      関連事項:

    • setSessionAcknowledgeModeName

      public void setSessionAcknowledgeModeName(StringSE constantName)
      JMS SessionEE インターフェースの対応する定数の名前によって JMS 確認応答モードを設定します。たとえば、"CLIENT_ACKNOWLEDGE"。

      確認応答モードにベンダー固有の拡張機能を使用する場合は、代わりに setSessionAcknowledgeMode(int) を使用してください。

      パラメーター:
      constantName - SessionEE 確認モード定数の名前
      関連事項:

    • setSessionAcknowledgeMode

      public void setSessionAcknowledgeMode(int sessionAcknowledgeMode)
      JMS SessionEE を作成してメッセージを送信するときに使用される JMS 確認モードを設定します。

      デフォルトは Session.AUTO_ACKNOWLEDGEEE です。

      確認応答モードのベンダー固有の拡張機能もここで設定できます。

      EJB の内部では、create(Queue/Topic)Session(boolean transacted, int acknowledgeMode) メソッドのパラメーターは考慮されないことに注意してください。EJB のトランザクションコンテキストに応じて、コンテナーはこれらの値を独自に決定します。EJB 仕様のセクション 17.3.5 を参照してください。

      パラメーター:
      sessionAcknowledgeMode - 確認応答モード定数
      関連事項:

    • getSessionAcknowledgeMode

      public int getSessionAcknowledgeMode()
      JMS sessionsEE の確認応答モードを返します。

    • afterPropertiesSet

      public void afterPropertiesSet()
      インターフェースからコピーされた説明: InitializingBean
      すべての Bean プロパティを設定し、BeanFactoryAware、ApplicationContextAware などを満たした後、包含 BeanFactory によって呼び出されます。

      このメソッドにより、Bean インスタンスは、すべての Bean プロパティが設定されたときに、その全体的な構成の検証と最終的な初期化を実行できます。

      次で指定:
      インターフェース InitializingBean の afterPropertiesSet 

    • convertJmsAccessException

      protected JmsException convertJmsAccessException(JMSExceptionEE ex)
      指定されたチェック済み JMSExceptionEE を Spring ランタイム JmsException 同等物に変換します。

      デフォルトの実装は、JmsUtils.convertJmsAccessException(jakarta.jms.JMSException) メソッドに委譲します。

      パラメーター:
      ex - 変換する元のチェック済み JMSExceptionEE
      戻り値:
      ex をラップする Spring ランタイム JmsException
      関連事項:

    • createConnection

      protected ConnectionEE createConnection() throws JMSExceptionEE
      このテンプレートの ConnectionFactory を介して JMS 接続を作成します。

      この実装では、JMS 1.1 API を使用します。

      戻り値:
      新しい JMS 接続
      例外:
      JMSExceptionEE - JMS API メソッドによってスローされた場合
      関連事項:

    • createSession

      protected SessionEE createSession(ConnectionEE con) throws JMSExceptionEE
      指定された接続の JMS セッションを作成します。

      この実装では、JMS 1.1 API を使用します。

      パラメーター:
      con - セッションを作成する JMS 接続
      戻り値:
      新しい JMS セッション
      例外:
      JMSExceptionEE - JMS API メソッドによってスローされた場合
      関連事項:

    • isClientAcknowledge

      protected boolean isClientAcknowledge(SessionEE session) throws JMSExceptionEE
      指定されたセッションがクライアント確認モードにあるかどうかを判別します。

      この実装では、JMS 1.1 API を使用します。

      パラメーター:
      session - チェックする JMS セッション
      戻り値:
      指定されたセッションがクライアント確認モードにあるかどうか
      例外:
      JMSExceptionEE - JMS API メソッドによってスローされた場合
      関連事項: