compact1, compact2, compact3

java.net

Class Authenticator

java.lang.Object

java.net.Authenticator

public abstract class Authenticator
extends Object

这类认证表示一个对象知道如何获得网络连接认证。通常情况下，它会这样做，通过提示用户的信息。

应用程序使用这个类的子类中重写getPasswordAuthentication()。这种方法通常会使用各种getxxx()访问器方法来获取有关实体请求认证信息。然后，它必须获得一个用户名和密码，通过与用户交互，或通过一些其他的非互动的方式。凭据作为PasswordAuthentication返回值。

这个具体的子类的一个实例进行了注册系统通过调用setDefault(Authenticator)。当需要身份验证，系统会调用一个方法的requestpasswordauthentication()反过来调用注册的对象getpasswordauthentication()方法。

请求身份验证的所有方法都有一个默认的实现，即失败。

从以下版本开始：

一点二

另请参见：

setDefault(java.net.Authenticator)， getPasswordAuthentication()

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Authenticator.RequestorType 请求身份验证的实体的类型。

构造方法摘要

构造方法

Constructor and Description
Authenticator()

方法摘要

Modifier and Type	Method and Description
protected PasswordAuthentication	getPasswordAuthentication() 当需要密码授权时调用。
protected String	getRequestingHost() 获取站点或代理请求身份验证的 hostname，或 null如果不可用。
protected int	getRequestingPort() 获取所请求的连接的端口号。
protected String	getRequestingPrompt() 被请求者给出的提示字符串。
protected String	getRequestingProtocol() 给出请求连接的协议。
protected String	getRequestingScheme() 获取请求的方案（例如HTTP防火墙，HTTP方案）。
protected InetAddress	getRequestingSite() 获取站点请求授权 InetAddress，或 null如果不可用。
protected URL	getRequestingURL() 返回导致此请求的身份验证的网址。
protected Authenticator.RequestorType	getRequestorType() 返回该请求者是否是一个代理或服务器。
static PasswordAuthentication	requestPasswordAuthentication(InetAddress addr, int port, String protocol, String prompt, String scheme) 向鉴定人，已与一个密码系统注册。
static PasswordAuthentication	requestPasswordAuthentication(String host, InetAddress addr, int port, String protocol, String prompt, String scheme) 向鉴定人，已与一个密码系统注册。
static PasswordAuthentication	requestPasswordAuthentication(String host, InetAddress addr, int port, String protocol, String prompt, String scheme, URL url, Authenticator.RequestorType reqType) 向鉴定人，已与一个密码系统注册。
static void	setDefault(Authenticator a) 设置认证将由网络代码时使用的代理或HTTP服务器要求身份验证。

Methods inherited from class java.lang.Object

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

Constructor Detail

Authenticator

public Authenticator()

方法详细信息

setDefault

public static void setDefault(Authenticator a)

设置认证将由网络代码时使用的代理或HTTP服务器要求身份验证。

首先，如果存在安全管理器，它的checkPermission方法称为一个NetPermission("setDefaultAuthenticator")许可。这可能会导致java.lang.securityexception。

参数

a -身份验证设置。如果是 null任何先前设定的认证被删除。

异常

SecurityException -如果存在一个安全管理及其 checkPermission方法不允许设置默认的认证。

另请参见：

SecurityManager.checkPermission(java.security.Permission)， NetPermission

requestPasswordAuthentication

public static PasswordAuthentication requestPasswordAuthentication(InetAddress addr,
                                                                   int port,
                                                                   String protocol,
                                                                   String prompt,
                                                                   String scheme)

向鉴定人，已与一个密码系统注册。

首先，如果存在安全管理器，它的checkPermission方法称为一个NetPermission("requestPasswordAuthentication")许可。这可能会导致java.lang.securityexception。

参数

addr -站点请求授权或空它，如果不知道。

port -请求连接的端口

protocol -协议的请求连接（ getRequestingProtocol()）

prompt -为用户提示字符串

scheme的认证方案

结果

用户名/密码，或无效，如果一个人不能得到。

异常

