Open Source Repository

Home /spring/spring-jms-3.0.5 | Repository Home



org/springframework/jms/listener/SimpleMessageListenerContainer102.java
/*
 * Copyright 2002-2009 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.springframework.jms.listener;

import javax.jms.Connection;
import javax.jms.Destination;
import javax.jms.JMSException;
import javax.jms.MessageConsumer;
import javax.jms.Queue;
import javax.jms.QueueConnection;
import javax.jms.QueueConnectionFactory;
import javax.jms.QueueSession;
import javax.jms.Session;
import javax.jms.Topic;
import javax.jms.TopicConnection;
import javax.jms.TopicConnectionFactory;
import javax.jms.TopicSession;

/**
 * A subclass of {@link SimpleMessageListenerContainer} for the JMS 1.0.2 specification,
 * not relying on JMS 1.1 methods like SimpleMessageListenerContainer itself.
 *
 <p>This class can be used for JMS 1.0.2 providers, offering the same facility as
 * SimpleMessageListenerContainer does for JMS 1.1 providers.
 *
 @author Juergen Hoeller
 @since 2.0
 @deprecated as of Spring 3.0, in favor of the JMS 1.1 based {@link SimpleMessageListenerContainer}
 */
@Deprecated
public class SimpleMessageListenerContainer102 extends SimpleMessageListenerContainer {

  /**
   * This implementation overrides the superclass method to use JMS 1.0.2 API.
   */
  protected Connection createConnection() throws JMSException {
    if (isPubSubDomain()) {
      return ((TopicConnectionFactorygetConnectionFactory()).createTopicConnection();
    }
    else {
      return ((QueueConnectionFactorygetConnectionFactory()).createQueueConnection();
    }
  }

  /**
   * This implementation overrides the superclass method to use JMS 1.0.2 API.
   */
  protected Session createSession(Connection conthrows JMSException {
    if (isPubSubDomain()) {
      return ((TopicConnectioncon).createTopicSession(isSessionTransacted(), getSessionAcknowledgeMode());
    }
    else {
      return ((QueueConnectioncon).createQueueSession(isSessionTransacted(), getSessionAcknowledgeMode());
    }
  }

  /**
   * This implementation overrides the superclass method to use JMS 1.0.2 API.
   */
  protected MessageConsumer createConsumer(Session session, Destination destinationthrows JMSException {
    if (isPubSubDomain()) {
      if (isSubscriptionDurable()) {
        return ((TopicSessionsession).createDurableSubscriber(
            (Topicdestination, getDurableSubscriptionName(), getMessageSelector(), isPubSubNoLocal());
      }
      else {
        return ((TopicSessionsession).createSubscriber(
            (Topicdestination, getMessageSelector(), isPubSubNoLocal());
      }
    }
    else {
      return ((QueueSessionsession).createReceiver((Queuedestination, getMessageSelector());
    }
  }

  /**
   * This implementation overrides the superclass method to avoid using
   * JMS 1.1's Session <code>getAcknowledgeMode()</code> method.
   * The best we can do here is to check the setting on the listener container.
   */
  protected boolean isClientAcknowledge(Session sessionthrows JMSException {
    return (getSessionAcknowledgeMode() == Session.CLIENT_ACKNOWLEDGE);
  }

}