001: /*
002: * JBoss, Home of Professional Open Source.
003: * Copyright 2006, Red Hat Middleware LLC, and individual contributors
004: * as indicated by the @author tags. See the copyright.txt file in the
005: * distribution for a full listing of individual contributors.
006: *
007: * This is free software; you can redistribute it and/or modify it
008: * under the terms of the GNU Lesser General Public License as
009: * published by the Free Software Foundation; either version 2.1 of
010: * the License, or (at your option) any later version.
011: *
012: * This software is distributed in the hope that it will be useful,
013: * but WITHOUT ANY WARRANTY; without even the implied warranty of
014: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
015: * Lesser General Public License for more details.
016: *
017: * You should have received a copy of the GNU Lesser General Public
018: * License along with this software; if not, write to the Free
019: * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
020: * 02110-1301 USA, or see the FSF site: http://www.fsf.org.
021: */
022: package javax.jms;
023:
024: import java.util.Enumeration;
025:
026: /** A <CODE>ConnectionMetaData</CODE> object provides information describing the
027: * <CODE>Connection</CODE> object.
028: */
029:
030: public interface ConnectionMetaData {
031:
032: /** Gets the JMS API version.
033: *
034: * @return the JMS API version
035: *
036: * @exception JMSException if the JMS provider fails to retrieve the
037: * metadata due to some internal error.
038: */
039: public String getJMSVersion() throws JMSException;
040:
041: /** Gets the JMS major version number.
042: *
043: * @return the JMS API major version number
044: *
045: * @exception JMSException if the JMS provider fails to retrieve the
046: * metadata due to some internal error.
047: */
048: public int getJMSMajorVersion() throws JMSException;
049:
050: /** Gets the JMS minor version number.
051: *
052: * @return the JMS API minor version number
053: *
054: * @exception JMSException if the JMS provider fails to retrieve the
055: * metadata due to some internal error.
056: */
057: public int getJMSMinorVersion() throws JMSException;
058:
059: /** Gets the JMS provider name.
060: *
061: * @return the JMS provider name
062: *
063: * @exception JMSException if the JMS provider fails to retrieve the
064: * metadata due to some internal error.
065: */
066: public String getJMSProviderName() throws JMSException;
067:
068: /** Gets the JMS provider version.
069: *
070: * @return the JMS provider version
071: *
072: * @exception JMSException if the JMS provider fails to retrieve the
073: * metadata due to some internal error.
074: */
075: public String getProviderVersion() throws JMSException;
076:
077: /** Gets the JMS provider major version number.
078: *
079: * @return the JMS provider major version number
080: *
081: * @exception JMSException if the JMS provider fails to retrieve the
082: * metadata due to some internal error.
083: */
084: public 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: public int getProviderMinorVersion() throws JMSException;
094:
095: /** Gets an enumeration of the JMSX property names.
096: *
097: * @return an Enumeration of JMSX property names
098: *
099: * @exception JMSException if the JMS provider fails to retrieve the
100: * metadata due to some internal error.
101: */
102: public Enumeration getJMSXPropertyNames() throws JMSException;
103: }
|