jcifs.smb
Class NtlmAuthenticator

java.lang.Object
  jcifs.smb.NtlmAuthenticator

public abstract class NtlmAuthenticator

extends java.lang.Object

This class can be extended by applications that wish to trap authentication related exceptions and automatically retry the exceptional operation with different credentials. Read jCIFS Exceptions and NtlmAuthenticator for complete details.

Constructor Summary

NtlmAuthenticator()

Method Summary

protected NtlmPasswordAuthentication	getNtlmPasswordAuthentication() An application extending this class must provide an implementation for this method that returns new user credentials try try when accessing SMB resources described by the getRequestingURL and getRequestingException methods.
protected SmbAuthException	getRequestingException()
protected java.lang.String	getRequestingURL()
static NtlmPasswordAuthentication	requestNtlmPasswordAuthentication(java.lang.String url, SmbAuthException sae) Used internally by jCIFS when an SmbAuthException is trapped to retrieve new user credentials.
static void	setDefault(NtlmAuthenticator a) Set the default NtlmAuthenticator.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NtlmAuthenticator

public NtlmAuthenticator()

Method Detail

setDefault

public static void setDefault(NtlmAuthenticator a)

Set the default NtlmAuthenticator. Once the default authenticator is set it cannot be changed. Calling this metho again will have no effect.

getRequestingURL

protected final java.lang.String getRequestingURL()

getRequestingException

protected final SmbAuthException getRequestingException()

requestNtlmPasswordAuthentication

public static NtlmPasswordAuthentication requestNtlmPasswordAuthentication(java.lang.String url,
                                                                           SmbAuthException sae)

Used internally by jCIFS when an SmbAuthException is trapped to retrieve new user credentials.

getNtlmPasswordAuthentication

protected NtlmPasswordAuthentication getNtlmPasswordAuthentication()

An application extending this class must provide an implementation for this method that returns new user credentials try try when accessing SMB resources described by the getRequestingURL and getRequestingException methods. If this method returns null the SmbAuthException that triggered the authenticator check will simply be rethrown. The default implementation returns null.