URL

URL

URL (String protocol, 
                String host, 
                int port, 
                String file)

创建 URL从指定对象 protocol ， host ， port号码，和 file 。

host可以表示为主机名或文字IP地址。 如果使用IPv6文字地址，则应将其用方括号（ '['和']' ）括起来，如RFC 2732所指定; 但是，也接受RFC 2373: IP Version 6 Addressing Architecture中定义的文字IPv6地址格式。

指定 port数字 -1表示URL应该使用协议的默认端口。

如果这是使用指定协议创建的第一个URL对象，则为该协议创建一个 流协议处理程序对象，即类 URLStreamHandler一个实例：

1. If the application has previously set up an instance of URLStreamHandlerFactory as the stream handler factory, then the createURLStreamHandler method of that instance is called with the protocol string as an argument to create the stream protocol handler.
2. If no URLStreamHandlerFactory has yet been set up, or if the factory's createURLStreamHandler method returns null, then the constructor finds the value of the system property:

            java.protocol.handler.pkgs
        

   If the value of that system property is not null, it is interpreted as a list of packages separated by a vertical slash character '|'. The constructor tries to load the class named:

            <package>.<protocol>.Handler
        

   where <package> is replaced by the name of the package and <protocol> is replaced by the name of the protocol. If this class does not exist, or if the class exists but it is not a subclass of URLStreamHandler, then the next package in the list is tried.
3. If the previous step fails to find a protocol handler, then the constructor tries to load from a system default package.

            <system default package>.<protocol>.Handler
        

   If this class does not exist, or if the class exists but it is not a subclass of URLStreamHandler, then a MalformedURLException is thrown.

以下协议的协议处理程序保证存在于搜索路径中： -

     http, https, ftp, file, and jar
 

这个构造函数不会验证输入。

URL

URL (String protocol, 
                String host, 
                String file)

根据指定的protocol名称， host名称和file名称创建一个URL。 使用指定协议的默认端口。

此方法等效于调用带参数是四个参数的构造函数protocol ， host ， -1 ，并file 。 这个构造函数不会验证输入。

URL

URL (String protocol, 
                String host, 
                int port, 
                String file, 
                URLStreamHandler handler)

创建URL从指定对象protocol ， host ， port号码， file ，和handler 。 指定一个port数字-1表示URL应该使用协议的默认端口。 指定handler的null表示该URL应该使用该协议的默认流处理程序，如下所示：java.net.URL＃URL（java.lang.String，java.lang.String，int，java.lang.String ）

如果处理程序不为空并且存在安全管理器，则安全管理器的checkPermission方法NetPermission("specifyStreamHandler")权限被调用。 这可能会导致SecurityException。 这个构造函数不会验证输入。

URL

URL (String spec)

从 String表示中创建一个 URL对象。

这个构造函数相当于使用 null第一个参数调用双参数构造函数。

URL

URL (URL context, 
                String spec)

通过在指定的上下文中解析给定的规范来创建URL。 新的URL是根据RFC2396“统一资源标识符：通用*语法”中描述的给定上下文URL和spec参数创建的：

          <scheme>://<authority><path>?<query>#<fragment>
 

如果方案组件是在给定的规范中定义的，并且与上下文的方案不匹配，则新URL将根据规范单独创建为绝对URL。 否则，方案组件将从上下文URL继承。

如果规范组件存在于规范中，则规范将被视为绝对规范，规范权限和路径将取代上下文权限和路径。 如果规范中缺少权威组件，那么新URL的权限将从上下文继承。

如果规范的路径组件以斜杠字符“/”开头，那么该路径将被视为绝对路径，并且规范路径会替换上下文路径。

否则，路径被视为相对路径并被附加到上下文路径，如RFC2396中所述。 此外，在这种情况下，通过删除由“..”和“。”出现的目录更改来对该路径进行规范化。

有关URL解析的更详细说明，请参阅RFC2396。

URL

URL (URL context, 
                String spec, 
                URLStreamHandler handler)

通过在指定的上下文中使用指定的处理程序解析给定的规范来创建URL。 如果处理程序为空，则解析与两个参数构造函数一样。

equals

boolean equals (Object obj)

将这个URL与另一个对象进行比较。

如果给定的对象不是URL，则此方法立即返回 false 。

如果两个URL对象具有相同的协议，参考等效主机，在主机上具有相同的端口号以及文件的相同文件和片段，则两个URL对象相等。

如果此URL等于o则返回true。 如果URL具有相同的协议，主机，端口，文件和引用，则它们是相等的。

Network I/O Warning

