/*
 * @(#)AuthenticationException.java	1.5 05/11/17
 *
 * Copyright 2006 Sun Microsystems, Inc. All rights reserved.
 * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
 */

package javax.security.sasl;

/**
 * This exception is thrown by a SASL mechanism implementation 
 * to indicate that the SASL
 * exchange has failed due to reasons related to authentication, such as 
 * an invalid identity, passphrase, or key.
 * <p>
 * Note that the lack of an AuthenticationException does not mean that
 * the failure was not due to an authentication error.  A SASL mechanism
 * implementation might throw the more general SaslException instead of
 * AuthenticationException if it is unable to determine the nature
 * of the failure, or if does not want to disclose the nature of
 * the failure, for example, due to security reasons.
 *
 * @since 1.5
 *
 * @author Rosanna Lee
 * @author Rob Weltman
 */
public class AuthenticationException extends SaslException {
    /**
     * Constructs a new instance of <tt>AuthenticationException</tt>.
     * The root exception and the detailed message are null.
     */
    public AuthenticationException () {
	super();
    }

    /**
     * Constructs a new instance of <tt>AuthenticationException</tt> 
     * with a detailed message.
     * The root exception is null.
     * @param detail A possibly null string containing details of the exception.
     *
     * @see java.lang.Throwable#getMessage
     */
    public AuthenticationException (String detail) {
	super(detail);
    }

    /**
     * Constructs a new instance of <tt>AuthenticationException</tt> with a detailed message
     * and a root exception.
     *
     * @param detail A possibly null string containing details of the exception.
     * @param ex A possibly null root exception that caused this exception.
     *
     * @see java.lang.Throwable#getMessage
     * @see #getCause
     */
    public AuthenticationException (String detail, Throwable ex) {
	super(detail, ex);
    }

    /** Use serialVersionUID from JSR 28 RI for interoperability */ 
    private static final long serialVersionUID = -3579708765071815007L;
}