1. /*
  2. * @(#)AuthenticationException.java 1.4 00/02/02
  3. *
  4. * Copyright 1999, 2000 Sun Microsystems, Inc. All Rights Reserved.
  5. *
  6. * This software is the proprietary information of Sun Microsystems, Inc.
  7. * Use is subject to license terms.
  8. *
  9. */
  10. package javax.naming;
  11. /**
  12. * This exception is thrown when an authentication error occurs while
  13. * accessing the naming or directory service.
  14. * An authentication error can happen, for example, when the credentials
  15. * supplied by the user program is invalid or otherwise fails to
  16. * authenticate the user to the naming/directory service.
  17. *<p>
  18. * If the program wants to handle this exception in particular, it
  19. * should catch AuthenticationException explicitly before attempting to
  20. * catch NamingException. After catching AuthenticationException, the
  21. * program could reattempt the authentication by updating
  22. * the resolved context's environment properties with the appropriate
  23. * appropriate credentials.
  24. * <p>
  25. * Synchronization and serialization issues that apply to NamingException
  26. * apply directly here.
  27. *
  28. * @author Rosanna Lee
  29. * @author Scott Seligman
  30. * @version 1.4 00/02/02
  31. * @since 1.3
  32. */
  33. public class AuthenticationException extends NamingSecurityException {
  34. /**
  35. * Constructs a new instance of AuthenticationException using the
  36. * explanation supplied. All other fields default to null.
  37. *
  38. * @param explanation A possibly null string containing
  39. * additional detail about this exception.
  40. * @see java.lang.Throwable#getMessage
  41. */
  42. public AuthenticationException(String explanation) {
  43. super(explanation);
  44. }
  45. /**
  46. * Constructs a new instance of AuthenticationException.
  47. * All fields are set to null.
  48. */
  49. public AuthenticationException() {
  50. super();
  51. }
  52. /**
  53. * Use serialVersionUID from JNDI 1.1.1 for interoperability
  54. */
  55. private static final long serialVersionUID = 3678497619904568096L;
  56. }