URL.equals（）的一些实现通过网络解析主机名。 这是有问题的：

• The network may be slow. Many classes, including core collections like Map and Set expect that equals and hashCode will return quickly. By violating this assumption, this method posed potential performance problems.
• Equal IP addresses do not imply equal content. Virtual hosting permits unrelated sites to share an IP address. This method could report two otherwise unrelated URLs to be equal because they're hosted on the same server.
• The network may not be available. Two URLs could be equal when a network is available and unequal otherwise.
• The network may change. The IP address for a given host name varies by network and over time. This is problematic for mobile devices. Two URLs could be equal on some networks and unequal on others.

Android 4.0（冰淇淋三明治）解决了这个问题。 在该版本中，只有主机名相同（忽略大小写），URL才是相等的。

getAuthority

String getAuthority ()

获取此 URL的权威部分。

getContent

Object getContent ()

获取此URL的内容。 这种方法是一个简写：

     openConnection().getContent()
 

getContent

Object getContent (Class[] classes)

获取此URL的内容。 这种方法是一个简写：

     openConnection().getContent(Class[])
 

getDefaultPort

int getDefaultPort ()

获取与此URL关联的协议的默认端口号。 如果URL方案或URL的URLStreamHandler未定义默认端口号，则返回-1。

getFile

String getFile ()

获取这个URL的文件名。 返回的文件部分将与getPath()相同，再加上getQuery()的值（如果有的话）的连接。 如果没有查询部分，则此方法和getPath()将返回相同的结果。

getHost

String getHost ()

获取此URL的主机名（如果适用）。 主机的格式符合RFC 2732，即对于文字IPv6地址，此方法将返回方括号（ '['和']' ）中的IPv6地址。

getPath

String getPath ()

获取此 URL的路径部分。

getPort

int getPort ()

获取此 URL的端口号。

getProtocol

String getProtocol ()

获取此 URL的协议名称。

getQuery

String getQuery ()

获取此 URL的查询部分。

getRef

String getRef ()

获取此 URL的锚点（也称为“参考”）。

getUserInfo

String getUserInfo ()

获取此 URL的userInfo部分。

hashCode

int hashCode ()

创建一个适合散列表索引的整数。

哈希码基于与URL比较相关的所有URL组件。 因此，该操作是阻止操作。

openConnection

URLConnection openConnection (Proxy proxy)

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

openConnection

URLConnection openConnection ()

返回一个 URLConnection实例表示由所引用的远程对象的连接 URL 。

每次调用此URL的协议处理程序的 URLStreamHandler.openConnection(URL)方法时， 都会创建一个新的 URLConnection实例。

应该注意的是，URLConnection实例在创建时不会建立实际的网络连接。 这只会在拨打URLConnection.connect()时才会发生。

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

openStream

InputStream openStream ()

打开与此URL的连接并返回InputStream以从该连接读取。 这种方法是一个简写：

     openConnection().getInputStream()
 

sameFile

boolean sameFile (URL other)

比较两个网址，不包括片段组件。

如果这个 URL和 other参数相等，而没有考虑片段组件，则返回 true 。

setURLStreamHandlerFactory

void setURLStreamHandlerFactory (URLStreamHandlerFactory fac)

设置应用程序的URLStreamHandlerFactory 。 该方法在给定的Java虚拟机中最多可以调用一次。

URLStreamHandlerFactory实例用于从协议名称构造流协议处理程序。

如果存在安全管理器，则此方法首先调用安全管理器的方法checkSetFactory以确保允许操作。 这可能会导致SecurityException。

toExternalForm

String toExternalForm ()

构造此URL的字符串表示URL 。 该字符串通过调用此对象的流协议处理程序的toExternalForm方法来创建。

toString

String toString ()

构造此URL的字符串表示URL 。 该字符串通过调用此对象的流协议处理程序的toExternalForm方法来创建。

toURI

URI toURI ()

返回等同于此URL的URI 。 该方法的功能与new URI (this.toString())相同。

请注意，符合RFC 2396的任何URL实例都可以转换为URI。 但是，一些不严格遵守的URL不能转换为URI。

set

void set (String protocol, 
                String host, 
                int port, 
                String authority, 
                String userInfo, 
                String path, 
                String query, 
                String ref)

设置URL的指定8个字段。 这不是一个公共方法，因此只有URLStreamHandlers可以修改URL字段。 URL是不变的。

set

void set (String protocol, 
                String host, 
                int port, 
                String file, 
                String ref)

设置URL的字段。 这不是一个公共方法，因此只有URLStreamHandlers可以修改URL字段。 URL是不变的。