FileDocCategorySizeDatePackage
NtlmAuthenticator.javaAPI DocJCIFS 1.3.17 API2939Tue Oct 18 15:26:24 BST 2011jcifs.smb

NtlmAuthenticator

public abstract class NtlmAuthenticator extends 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.

Fields Summary
private static NtlmAuthenticator
auth
private String
url
private SmbAuthException
sae
Constructors Summary
Methods Summary
protected NtlmPasswordAuthenticationgetNtlmPasswordAuthentication()
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.

        return null;
    
protected final SmbAuthExceptiongetRequestingException()

        return sae;
    
protected final java.lang.StringgetRequestingURL()

        return url;
    
public static NtlmPasswordAuthenticationrequestNtlmPasswordAuthentication(java.lang.String url, SmbAuthException sae)
Used internally by jCIFS when an SmbAuthException is trapped to retrieve new user credentials.

        if( auth == null ) {
            return null;
        }
        synchronized( auth ) {
            auth.url = url;
            auth.sae = sae;
            return auth.getNtlmPasswordAuthentication();
        }
    
private voidreset()

        url = null;
        sae = null;
    
public static synchronized voidsetDefault(jcifs.smb.NtlmAuthenticator a)
Set the default NtlmAuthenticator. Once the default authenticator is set it cannot be changed. Calling this metho again will have no effect.

        if( auth != null ) {
            return;
        }
        auth = a;