1. /*

  2.  * Copyright 2002 Sun Microsystems, Inc. All rights reserved.

  3.  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

  4.  */

  5. 

  6. package javax.jms;

  7. 

  8. import java.util.Enumeration;

  9. 

  10. /** A <CODE>ConnectionMetaData</CODE> object provides information describing the 

  11.   * <CODE>Connection</CODE> object.

  12.   *

  13.   * @version     1.0 - 13 March 1998

  14.   * @author      Mark Hapner

  15.   * @author      Rich Burridge

  16.   */

  17. 

  18. public interface ConnectionMetaData {

  19. 

  20.     /** Gets the JMS API version.

  21.       *

  22.       * @return the JMS API version

  23.       *  

  24.       * @exception JMSException if the JMS provider fails to retrieve the

  25.       *                         metadata due to some internal error.

  26.       */

  27. 

  28.     String 

  29.     getJMSVersion() throws JMSException;

  30. 

  31. 

  32.     /** Gets the JMS major version number.

  33.       *  

  34.       * @return the JMS API major version number

  35.       *  

  36.       * @exception JMSException if the JMS provider fails to retrieve the

  37.       *                         metadata due to some internal error.

  38.       */

  39. 

  40.     int 

  41.     getJMSMajorVersion() throws JMSException; 

  42.  

  43. 

  44.     /** Gets the JMS minor version number.

  45.       *  

  46.       * @return the JMS API minor version number

  47.       *  

  48.       * @exception JMSException if the JMS provider fails to retrieve the

  49.       *                         metadata due to some internal error.

  50.       */

  51. 

  52.     int  

  53.     getJMSMinorVersion() throws JMSException;

  54. 

  55. 

  56.     /** Gets the JMS provider name.

  57.       *

  58.       * @return the JMS provider name

  59.       *  

  60.       * @exception JMSException if the JMS provider fails to retrieve the

  61.       *                         metadata due to some internal error.

  62.       */ 

  63. 

  64.     String 

  65.     getJMSProviderName() throws JMSException;

  66. 

  67. 

  68.     /** Gets the JMS provider version.

  69.       *

  70.       * @return the JMS provider version

  71.       *  

  72.       * @exception JMSException if the JMS provider fails to retrieve the

  73.       *                         metadata due to some internal error.

  74.       */ 

  75. 

  76.     String 

  77.     getProviderVersion() throws JMSException;

  78. 

  79. 

  80.     /** Gets the JMS provider major version number.

  81.       *  

  82.       * @return the JMS provider major version number

  83.       *  

  84.       * @exception JMSException if the JMS provider fails to retrieve the

  85.       *                         metadata due to some internal error.

  86.       */

  87. 

  88.     int

  89.     getProviderMajorVersion() throws JMSException; 

  90. 

  91.  

  92.     /** Gets the JMS provider minor version number.

  93.       *  

  94.       * @return the JMS provider minor version number

  95.       *  

  96.       * @exception JMSException if the JMS provider fails to retrieve the

  97.       *                         metadata due to some internal error.

  98.       */

  99. 

  100.     int  

  101.     getProviderMinorVersion() throws JMSException;

  102. 

  103.  

  104.     /** Gets an enumeration of the JMSX property names.

  105.       *  

  106.       * @return an Enumeration of JMSX property names

  107.       *  

  108.       * @exception JMSException if the JMS provider fails to retrieve the

  109.       *                         metadata due to some internal error.

  110.       */

  111. 

  112.     Enumeration

  113.     getJMSXPropertyNames() throws JMSException;

  114. }