鸿蒙OS开发文档 第56页

CacheRequest java.lang.Object |—java.net.CacheRequest public abstract class CacheRequest extends Object 表示用于在 ResponseCache 中存储资源的通道。 此类的实例提供了一个 OutputStream 对象，该对象由协议处理程序调用以将资源数据存储到缓存中，以及一个允许中断和放弃缓存存储操作的 abort() 方法。 如果在读取响应或写入缓存时遇到 IOException，则当前缓存存储操作将被中止。 构造函数摘要 构造函数 描述 CacheRequest() 方法总结 修饰符和类型 方法 描述 abstract void abort() 中止缓存响应的尝试。 abstract OutputStream getBody() 返回一个可以写入响应正文的 OutputStream。 从类 java.lang.Object 继承的方法 clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait 构造函数详细信息 CacheRequest public CacheRequest() 方法详情 getBody public abstract OutputStream getBody() throws IOException 返回一个可以写入响应正文的 OutputStream。 返回: 一个可以写入响应正文的 OutputStream Throws: Throw名称 Throw描述 IOException 如果在写入响应正文时发生 I/O 错误 abort public abstract void abort() 中止缓存响应的尝试。 如果在读取响应或写入缓存时遇到 IOException，则将放弃当前的缓存存储操作。

Authenticator 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 构造函数详细信息 Authenticator public Authenticator() 方法详情 setDefault public static void setDefault(Authenticator a) 设置当代理或 HTTP 服务器请求身份验证时网络代码将使用的身份验证器。 首先，如果有安全管理器，则使用 NetPermission(“setDefaultAuthenticator”) 权限调用其 checkPermission 方法。 这可能会导致 java.lang.SecurityException。 参数： 参数名称 参数描述 a 要设置的身份验证器。 如果 a 为 null，则删除任何先前设置的身份验证器。 Throws: Throw名称 Throw描述 SecurityException 如果存在安全管理器并且其 checkPermission 方法不允许设置默认身份验证器。...

URLStreamHandlerFactory public interface URLStreamHandlerFactory 该接口为 URL 流协议处理程序定义了一个工厂。 URL 类使用它来为特定协议创建 URLStreamHandler。 方法总结 修饰符和类型 方法 描述 URLStreamHandler createURLStreamHandler(String protocol) 使用指定的协议创建一个新的 URLStreamHandler 实例。 方法详情 createURLStreamHandler URLStreamHandler createURLStreamHandler(String protocol) 使用指定的协议创建一个新的 URLStreamHandler 实例。 参数： 参数名称 参数描述 protocol 协议（“ftp”、“http”、“nntp”等）。 返回: 特定协议的 URLStreamHandler。

SocketOptions public interface SocketOptions 获取/设置套接字选项的方法接口。 该接口由：SocketImpl 和 DatagramSocketImpl 实现。 这些子类应该覆盖这个接口的方法，以支持他们自己的选项。 在此接口中指定选项的方法和常量仅用于实现。 如果您没有继承 SocketImpl 或 DatagramSocketImpl，则不会直接使用它们。 在 Socket、ServerSocket、DatagramSocket 和 MulticastSocket 中有类型安全的方法来获取/设置这些选项。 字段摘要 修饰符和类型 字段 描述 static int IP_MULTICAST_IF 设置发送多播数据包的出接口。 static int IP_MULTICAST_IF2 和上面一样。 static int IP_MULTICAST_LOOP 此选项启用或禁用多播数据报的本地环回。 static int IP_TOS 此选项设置 TCP 或 UDP 套接字的 IP 标头中的服务类型或流量类别字段。 static int SO_BINDADDR 获取套接字的本地地址绑定（此选项不能“设置”，只能“获取”，因为套接字是在创建时绑定的，因此不能更改本地绑定地址）。 static int SO_BROADCAST 为套接字设置 SO_BROADCAST。 static int SO_KEEPALIVE 如果为 TCP 套接字设置了 keepalive 选项，并且在 2 小时内没有通过套接字在任一方向上交换数据（注意：实际值取决于实现），TCP 会自动向对等方发送 keepalive 探测。 static int SO_LINGER 指定关闭时延迟超时。 static int SO_OOBINLINE 当设置 OOBINLINE 选项时，套接字上接收到的任何 TCP 紧急数据都将通过套接字输入流接收。 static int SO_RCVBUF 设置平台用于传入网络 I/O 的底层缓冲区大小的提示。 static int SO_REUSEADDR 为套接字设置 SO_REUSEADDR。 static int SO_SNDBUF 设置平台用于传出网络 I/O 的底层缓冲区大小的提示。 static int SO_TIMEOUT 设置阻塞 Socket 操作的超时时间： static int TCP_NODELAY 禁用此连接的 Nagle 算法。 方法总结 修饰符和类型 方法 描述 Object getOption(int optID) 获取选项的值。 void setOption(int optID, Object value) 启用/禁用 optID 指定的选项。 字段详细信息 IP_MULTICAST_IF static final int IP_MULTICAST_IF 设置发送多播数据包的出接口。 在具有多个网络接口的主机上很有用，其中应用程序希望使用系统默认值以外的方式。 获取/返回一个 InetAddress。 对多播有效：DatagramSocketImpl IP_MULTICAST_IF2 static final int IP_MULTICAST_IF2 和上面一样。 引入此选项后，IP_MULTICAST_IF 的行为将保持与以前相同，而此新选项可以支持使用 IPv4 和 IPv6 地址设置传出接口。 注意：确保与此没有冲突 IP_MULTICAST_LOOP static final int IP_MULTICAST_LOOP 此选项启用或禁用多播数据报的本地环回。 多播套接字默认启用此选项。 IP_TOS static final int IP_TOS 此选项设置 TCP 或 UDP 套接字的 IP 标头中的服务类型或流量类别字段。 SO_BINDADDR...

