KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > com > scalagent > kjoram > TopicSubscriber


1 /*
2  * JORAM: Java(TM) Open Reliable Asynchronous Messaging
3  * Copyright (C) 2001 - ScalAgent Distributed Technologies
4  * Copyright (C) 1996 - Dyade
5  *
6  * This library is free software; you can redistribute it and/or
7  * modify it under the terms of the GNU Lesser General Public
8  * License as published by the Free Software Foundation; either
9  * version 2.1 of the License, or any later version.
10  *
11  * This library is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14  * Lesser General Public License for more details.
15  *
16  * You should have received a copy of the GNU Lesser General Public
17  * License along with this library; if not, write to the Free Software
18  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
19  * USA.
20  *
21  * Initial developer(s): Frederic Maistre (INRIA)
22  * Contributor(s): Nicolas Tachker (ScalAgent)
23  */
24 package com.scalagent.kjoram;
25
26 import com.scalagent.kjoram.excepts.IllegalStateException;
27 import com.scalagent.kjoram.excepts.JMSException;
28
29
30 public class TopicSubscriber extends MessageConsumer
31 {
32   /**
33    * Constructs a subscriber.
34    *
35    * @param sess The session the subscriber belongs to.
36    * @param topic The topic the subscriber subscribes to.
37    * @param name The subscription name, for durable subs only.
38    * @param selector The selector for filtering messages.
39    * @param noLocal <code>true</code> if the subscriber does not wish to
40    * consume messages published through the same connection.
41    *
42    * @exception IllegalStateException If the connection is broken.
43    * @exception JMSException If the creation fails for any other reason.
44    */
45   TopicSubscriber(Session sess, Topic topic, String JavaDoc name, String JavaDoc selector,
46                   boolean noLocal) throws JMSException
47   {
48     super(sess, topic, selector, name, noLocal);
49   }
50
51    /** Returns a string view of this receiver. */
52   public String JavaDoc toString()
53   {
54     return "TopicSub:" + targetName;
55   }
56
57
58   /**
59    * API method.
60    *
61    * @exception IllegalStateException If the subscriber is closed.
62    */
63   public boolean getNoLocal() throws JMSException
64   {
65     if (closed)
66       throw new IllegalStateException JavaDoc("Forbidden call on a closed"
67                                       + " subscriber.");
68     return noLocal;
69   }
70
71   /**
72    * API method.
73    *
74    * @exception IllegalStateException If the subscriber is closed.
75    */
76   public Topic getTopic() throws JMSException
77   {
78     if (closed)
79       throw new IllegalStateException JavaDoc("Forbidden call on a closed"
80                                       + " subscriber.");
81     return (Topic) dest;
82   }
83 }
84
Popular Tags