SecurityException -如果存在一个安全管理及其 checkPermission方法不允许密码验证请求。

另请参见：

SecurityManager.checkPermission(java.security.Permission)， NetPermission

requestPasswordAuthentication

public static PasswordAuthentication requestPasswordAuthentication(String host,
                                                                   InetAddress addr,
                                                                   int port,
                                                                   String protocol,
                                                                   String prompt,
                                                                   String scheme)

向鉴定人，已与一个密码系统注册。这是因为主机名的请求密码可以提供的情况下，它是不可用的首选方法。

首先，如果存在安全管理器，它的checkPermission方法称为一个NetPermission("requestPasswordAuthentication")许可。这可能会导致java.lang.securityexception。

参数

host -站点请求身份验证的主机名。

addr -站点请求身份验证的它，如果不知道或空。

port -请求连接的端口。

protocol -协议的请求连接（ getRequestingProtocol()）

prompt -一个标识认证领域用户提示字符串。

scheme的认证方案

结果

用户名/密码，或无效，如果一个人不能得到。

异常

SecurityException -如果存在一个安全管理及其 checkPermission方法不允许密码验证请求。

从以下版本开始：

一点四

另请参见：

SecurityManager.checkPermission(java.security.Permission)， NetPermission

requestPasswordAuthentication

public static PasswordAuthentication requestPasswordAuthentication(String host,
                                                                   InetAddress addr,
                                                                   int port,
                                                                   String protocol,
                                                                   String prompt,
                                                                   String scheme,
                                                                   URL url,
                                                                   Authenticator.RequestorType reqType)

向鉴定人，已与一个密码系统注册。

首先，如果存在安全管理器，它的checkPermission方法称为一个NetPermission("requestPasswordAuthentication")许可。这可能会导致java.lang.securityexception。

参数

host -站点请求身份验证的主机名。

addr -站点请求授权或空它，如果不知道。

port -请求连接的端口

protocol -协议的请求连接（ getRequestingProtocol()）

prompt -为用户提示字符串

scheme的认证方案

url -请求URL导致认证

reqType型（服务器或代理）的实体请求认证。

结果

用户名/密码，或无效，如果一个人不能得到。

异常

SecurityException -如果存在一个安全管理及其 checkPermission方法不允许密码验证请求。

从以下版本开始：

一点五

另请参见：

SecurityManager.checkPermission(java.security.Permission)， NetPermission

getRequestingHost

protected final String getRequestingHost()

获取站点或代理请求身份验证的 hostname，或 null如果不可用。

结果

该连接请求认证的主机，如果它不可用或空。

从以下版本开始：

一点四

getRequestingSite

protected final InetAddress getRequestingSite()

获取站点请求授权 InetAddress，或 null如果不可用。

结果

该网站的授权请求的它，如果它不可用或空。

getRequestingPort

protected final int getRequestingPort()

获取所请求的连接的端口号。

结果

一个 int表示请求连接的端口。

getRequestingProtocol

protected final String getRequestingProtocol()

给出请求连接的协议。通常这将基于一个URL，但在未来的JDK可以，例如，“一个密码保护的Socks5防火墙的袜子”。

结果

该协议，可选其次是“/版本”，其中版本是一个版本号。

另请参见：

URL.getProtocol()

getRequestingPrompt

protected final String getRequestingPrompt()

被请求者给出的提示字符串。

结果

请求者给出的提示字符串（HTTP请求的境界）

getRequestingScheme

protected final String getRequestingScheme()

获取请求的方案（例如HTTP防火墙，HTTP方案）。

结果

的请求方案

getPasswordAuthentication

protected PasswordAuthentication getPasswordAuthentication()

当需要密码授权时调用。子类应重写默认实现，它返回空值。

结果

收集用户的口令认证，或null如果提供不。

getRequestingURL

protected URL getRequestingURL()

返回导致此请求的身份验证的网址。

结果

请求的URL

从以下版本开始：

一点五

getRequestorType

protected Authenticator.RequestorType getRequestorType()

返回该请求者是否是一个代理或服务器。

结果

请求者的身份验证类型

从以下版本开始：

一点五