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 的协议处理程序与此不同 |