SocketOption public interface SocketOption<T> 与套接字关联的套接字选项。 在 channels 包中，NetworkChannel 接口定义了 setOption 和 getOption 方法来设置和查询通道的套接字选项。 方法总结 修饰符和类型 方法 描述 String name() 返回套接字选项的名称。 ClassT type() 返回套接字选项值的类型。 方法详情 name String name() 返回套接字选项的名称。 返回: 套接字选项的名称 type ClassT type() 返回套接字选项值的类型。 返回: 套接字选项值的类型

SocketImplFactory public interface SocketImplFactory 该接口为套接字实现定义了一个工厂。 Socket 和 ServerSocket 类使用它来创建实际的套接字实现。 方法总结 修饰符和类型 方法 描述 SocketImpl createSocketImpl() 创建一个新的 SocketImpl 实例。 方法详情 createSocketImpl SocketImpl createSocketImpl() 创建一个新的 SocketImpl 实例。 返回: SocketImpl 的新实例。

ProtocolFamily public interface ProtocolFamily 代表一系列通信协议。 方法总结 修饰符和类型 方法 描述 String name() 返回协议族的名称。 方法详情 name String name() 返回协议族的名称。 返回: 协议族的名称

FileNameMap public interface FileNameMap 一个简单的接口，它提供了一种在文件名和 MIME 类型字符串之间进行映射的机制。 方法总结 修饰符和类型 方法 描述 String getContentTypeFor(String fileName) Gets the MIME type for the specified file name. 方法详情 getContentTypeFor String getContentTypeFor(String fileName) 获取指定文件名的 MIME 类型。 参数： 参数名称 参数描述 fileName 指定的文件名 返回: 一个字符串，指示指定文件名的 MIME 类型。

DatagramSocketImplFactory public interface DatagramSocketImplFactory 该接口为数据报套接字实现定义了一个工厂。 DatagramSocket 类使用它来创建实际的套接字实现。 方法总结 修饰符和类型 方法 描述 DatagramSocketImpl createDatagramSocketImpl() 创建一个新的 DatagramSocketImpl 实例。 方法详情 createDatagramSocketImpl DatagramSocketImpl createDatagramSocketImpl() 创建一个新的 DatagramSocketImpl 实例。 返回: DatagramSocketImpl 的新实例。

CookieStore public interface CookieStore CookieStore 对象表示 cookie 的存储。 可以存储和检索cookies。 CookieManager 将调用 CookieStore.add 为每个传入的 HTTP 响应保存 cookie，并调用 CookieStore.get 为每个传出的 HTTP 请求检索 cookie。 CookieStore 负责删除已过期的 HttpCookie 实例。 方法总结 修饰符和类型 方法 描述 void add(URI uri, HttpCookie cookie) 将一个 HTTP cookie 添加到存储中。 ListHttpCookie get(URI uri) 检索与给定 URI 关联的 cookie，或者其域与给定 URI 匹配的 cookie。 ListHttpCookie getCookies() 在 cookie 存储中获取所有未过期的 cookie。 ListURI getURIs() 获取标识此 cookie 存储中的 cookie 的所有 URI。 boolean remove(URI uri, HttpCookie cookie) 从存储中删除 cookie。 boolean removeAll() 删除此 cookie 存储中的所有 cookie。 方法详情 add void add(URI uri, HttpCookie cookie) 将一个 HTTP cookie 添加到存储中。 每个传入的 HTTP 响应都会调用它。 要存储的 cookie 可能与 URI 相关联，也可能不相关。 如果它不与 URI 关联，则 cookie 的域和路径属性将指示它来自何处。 如果它与 URI 相关联并且未指定其域和路径属性，则给定的 URI 将指示此 cookie 的来源。 如果与给定 URI 对应的 cookie 已经存在，则将其替换为新的。 参数： 参数名称 参数描述 uri 与此 cookie 关联的 uri。 如果为 null，则此 cookie 不会与 URI 关联 cookie 要存储的 cookie Throws: Throw名称 Throw描述 NullPointerException 如果 cookie 为空 get ListHttpCookie get(URI uri) 检索与给定 URI 关联的 cookie，或者其域与给定 URI 匹配的 cookie。 仅返回未过期的 cookie。 每个传出的 HTTP 请求都会调用它。 参数： 参数名称 参数描述 uri 与要返回的 cookie 关联的 uri 返回: 一个不可变的 HttpCookie 列表，如果没有...