001: /*
002: * @(#)ConnectionMetaData.java 1.11 02/04/09
003: *
004: * Copyright 1997-2002 Sun Microsystems, Inc. All Rights Reserved.
005: *
006: * SUN PROPRIETARY/CONFIDENTIAL.
007: * This software is the proprietary information of Sun Microsystems, Inc.
008: * Use is subject to license terms.
009: *
010: */
011:
012: package javax.jms;
013:
014: import java.util.Enumeration;
015:
016: /** A <CODE>ConnectionMetaData</CODE> object provides information describing the
017: * <CODE>Connection</CODE> object.
018: *
019: * @version 1.0 - 13 March 1998
020: * @author Mark Hapner
021: * @author Rich Burridge
022: */
023:
024: public interface ConnectionMetaData {
025:
026: /** Gets the JMS API version.
027: *
028: * @return the JMS API version
029: *
030: * @exception JMSException if the JMS provider fails to retrieve the
031: * metadata due to some internal error.
032: */
033:
034: String getJMSVersion() throws JMSException;
035:
036: /** Gets the JMS major version number.
037: *
038: * @return the JMS API major version number
039: *
040: * @exception JMSException if the JMS provider fails to retrieve the
041: * metadata due to some internal error.
042: */
043:
044: int getJMSMajorVersion() throws JMSException;
045:
046: /** Gets the JMS minor version number.
047: *
048: * @return the JMS API minor version number
049: *
050: * @exception JMSException if the JMS provider fails to retrieve the
051: * metadata due to some internal error.
052: */
053:
054: int getJMSMinorVersion() throws JMSException;
055:
056: /** Gets the JMS provider name.
057: *
058: * @return the JMS provider name
059: *
060: * @exception JMSException if the JMS provider fails to retrieve the
061: * metadata due to some internal error.
062: */
063:
064: String getJMSProviderName() throws JMSException;
065:
066: /** Gets the JMS provider version.
067: *
068: * @return the JMS provider version
069: *
070: * @exception JMSException if the JMS provider fails to retrieve the
071: * metadata due to some internal error.
072: */
073:
074: String getProviderVersion() throws JMSException;
075:
076: /** Gets the JMS provider major version number.
077: *
078: * @return the JMS provider major version number
079: *
080: * @exception JMSException if the JMS provider fails to retrieve the
081: * metadata due to some internal error.
082: */
083:
084: int getProviderMajorVersion() throws JMSException;
085:
086: /** Gets the JMS provider minor version number.
087: *
088: * @return the JMS provider minor version number
089: *
090: * @exception JMSException if the JMS provider fails to retrieve the
091: * metadata due to some internal error.
092: */
093:
094: int getProviderMinorVersion() throws JMSException;
095:
096: /** Gets an enumeration of the JMSX property names.
097: *
098: * @return an Enumeration of JMSX property names
099: *
100: * @exception JMSException if the JMS provider fails to retrieve the
101: * metadata due to some internal error.
102: */
103:
104: Enumeration getJMSXPropertyNames() throws JMSException;
105: }
|