001    /**
002     *
003     * Copyright 2003-2004 The Apache Software Foundation
004     *
005     *  Licensed under the Apache License, Version 2.0 (the "License");
006     *  you may not use this file except in compliance with the License.
007     *  You may obtain a copy of the License at
008     *
009     *     http://www.apache.org/licenses/LICENSE-2.0
010     *
011     *  Unless required by applicable law or agreed to in writing, software
012     *  distributed under the License is distributed on an "AS IS" BASIS,
013     *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
014     *  See the License for the specific language governing permissions and
015     *  limitations under the License.
016     */
017    
018    //
019    // This source code implements specifications defined by the Java
020    // Community Process. In order to remain compliant with the specification
021    // DO NOT add / change / or delete method signatures!
022    //
023    
024    package javax.jms;
025    
026    /**
027     * @version $Rev: 46019 $ $Date: 2004-09-14 02:56:06 -0700 (Tue, 14 Sep 2004) $
028     */
029    public interface Connection {
030        Session createSession(boolean transacted, int acknowledgeMode)
031            throws JMSException;
032    
033        String getClientID() throws JMSException;
034    
035        void setClientID(String clientID) throws JMSException;
036    
037        ConnectionMetaData getMetaData() throws JMSException;
038    
039        ExceptionListener getExceptionListener() throws JMSException;
040    
041        void setExceptionListener(ExceptionListener listener) throws JMSException;
042    
043        void start() throws JMSException;
044    
045        void stop() throws JMSException;
046    
047        void close() throws JMSException;
048    
049        ConnectionConsumer createConnectionConsumer(
050            Destination destination,
051            String messageSelector,
052            ServerSessionPool sessionPool,
053            int maxMessages)
054            throws JMSException;
055    
056        ConnectionConsumer createDurableConnectionConsumer(
057            Topic topic,
058            String subscriptionName,
059            String messageSelector,
060            ServerSessionPool sessionPool,
061            int maxMessages)
062            throws JMSException;
063    }