KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > mr > api > jms > MantaQueueConnection


1 /*
2  * Copyright 2002 by
3  * <a HREF="http://www.coridan.com">Coridan</a>
4  * <a HREF="mailto: support@coridan.com ">support@coridan.com</a>
5  *
6  * The contents of this file are subject to the Mozilla Public License Version
7  * 1.1 (the "License"); you may not use this file except in compliance with the
8  * License. You may obtain a copy of the License at
9  * http://www.mozilla.org/MPL/
10  *
11  * Software distributed under the License is distributed on an "AS IS" basis,
12  * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
13  * for the specific language governing rights and limitations under the
14  * License.
15  *
16  * The Original Code is "MantaRay" (TM).
17  *
18  * The Initial Developer of the Original Code is Nimo .
19  * Portions created by the Initial Developer are Copyright (C) 2006
20  * Coridan Inc. All Rights Reserved.
21  *
22  * Contributor(s): all the names of the contributors are added in the source
23  * code where applicable.
24  *
25  * Alternatively, the contents of this file may be used under the terms of the
26  * LGPL license (the "GNU LESSER GENERAL PUBLIC LICENSE"), in which case the
27  * provisions of LGPL are applicable instead of those above. If you wish to
28  * allow use of your version of this file only under the terms of the LGPL
29  * License and not to allow others to use your version of this file under
30  * the MPL, indicate your decision by deleting the provisions above and
31  * replace them with the notice and other provisions required by the LGPL.
32  * If you do not delete the provisions above, a recipient may use your version
33  * of this file under either the MPL or the GNU LESSER GENERAL PUBLIC LICENSE.
34  
35  *
36  * This library is free software; you can redistribute it and/or modify it
37  * under the terms of the MPL as stated above or under the terms of the GNU
38  * Lesser General Public License as published by the Free Software Foundation;
39  * either version 2.1 of the License, or any later version.
40  *
41  * This library is distributed in the hope that it will be useful, but WITHOUT
42  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
43  * FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
44  * License for more details.
45  */
46 package org.mr.api.jms;
47
48
49 import java.io.Serializable JavaDoc;
50
51 import javax.jms.ConnectionConsumer JavaDoc;
52 import javax.jms.IllegalStateException JavaDoc;
53 import javax.jms.JMSException JavaDoc;
54 import javax.jms.QueueSession JavaDoc;
55 import javax.jms.ServerSessionPool JavaDoc;
56 import javax.jms.Topic JavaDoc;
57
58
59 /**
60  * A <CODE>QueueConnection</CODE> object is an active connection to a
61  * point-to-point JMS provider. A client uses a <CODE>QueueConnection</CODE>
62  * object to create one or more <CODE>QueueSession</CODE> objects for
63  * producing and consuming messages.
64  *
65  * <P>
66  * A <CODE>QueueConnection</CODE> can be used to create a <CODE>QueueSession
67  * </CODE>, from which specialized queue-related objects can be created. A
68  * more general, and recommended, approach is to use the <CODE>Connection
69  * </CODE> object.
70  *
71  *
72  * <P>
73  * The <CODE>QueueConnection</CODE> object should be used to support existing
74  * code that has already used it.
75  *
76  * <P>
77  * A <CODE>QueueConnection</CODE> cannot be used to create objects specific
78  * to the publish/subscribe domain. The <CODE>createDurableConnectionConsumer
79  * </CODE> method inherits from <CODE>Connection</CODE>, but must throw an
80  * <CODE>IllegalStateException</CODE> if used from <CODE>QueueConnection
81  * </CODE>.
82  *
83  * @author Nimo
84  *
85  */
86 public class MantaQueueConnection extends MantaConnection implements Serializable JavaDoc, javax.jms.QueueConnection JavaDoc {
87     
88     /**
89      * Constructors for use on the specific p2p messaging domain.
90      * These constructors delegate the creation to the <CODE>MantaConnection</CODE>
91      * class and retain no specific behavior by themselves.
92      * @param factory
93      * @throws JMSException
94      */
95     MantaQueueConnection(MantaConnectionFactory factory) throws JMSException JavaDoc {
96         super(factory);
97     }//MantaQueueConnection
98
99     /**
100      * Constructs a new QueueConnection.
101      *
102      * @param factory - the creating factory
103      * @param userName - user
104      * @param password - password
105      * @throws JMSException
106      */
107     MantaQueueConnection(MantaConnectionFactory factory, String JavaDoc userName, String JavaDoc password) throws JMSException JavaDoc {
108         super(factory, userName, password);
109     }//MantaQueueConnection
110
111     /**
112      * Creates a QueueSession for this connection.
113      */
114     public QueueSession JavaDoc createQueueSession(boolean trx, int acknowledgeMode) throws JMSException JavaDoc {
115         checkLegalOperation();
116
117         MantaQueueSession sess = new MantaQueueSession(messageChannel.getMessageId(),this,
118                 trx,acknowledgeMode);
119         addSession(sess);
120         return sess;
121     }
122     /**
123      * From spec:
124      * Since this class extends the MantaConnection class, it must have
125      * this method. When p2p is on the line, this method must throw an exception.
126      *
127      */
128     public ConnectionConsumer JavaDoc createDurableConnectionConsumer(Topic JavaDoc topic, String JavaDoc subscriptionName, String JavaDoc messageSelector, ServerSessionPool JavaDoc sessionPool, int maxMessages) throws JMSException JavaDoc{
129         throw new IllegalStateException JavaDoc("MNJMS00018 : CAN NOT CREATE A DURABLE SUBSCRIPTION ON A QUEUE. FAILED IN METHOD createDurableConnectionConsumer()");
130     }
131
132     
133 }//MantaQueueConnection
134
Popular Tags