java.lang.Object
|---java.net.Authenticator
public abstract class Authenticator
extends Object
Authenticator 类表示一个知道如何获得网络连接身份验证的对象。 通常,它会通过提示用户输入信息来做到这一点。
应用程序通过覆盖子类中的 getPasswordAuthentication() 来使用此类。 此方法通常会使用各种 getXXX() 访问器方法来获取有关请求身份验证的实体的信息。 然后,它必须通过与用户交互或通过其他一些非交互方式来获取用户名和密码。 然后将凭据作为 PasswordAuthentication 返回值返回。
然后通过调用 setDefault(java.net.Authenticator) 向系统注册这个具体子类的实例。 当需要身份验证时,系统将调用其中一个 requestPasswordAuthentication() 方法,该方法又将调用注册对象的 getPasswordAuthentication() 方法。
所有请求身份验证的方法都有一个失败的默认实现。
修饰符和类型 | 类 | 描述 |
---|---|---|
static class | Authenticator.RequestorType | 请求身份验证的实体的类型。 |
构造函数 | 描述 |
---|---|
Authenticator() |
修饰符和类型 | 方法 | 描述 |
---|---|---|
protected PasswordAuthentication | getPasswordAuthentication() | 需要密码授权时调用。 |
protected String | getRequestingHost() | 获取请求身份验证的站点或代理的主机名,如果不可用,则为 null。 |
protected int | getRequestingPort() | 获取所请求连接的端口号。 |
protected String | getRequestingPrompt() | 获取请求者给出的提示字符串。 |
protected String | getRequestingProtocol() | 给出请求连接的协议。 |
protected String | getRequestingScheme() | 获取请求者的方案(例如 HTTP 防火墙的 HTTP 方案)。 |
protected InetAddress | getRequestingSite() | 获取请求授权的站点的 InetAddress,如果不可用,则为 null。 |
protected URL | getRequestingURL() | 返回导致此身份验证请求的 URL。 |
protected Authenticator.RequestorType | getRequestorType() | 返回请求者是代理还是服务器。 |
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 PasswordAuthentication | requestPasswordAuthentication(InetAddress addr, int port, String protocol, String prompt, String scheme) | 向已在系统中注册的身份验证器询问密码。 |
static void | setDefault(Authenticator a) | 设置当代理或 HTTP 服务器请求身份验证时网络代码将使用的身份验证器。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
public Authenticator()
public static void setDefault(Authenticator a)
设置当代理或 HTTP 服务器请求身份验证时网络代码将使用的身份验证器。
首先,如果有安全管理器,则使用 NetPermission("setDefaultAuthenticator") 权限调用其 checkPermission 方法。 这可能会导致 java.lang.SecurityException。
参数:
参数名称 | 参数描述 |
---|---|
a | 要设置的身份验证器。 如果 a 为 null,则删除任何先前设置的身份验证器。 |
Throws:
Throw名称 | Throw描述 |
---|---|
SecurityException | 如果存在安全管理器并且其 checkPermission 方法不允许设置默认身份验证器。 |
public static PasswordAuthentication requestPasswordAuthentication(InetAddress addr, int port, String protocol, String prompt, String scheme)
向已在系统中注册的身份验证器询问密码。
首先,如果存在安全管理器,则使用 NetPermission("requestPasswordAuthentication") 权限调用其 checkPermission 方法。 这可能会导致 java.lang.SecurityException。
参数:
参数名称 | 参数描述 |
---|---|
addr | 请求授权的站点的 InetAddress,如果未知,则为 null。 |
port | 请求连接的端口 |
protocol | 请求连接的协议 (getRequestingProtocol()) |
prompt | 用户的提示字符串 |
scheme | 认证方案 |
返回:
用户名/密码,如果无法获取,则返回 null。
Throws:
Throw名称 | Throw描述 |
---|---|
SecurityException | 如果存在安全管理器并且其 checkPermission 方法不允许密码身份验证请求。 |
public static PasswordAuthentication requestPasswordAuthentication(String host, InetAddress addr, int port, String protocol, String prompt, String scheme)
向已在系统中注册的身份验证器询问密码。 这是请求密码的首选方法,因为在 InetAddress 不可用的情况下可以提供主机名。
首先,如果存在安全管理器,则使用 NetPermission("requestPasswordAuthentication") 权限调用其 checkPermission 方法。 这可能会导致 java.lang.SecurityException。
参数:
参数名称 | 参数描述 |
---|---|
host | 请求身份验证的站点的主机名。 |
addr | 请求身份验证的站点的 InetAddress,如果未知,则为 null。 |
port | 请求连接的端口。 |
protocol | 请求连接的协议 (getRequestingProtocol()) |
prompt | 用于标识身份验证领域的用户提示字符串。 |
scheme | 认证方案 |
返回:
用户名/密码,如果无法获取,则返回 null。
Throws:
Throw名称 | Throw描述 |
---|---|
SecurityException | 如果存在安全管理器并且其 checkPermission 方法不允许密码身份验证请求。 |
public static PasswordAuthentication requestPasswordAuthentication(String host, InetAddress addr, int port, String protocol, String prompt, String scheme, URL url, Authenticator.RequestorType reqType)
向已在系统中注册的身份验证器询问密码。
首先,如果存在安全管理器,则使用 NetPermission("requestPasswordAuthentication") 权限调用其 checkPermission 方法。 这可能会导致 java.lang.SecurityException。
参数:
参数名称 | 参数描述 |
---|---|
host | 请求身份验证的站点的主机名。 |
addr | 请求授权的站点的 InetAddress,如果未知,则为 null。 |
port | 请求连接的端口 |
protocol | 请求连接的协议 (getRequestingProtocol()) |
prompt | 用户的提示字符串 |
scheme | 认证方案 |
url | 导致身份验证的请求 URL |
reqType | 请求身份验证的实体的类型(服务器或代理)。 |
返回:
用户名/密码,如果无法获取,则返回 null。
Throws:
Throw名称 | Throw描述 |
---|---|
SecurityException | 如果存在安全管理器并且其 checkPermission 方法不允许密码身份验证请求。 |
protected final String getRequestingHost()
获取请求身份验证的站点或代理的主机名,如果不可用,则为 null。
返回:
需要身份验证的连接的主机名,如果不可用,则为 null。
protected final InetAddress getRequestingSite()
获取请求授权的站点的 InetAddress,如果不可用,则为 null。
返回:
请求授权的站点的 InetAddress,如果不可用,则返回 null。
protected final int getRequestingPort()
获取所请求连接的端口号。
返回:
一个 int 指示所请求连接的端口。
protected final String getRequestingProtocol()
给出请求连接的协议。 通常这将基于 URL,但在未来的 JDK 中,它可能是例如“SOCKS”,用于受密码保护的 SOCKS5 防火墙。
返回:
协议,可选择后跟“/version”,其中 version 是版本号。
protected final String getRequestingPrompt()
获取请求者给出的提示字符串。
返回:
请求者给出的提示字符串(http请求的领域)
protected final String getRequestingScheme()
获取请求者的方案(例如 HTTP 防火墙的 HTTP 方案)。
返回:
请求者的计划
protected PasswordAuthentication getPasswordAuthentication()
需要密码授权时调用。 子类应该覆盖默认实现,它返回 null。
返回:
从用户收集的 PasswordAuthentication,如果没有提供,则返回 null。
protected URL getRequestingURL()
返回导致此身份验证请求的 URL。
返回:
请求的 URL
protected Authenticator.RequestorType getRequestorType()
返回请求者是代理还是服务器。
返回:
请求者的身份验证类型
备案信息: 粤ICP备15087711号-2
Copyright © 2008-2024 啊嘎哇在线工具箱 All Rights.
本站所有资料来源于网络,版权归原作者所有,仅作学习交流使用,如不慎侵犯了您的权利,请联系我们。