Build 1.0_r1(from source)

java.net
Class Authenticator

java.lang.Object
  extended by java.net.Authenticator

public abstract class Authenticator
extends Object

This class is able to obtain authentication info for a connection, usually from user. First the application has to set the default authenticator which extends Authenticator by setDefault(Authenticator a).

It should override getPasswordAuthentication() which dictates how the authentication info should be obtained.

See Also:
setDefault(java.net.Authenticator), getPasswordAuthentication()

Nested Class Summary
static class Authenticator.RequestorType
          an enum class of requestor type
 
Constructor Summary
Authenticator()
           
 
Method Summary
protected  PasswordAuthentication getPasswordAuthentication()
          This method is responsible for retrieving the username and password for the sender.
protected  String getRequestingHost()
          Return the host name of the connection that requests authentication, or null if unknown.
protected  int getRequestingPort()
          Returns the port of the connection that requests authorization.
protected  String getRequestingPrompt()
          Returns the realm (prompt string) of the connection that requires authorization.
protected  String getRequestingProtocol()
          Returns the protocol of the connection that requests authorization.
protected  String getRequestingScheme()
          Returns the scheme of the connection that requires authorization.
protected  InetAddress getRequestingSite()
          Returns the address of the connection that requests authorization or null if unknown.
protected  URL getRequestingURL()
          returns the URL of the authentication resulted in this request.
protected  Authenticator.RequestorType getRequestorType()
          returns the type of this request, it can be proxy or server
static PasswordAuthentication requestPasswordAuthentication(InetAddress rAddr, int rPort, String rProtocol, String rPrompt, String rScheme)
          If the permission check of the security manager does not result in a security exception, this method invokes the methods of the registered authenticator to get the authentication info.
static PasswordAuthentication requestPasswordAuthentication(String rHost, InetAddress rAddr, int rPort, String rProtocol, String rPrompt, String rScheme)
          If the permission check of the security manager does not result in a security exception, this method invokes the methods of the registered authenticator to get the authentication info.
static PasswordAuthentication requestPasswordAuthentication(String rHost, InetAddress rAddr, int rPort, String rProtocol, String rPrompt, String rScheme, URL rURL, Authenticator.RequestorType reqType)
          If the permission check of the security manager does not result in a security exception, this method invokes the methods of the registered authenticator to get the authentication info.
static void setDefault(Authenticator a)
          This method sets a to be the default authenticator.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Authenticator

public Authenticator()
Method Detail

getPasswordAuthentication

protected PasswordAuthentication getPasswordAuthentication()
This method is responsible for retrieving the username and password for the sender. The implementation varies. The subclass has to overwrite this.

It returns null by default.

Returns:
java.net.PasswordAuthentication The password authentication that it obtains

getRequestingPort

protected final int getRequestingPort()
Returns the port of the connection that requests authorization.

Returns:
int the port of the connection

getRequestingSite

protected final InetAddress getRequestingSite()
Returns the address of the connection that requests authorization or null if unknown.

Returns:
InetAddress the address of the connection

getRequestingPrompt

protected final String getRequestingPrompt()
Returns the realm (prompt string) of the connection that requires authorization.

Returns:
java.lang.String the prompt string of the connection

getRequestingProtocol

protected final String getRequestingProtocol()
Returns the protocol of the connection that requests authorization.

Returns:
java.lang.String the protocol of connection

getRequestingScheme

protected final String getRequestingScheme()
Returns the scheme of the connection that requires authorization. Eg. Basic

Returns:
java.lang.String the scheme of the connection

requestPasswordAuthentication

public static PasswordAuthentication requestPasswordAuthentication(InetAddress rAddr,
                                                                   int rPort,
                                                                   String rProtocol,
                                                                   String rPrompt,
                                                                   String rScheme)
If the permission check of the security manager does not result in a security exception, this method invokes the methods of the registered authenticator to get the authentication info.

Parameters:
rAddr - java.net.InetAddress the address of the connection that requests authentication
rPort - int the port of the connection that requests authentication
rProtocol - java.lang.String the protocol of the connection that requests authentication
rPrompt - java.lang.String the realm of the connection that requests authentication
rScheme - java.lang.String the scheme of the connection that requests authentication
Returns:
java.net.PasswordAuthentication the authentication info
Throws:
SecurityException - if requestPasswordAuthenticationPermission is denied

setDefault

public static void setDefault(Authenticator a)
This method sets a to be the default authenticator. It will be called whenever the realm that the URL is pointing to requires authorization. If there is a security manager set then the caller must have the NetPermission "setDefaultAuthenticator".

Parameters:
a - java.net.Authenticator The authenticator to be set.
Throws:
SecurityException - if requestPasswordAuthenticationPermission is denied

requestPasswordAuthentication

public static PasswordAuthentication requestPasswordAuthentication(String rHost,
                                                                   InetAddress rAddr,
                                                                   int rPort,
                                                                   String rProtocol,
                                                                   String rPrompt,
                                                                   String rScheme)
If the permission check of the security manager does not result in a security exception, this method invokes the methods of the registered authenticator to get the authentication info.

Parameters:
rHost - java.lang.String the host name of the connection that requests authentication
rAddr - java.net.InetAddress the address of the connection that requests authentication
rPort - int the port of the connection that requests authentication
rProtocol - java.lang.String the protocol of the connection that requests authentication
rPrompt - java.lang.String the realm of the connection that requests authentication
rScheme - java.lang.String the scheme of the connection that requests authentication
Returns:
java.net.PasswordAuthentication the authentication info
Throws:
SecurityException - if requestPasswordAuthenticationPermission is denied

getRequestingHost

protected final String getRequestingHost()
Return the host name of the connection that requests authentication, or null if unknown.


requestPasswordAuthentication

public static PasswordAuthentication requestPasswordAuthentication(String rHost,
                                                                   InetAddress rAddr,
                                                                   int rPort,
                                                                   String rProtocol,
                                                                   String rPrompt,
                                                                   String rScheme,
                                                                   URL rURL,
                                                                   Authenticator.RequestorType reqType)
If the permission check of the security manager does not result in a security exception, this method invokes the methods of the registered authenticator to get the authentication info.

Parameters:
rHost - java.lang.String the host name of the connection that requests authentication
rAddr - java.net.InetAddress the address of the connection that requests authentication
rPort - int the port of the connection that requests authentication
rProtocol - java.lang.String the protocol of the connection that requests authentication
rPrompt - java.lang.String the realm of the connection that requests authentication
rScheme - java.lang.String the scheme of the connection that requests authentication
rURL - java.net.URL the url of the connection that requests authentication
reqType - java.net.Authenticator.RequestorType the RequestorType of the connection that requests authentication
Returns:
java.net.PasswordAuthentication the authentication info
Throws:
SecurityException - if requestPasswordAuthenticationPermission is denied

getRequestingURL

protected URL getRequestingURL()
returns the URL of the authentication resulted in this request.

Returns:
the url of request

getRequestorType

protected Authenticator.RequestorType getRequestorType()
returns the type of this request, it can be proxy or server

Returns:
RequestorType of request

Build 1.0_r1(from source)

Please submit a feedback, bug or feature