01: /*
02: * MessageQueueClient: The message queue client library
03: * Copyright (C) 2006 Rift IT Contracting
04: *
05: * This library is free software; you can redistribute it and/or
06: * modify it under the terms of the GNU Lesser General Public
07: * License as published by the Free Software Foundation; either
08: * version 2.1 of the License, or (at your option) any later version.
09: *
10: * This library is distributed in the hope that it will be useful,
11: * but WITHOUT ANY WARRANTY; without even the implied warranty of
12: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13: * Lesser General Public License for more details.
14: *
15: * You should have received a copy of the GNU Lesser General Public
16: * License along with this library; if not, write to the Free Software
17: * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
18: *
19: * QueueManager.java
20: */
21:
22: // package path
23: package com.rift.coad.daemon.messageservice;
24:
25: // java imports
26: import java.rmi.Remote;
27: import java.rmi.RemoteException;
28:
29: /**
30: * The QueueManager supplies access to the named queues.
31: * @author Brett Chaldecott
32: */
33: public interface QueueManager extends Remote {
34:
35: /**
36: * The jndi url for the message queue manager.
37: */
38: public final static String JNDI_URL = "message/QueueManager";
39:
40: // class constants
41: public final static String DEAD_LETTER = "DEAD_LETTER";
42:
43: /**
44: * This method returns the queue specified by the name. If the queue does
45: * not exist it gets created.
46: *
47: * @return The queue identified by the name.
48: * @param name The name of the queue to retrieve.
49: * @exception RemoteException
50: * @exception MessageServiceException
51: */
52: public NamedQueue getNamedQueue(String name)
53: throws RemoteException, MessageServiceException;
54: }
|