URLStreamHandler

java.lang.Object

|---java.net.URLStreamHandler

public abstract class URLStreamHandler
extends Object

抽象类 URLStreamHandler 是所有流协议处理程序的公共超类。 流协议处理程序知道如何为特定协议类型（例如 http 或 https）建立连接。

在大多数情况下，URLStreamHandler 子类的实例不是由应用程序直接创建的。 相反，在构造 URL 时第一次遇到协议名称时，会自动加载适当的流协议处理程序。

构造函数摘要

构造函数	描述
URLStreamHandler()

方法总结

修饰符和类型	方法	描述
protected boolean	equals(URL u1, URL u2)	提供默认的 equals 计算。
protected int	getDefaultPort()	返回此处理程序解析的 URL 的默认端口。
protected InetAddress	getHostAddress(URL u)	获取我们主机的 IP 地址。
protected int	hashCode(URL u)	提供默认的哈希计算。
protected boolean	hostsEqual(URL u1, URL u2)	比较两个 URL 的主机组件。
protected abstract URLConnection	openConnection(URL u)	打开与 URL 参数引用的对象的连接。
protected URLConnection	openConnection(URL u, Proxy p)	与 openConnection(URL) 相同，只是连接将通过指定的代理进行； 不支持代理的协议处理程序将忽略代理参数并建立正常连接。
protected void	parseURL(URL u, String spec, int start, int limit)	将 URL 的字符串表示形式解析为 URL 对象。
protected boolean	sameFile(URL u1, URL u2)	比较两个 url 以查看它们是否引用同一个文件，即具有相同的协议、主机、端口和路径。
protected void	setURL(URL u, String protocol, String host, int port, String file, String ref)	已弃用。 使用 setURL(URL, String, String, int, String, String, String, String);
protected void	setURL(URL u, String protocol, String host, int port, String authority, String userInfo, String path, String query, String ref)	将 URL 参数的字段设置为指示的值。
protected String	toExternalForm(URL u)	将特定协议的 URL 转换为字符串。

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造函数详细信息

URLStreamHandler

public URLStreamHandler()

方法详情

openConnection

protected abstract URLConnection openConnection(URL u) throws IOException

打开与 URL 参数引用的对象的连接。 此方法应被子类覆盖。

如果对于处理程序的协议（例如 HTTP 或 JAR），存在属于以下包之一或其子包之一的公共专用 URLConnection 子类：java.lang、java.io、java.util、java.net、 返回的连接将属于该子类。 例如，对于 HTTP，将返回一个 HttpURLConnection，对于 JAR，将返回一个 JarURLConnection。

参数：

参数名称	参数描述
u	此连接到的 URL。

返回:

URL 的 URLConnection 对象。

Throws:

Throw名称	Throw描述
IOException	如果在打开连接时发生 I/O 错误。

openConnection

protected URLConnection openConnection(URL u, Proxy p) throws IOException

与 openConnection(URL) 相同，只是连接将通过指定的代理进行； 不支持代理的协议处理程序将忽略代理参数并建立正常连接。 调用此方法会抢占系统的默认 ProxySelector 设置。

参数：

参数名称	参数描述
u	此连接到的 URL。
p	建立连接的代理。 如果需要直接连接，则应指定 Proxy.NO_PROXY。

返回:

URL 的 URLConnection 对象。

Throws:

Throw名称	Throw描述
IOException	如果在打开连接时发生 I/O 错误。
IllegalArgumentException	如果 u 或 p 为空，或者 p 的类型错误。
UnsupportedOperationException	如果实现协议的子类不支持该方法。

parseURL

protected void parseURL(URL u, String spec, int start, int limit)

将 URL 的字符串表示形式解析为 URL 对象。

如果有任何继承的上下文，那么它已经被复制到 URL 参数中。

URLStreamHandler 的 parseURL 方法解析字符串表示，就好像它是一个 http 规范一样。 大多数 URL 协议系列都有类似的解析。 具有不同语法的协议的流协议处理程序必须覆盖此例程。

