/*
 * JBoss, the OpenSource EJB server
 *
 * Distributable under LGPL license.
 * See terms of license at gnu.org.
 */

package javax.resource.cci;

import javax.resource.ResourceException;

/**
 * The ConnectionMetaData provides information about the underlying
 * resources for the connection.
 */

public interface ConnectionMetaData {

    /**
     * Gets the product name of the underlying resource for the connection.
     * @return Product name of underlying resource.
     */
    public String getEISProductName() throws ResourceException;


    /**
     * Gets the product version of the underlying resource for the connection.
     * @return Product version name of underlying resource.
     */
    public String getEISProductVersion() throws ResourceException;


    /**
     * Gets the user name for the connection to the underlying resource
     * as known to the underlying resource.  This name corresponds to
     * the principal under whose context the connection was first made.
     * @return Product name of underlying resource.
     */
    public String getUserName() throws ResourceException;
}