01: /*
02: * @(#)QueueConnectionFactory.java 1.14 02/04/23
03: *
04: * Copyright 1997-2002 Sun Microsystems, Inc. All Rights Reserved.
05: *
06: * SUN PROPRIETARY/CONFIDENTIAL.
07: * This software is the proprietary information of Sun Microsystems, Inc.
08: * Use is subject to license terms.
09: *
10: */
11:
12: package javax.jms;
13:
14: /** A client uses a <CODE>QueueConnectionFactory</CODE> object to create
15: * <CODE>QueueConnection</CODE> objects with a point-to-point JMS provider.
16: *
17: * <P><CODE>QueueConnectionFactory</CODE> can be used to create a
18: * <CODE>QueueConnection</CODE>, from which specialized queue-related objects
19: * can be created. A more general, and recommended, approach
20: * is to use the <CODE>ConnectionFactory</CODE> object.
21: *
22: *<P> The <CODE>QueueConnectionFactory</CODE> object
23: * can be used to support existing code that already uses it.
24: *
25: * @version 1.1 - February 2, 2002
26: * @author Mark Hapner
27: * @author Rich Burridge
28: * @author Kate Stout
29: *
30: * @see javax.jms.ConnectionFactory
31: */
32:
33: public interface QueueConnectionFactory extends ConnectionFactory {
34:
35: /** Creates a queue connection with the default user identity.
36: * The connection is created in stopped mode. No messages
37: * will be delivered until the <code>Connection.start</code> method
38: * is explicitly called.
39: *
40: .
41: *
42: * @return a newly created queue connection
43: *
44: * @exception JMSException if the JMS provider fails to create the queue
45: * connection due to some internal error.
46: * @exception JMSSecurityException if client authentication fails due to
47: * an invalid user name or password.
48: */
49:
50: QueueConnection createQueueConnection() throws JMSException;
51:
52: /** Creates a queue connection with the specified user identity.
53: * The connection is created in stopped mode. No messages
54: * will be delivered until the <code>Connection.start</code> method
55: * is explicitly called.
56: *
57: * @param userName the caller's user name
58: * @param password the caller's password
59: *
60: * @return a newly created queue connection
61: *
62: * @exception JMSException if the JMS provider fails to create the queue
63: * connection due to some internal error.
64: * @exception JMSSecurityException if client authentication fails due to
65: * an invalid user name or password.
66: */
67:
68: QueueConnection createQueueConnection(String userName,
69: String password) throws JMSException;
70: }
|