KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > javax > naming > AuthenticationNotSupportedException


1 /*
2  * @(#)AuthenticationNotSupportedException.java 1.7 03/12/19
3  *
4  * Copyright 2004 Sun Microsystems, Inc. All rights reserved.
5  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.
6  */

7
8 package javax.naming;
9
10 /**
11   * This exception is thrown when
12   * the particular flavor of authentication requested is not supported.
13   * For example, if the program
14   * is attempting to use strong authentication but the directory/naming
15   * supports only simple authentication, this exception would be thrown.
16   * Identification of a particular flavor of authentication is
17   * provider- and server-specific. It may be specified using
18   * specific authentication schemes such
19   * those identified using SASL, or a generic authentication specifier
20   * (such as "simple" and "strong").
21   *<p>
22   * If the program wants to handle this exception in particular, it
23   * should catch AuthenticationNotSupportedException explicitly before
24   * attempting to catch NamingException. After catching
25   * <code>AuthenticationNotSupportedException</code>, the program could
26   * reattempt the authentication using a different authentication flavor
27   * by updating the resolved context's environment properties accordingly.
28   * <p>
29   * Synchronization and serialization issues that apply to NamingException
30   * apply directly here.
31   *
32   * @author Rosanna Lee
33   * @author Scott Seligman
34   * @version 1.7 03/12/19
35   * @since 1.3
36   */

37
38 public class AuthenticationNotSupportedException extends NamingSecurityException JavaDoc {
39     /**
40      * Constructs a new instance of AuthenticationNotSupportedException using
41      * an explanation. All other fields default to null.
42      *
43      * @param explanation A possibly null string containing additional
44      * detail about this exception.
45      * @see java.lang.Throwable#getMessage
46      */

47     public AuthenticationNotSupportedException(String JavaDoc explanation) {
48     super(explanation);
49     }
50
51     /**
52       * Constructs a new instance of AuthenticationNotSupportedException
53       * all name resolution fields and explanation initialized to null.
54       */

55     public AuthenticationNotSupportedException() {
56     super();
57     }
58
59     /**
60      * Use serialVersionUID from JNDI 1.1.1 for interoperability
61      */

62     private static final long serialVersionUID = -7149033933259492300L;
63 }
64
Popular Tags