Package java.net

Class Authenticator

java.lang.Object
java.net.Authenticator
public abstract class Authenticator
extends Object
An implementation of this class is able to obtain authentication information for a connection in several ways. For this purpose it has to set the default authenticator which extends Authenticator by setDefault(Authenticator a). Then it should override getPasswordAuthentication() which dictates how the authentication info is obtained. Usually, it prompts the user for the required input.
See Also:
setDefault(java.net.Authenticator), getPasswordAuthentication()

  • Constructor Details

    • Authenticator

      public Authenticator()

  • Method Details

    • getPasswordAuthentication

      protected PasswordAuthentication getPasswordAuthentication()
      Returns the collected username and password for authorization. The subclass has to override this method to return a value different to the default which is null.

      Returns null by default.

      Returns:
      collected password authentication data.

    • getRequestingPort

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

    • getRequestingSite

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

    • getRequestingPrompt

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

    • getRequestingProtocol

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

    • getRequestingScheme

      protected final String getRequestingScheme()
      Returns the scheme of the connection that requests authorization, for example HTTP Basic Authentication.
      Returns:
      scheme of the connection.

    • requestPasswordAuthentication

      public static PasswordAuthentication requestPasswordAuthentication​(InetAddress rAddr, int rPort, String rProtocol, String rPrompt, String rScheme)
      Invokes the methods of the registered authenticator to get the authentication info.
      Parameters:
      rAddr - address of the connection that requests authentication.
      rPort - port of the connection that requests authentication.
      rProtocol - protocol of the connection that requests authentication.
      rPrompt - realm of the connection that requests authentication.
      rScheme - scheme of the connection that requests authentication.
      Returns:
      password authentication info or null if no authenticator exists.

    • setDefault

      public static void setDefault​(Authenticator a)
      Sets a as the default authenticator. It will be called whenever the realm that the URL is pointing to requires authorization.
      Parameters:
      a - authenticator which has to be set as default.

    • requestPasswordAuthentication

      public static PasswordAuthentication requestPasswordAuthentication​(String rHost, InetAddress rAddr, int rPort, String rProtocol, String rPrompt, String rScheme)
      Invokes the methods of the registered authenticator to get the authentication info.
      Parameters:
      rHost - host name of the connection that requests authentication.
      rAddr - address of the connection that requests authentication.
      rPort - port of the connection that requests authentication.
      rProtocol - protocol of the connection that requests authentication.
      rPrompt - realm of the connection that requests authentication.
      rScheme - scheme of the connection that requests authentication.
      Returns:
      password authentication info or null if no authenticator exists.

    • getRequestingHost

      protected final String getRequestingHost()
      Returns the host name of the connection that requests authentication or null if unknown.
      Returns:
      name of the requesting host or null.

    • requestPasswordAuthentication

      public static PasswordAuthentication requestPasswordAuthentication​(String rHost, InetAddress rAddr, int rPort, String rProtocol, String rPrompt, String rScheme, URL rURL, Authenticator.RequestorType reqType)
      Invokes the methods of the registered authenticator to get the authentication info.
      Parameters:
      rHost - host name of the connection that requests authentication.
      rAddr - address of the connection that requests authentication.
      rPort - port of the connection that requests authentication.
      rProtocol - protocol of the connection that requests authentication.
      rPrompt - realm of the connection that requests authentication.
      rScheme - scheme of the connection that requests authentication.
      rURL - url of the connection that requests authentication.
      reqType - requestor type of the connection that requests authentication.
      Returns:
      password authentication info or null if no authenticator exists.

    • getRequestingURL

      protected URL getRequestingURL()
      Returns the URL of the authentication request.
      Returns:
      authentication request url.

    • getRequestorType

      protected Authenticator.RequestorType getRequestorType()
      Returns the type of this request, it can be PROXY or SERVER.
      Returns:
      RequestorType of the authentication request.