1. /*
  2. * Copyright 2002 Sun Microsystems, Inc. All rights reserved.
  3. * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
  4. */
  5. package javax.jms;
  6. /** An <CODE>XAQueueConnectionFactory</CODE> provides the same create options as
  7. * a <CODE>QueueConnectionFactory</CODE> (optional).
  8. *
  9. * @version 1.0 - 14 May 1998
  10. * @author Mark Hapner
  11. * @author Rich Burridge
  12. *
  13. * @see javax.jms.QueueConnectionFactory
  14. * @see javax.jms.XAConnectionFactory
  15. */
  16. public interface XAQueueConnectionFactory
  17. extends XAConnectionFactory, QueueConnectionFactory {
  18. /** Creates an XA queue connection with the default user identity.
  19. * The connection is created in stopped mode. No messages
  20. * will be delivered until the <code>Connection.start</code> method
  21. * is explicitly called.
  22. *
  23. * @return a newly created XA queue connection
  24. *
  25. * @exception JMSException if the JMS provider fails to create an XA queue
  26. * connection due to some internal error.
  27. * @exception JMSSecurityException if client authentication fails due to
  28. * an invalid user name or password.
  29. */
  30. XAQueueConnection
  31. createXAQueueConnection() throws JMSException;
  32. /** Creates an XA queue connection with the specified user identity.
  33. * The connection is created in stopped mode. No messages
  34. * will be delivered until the <code>Connection.start</code> method
  35. * is explicitly called.
  36. *
  37. * @param userName the caller's user name
  38. * @param password the caller's password
  39. *
  40. * @return a newly created XA queue connection
  41. *
  42. * @exception JMSException if the JMS provider fails to create an XA queue
  43. * connection due to some internal error.
  44. * @exception JMSSecurityException if client authentication fails due to
  45. * an invalid user name or password.
  46. */
  47. XAQueueConnection
  48. createXAQueueConnection(String userName, String password)
  49. throws JMSException;
  50. }