AuthenticationNotSupportedException (Java 2 Platform SE 5.0) (original) (raw)

javax.naming

Class AuthenticationNotSupportedException

java.lang.Object extended by java.lang.Throwable java.lang.Exception javax.naming.NamingException javax.naming.NamingSecurityException javax.naming.AuthenticationNotSupportedException

All Implemented Interfaces:

Serializable

public class AuthenticationNotSupportedException

extends NamingSecurityException

This exception is thrown when the particular flavor of authentication requested is not supported. For example, if the program is attempting to use strong authentication but the directory/naming supports only simple authentication, this exception would be thrown. Identification of a particular flavor of authentication is provider- and server-specific. It may be specified using specific authentication schemes such those identified using SASL, or a generic authentication specifier (such as "simple" and "strong").

If the program wants to handle this exception in particular, it should catch AuthenticationNotSupportedException explicitly before attempting to catch NamingException. After catchingAuthenticationNotSupportedException, the program could reattempt the authentication using a different authentication flavor by updating the resolved context's environment properties accordingly.

Synchronization and serialization issues that apply to NamingException apply directly here.

Since:

1.3

See Also:

Serialized Form

Field Summary

Fields inherited from class javax.naming.NamingException
remainingName, resolvedName, resolvedObj, rootException

Constructor Summary
AuthenticationNotSupportedException() Constructs a new instance of AuthenticationNotSupportedException all name resolution fields and explanation initialized to null.
AuthenticationNotSupportedException(String explanation) Constructs a new instance of AuthenticationNotSupportedException using an explanation.

Method Summary

Methods inherited from class javax.naming.NamingException
appendRemainingComponent, appendRemainingName, getCause, getExplanation, getRemainingName, getResolvedName, getResolvedObj, getRootCause, initCause, setRemainingName, setResolvedName, setResolvedObj, setRootCause, toString, toString

Methods inherited from class java.lang.Throwable
fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, [wait](../../java/lang/Object.html#wait%28long, int%29)

Constructor Detail

AuthenticationNotSupportedException

public AuthenticationNotSupportedException(String explanation)

Constructs a new instance of AuthenticationNotSupportedException using an explanation. All other fields default to null.

Parameters:

explanation - A possibly null string containing additional detail about this exception.

See Also:

Throwable.getMessage()

AuthenticationNotSupportedException

public AuthenticationNotSupportedException()

Constructs a new instance of AuthenticationNotSupportedException all name resolution fields and explanation initialized to null.

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.