参数：

参数名称	参数描述
u	接收规范解析结果的 URL。
spec	表示必须解析的 URL 的字符串。
start	开始解析的字符索引。 这只是在指定协议名称确定的“：”（如果有的话）之后。
limit	停止解析的字符位置。 这是字符串的结尾或“#”字符的位置（如果存在）。 尖号后面的所有信息都表示一个锚点。

getDefaultPort

protected int getDefaultPort()

返回此处理程序解析的 URL 的默认端口。 此方法旨在被具有默认端口号的处理程序覆盖。

返回:

此处理程序解析的 URL 的默认端口。

equals

protected boolean equals(URL u1, URL u2)

提供默认的等于计算。 可能被对 equals() 有不同要求的其他协议的处理程序覆盖。 此方法要求它的任何参数都不为空。 仅由 java.net.URL 类调用它这一事实保证了这一点。

参数：

参数名称	参数描述
u1	一个 URL 对象
u2	一个 URL 对象

返回：

如果两个 url 被认为相等，则为 true。即它们指的是同一个文件中的同一个片段。

hashCode

protected int hashCode(URL u)

提供默认的哈希计算。 可能被对 hashCode 计算有不同要求的其他协议的处理程序覆盖。

参数：

参数名称	参数描述
u	一个 URL 对象

返回:

适合哈希表索引的 int

sameFile

protected boolean sameFile(URL u1, URL u2)

比较两个 url 以查看它们是否引用同一个文件，即具有相同的协议、主机、端口和路径。 此方法要求它的任何参数都不为空。 这是因为它只被 java.net.URL 类间接调用的事实保证。

参数：

参数名称	参数描述
u1	一个 URL 对象
u2	一个 URL 对象

返回:

如果 u1 和 u2 引用同一个文件，则为 true

getHostAddress

protected InetAddress getHostAddress(URL u)

获取我们主机的 IP 地址。 空主机字段或 DNS 故障将导致返回空值。

参数：

参数名称	参数描述
u	一个 URL 对象

返回:

表示主机 IP 地址的 InetAddress。

hostsEqual

protected boolean hostsEqual(URL u1, URL u2)

比较两个 URL 的主机组件。

参数：

参数名称	参数描述
u1	第一个要比较的主机的 URL
u2	要比较的第二个主机的 URL

返回:

当且仅当它们相等时为true，否则为false。

toExternalForm

protected String toExternalForm(URL u)

将特定协议的 URL 转换为字符串。

参数：

参数名称	参数描述
u	网址。

返回:

URL 参数的字符串表示形式。

setURL

protected void setURL(URL u, String protocol, String host, int port, String authority, String userInfo, String path, String query, String ref)

将 URL 参数的字段设置为指示的值。 只有从 URLStreamHandler 派生的类才能使用此方法来设置 URL 字段的值。

参数：

参数名称	参数描述
u	要修改的 URL。
protocol	协议名称。
host	URL 的远程主机值。
port	远程机器上的端口。
authority	URL 的权限部分。
userInfo	URL 的 userInfo 部分。
path	URL 的路径组件。
query	URL 的查询部分。
ref	参考资料。

Throws:

Throw名称	Throw描述
SecurityException	如果 URL 的协议处理程序与此不同

setURL

@Deprecated protected void setURL(URL u, String protocol, String host, int port, String file, String ref)

已弃用。 使用 setURL(URL, String, String, int, String, String, String, String);

将 URL 参数的字段设置为指示的值。 只有从 URLStreamHandler 派生的类才能使用此方法来设置 URL 字段的值。

参数：

参数名称	参数描述
u	要修改的 URL。
protocol	协议名称。 自 1.2 起，该值被忽略。
host	URL 的远程主机值。
port	远程机器上的端口。
file	文件。
ref	参考资料。

Throws:

Throw名称	Throw描述
SecurityException	如果 URL 的协议处理程序与此不同