创建 URL

原文： https://docs.oracle.com/javase/tutorial/networking/urls/creatingUrls.html

创建URL对象的最简单方法是使用String来表示 URL 地址的人类可读形式。这通常是另一个人将用于 URL 的表单。在 Java 程序中，您可以使用包含此文本的String来创建URL对象：

  1. URL myURL = new URL("http://example.com/");

上面创建的URL对象表示绝对 URL_ 。绝对 URL 包含到达相关资源所需的所有信息。您还可以从相对 URL_ 地址创建URL对象。

创建相对于另一个的 URL

相对 URL 仅包含足以相对于另一个 URL（或在其上下文中）到达资源的信息。

相对 URL 规范通常在 HTML 文件中使用。例如，假设您编写了一个名为JoesHomePage.html的 HTML 文件。在此页面中，是指向JoesHomePage.html和其他页面PicturesOfMe.html和MyKids.html的链接，这些页面位于同一台机器上，与JoesHomePage.html位于同一目录中。来自JoesHomePage.html的PicturesOfMe.html和MyKids.html链接可以像文件名一样指定，如下所示：

  1. <a href="PicturesOfMe.html">Pictures of Me</a>
  2. <a href="MyKids.html">Pictures of My Kids</a>

这些 URL 地址是*相对 URL_ 。也就是说，URL 是相对于包含它们的文件指定的 - JoesHomePage.html。

在 Java 程序中，您可以从相对 URL 规范创建URL对象。例如，假设您在站点example.com知道两个 URL：

  1. http://example.com/pages/page1.html
  2. http://example.com/pages/page2.html

您可以相对于它们的公共基本 URL 为这些页面创建URL对象：http://example.com/pages/，如下所示：

  1. URL myURL = new URL("http://example.com/pages/");
  2. URL page1URL = new URL(myURL, "page1.html");
  3. URL page2URL = new URL(myURL, "page2.html");

此代码段使用URL构造器，该构造器允许您从另一个URL对象（基础）和相对 URL 规范创建URL对象。这个构造器的一般形式是：

  1. URL(URL baseURL, String relativeURL)

第一个参数是URL对象，它指定新URL的基础。第二个参数是String，它指定相对于基础的资源名称的其余部分。如果baseURL为 null，则此构造器将relativeURL视为绝对 URL 规范。相反，如果relativeURL是绝对 URL 规范，则构造器忽略baseURL。

此构造器还可用于为文件中的命名锚点（也称为引用）创建URL对象。例如，假设page1.html文件在文件底部有一个名为BOTTOM的命名锚。您可以使用相对 URL 构造器为它创建URL对象，如下所示：

  1. URL page1BottomURL = new URL(page1URL,"#BOTTOM");

其他 URL 构造器

URL类提供了两个用于创建URL对象的附加构造器。当您使用 URL（例如 HTTP URL）时，这些构造器非常有用，这些 URL 在 URL 的资源名称部分中具有主机名，文件名，端口号和引用组件。当您没有包含完整 URL 规范的 String 时，这两个构造器很有用，但您确实知道 URL 的各种组件。

例如，假设您设计了一个类似于文件浏览面板的网络浏览面板，允许用户选择协议，主机名，端口号和文件名。您可以从面板的组件构造URL。第一个构造器根据协议，主机名和文件名创建URL对象。以下代码段在example.com站点的page1.html文件中创建URL：

  1. new URL("http", "example.com", "/pages/page1.html");

这相当于

  1. new URL("http://example.com/pages/page1.html");

第一个参数是协议，第二个是主机名，最后一个是文件的路径名。请注意，文件名在开头包含正斜杠。这表示文件名是从主机的根目录指定的。

最后的URL构造器将端口号添加到前一个构造器中使用的参数列表中：

  1. URL gamelan = new URL("http", "example.com", 80, "pages/page1.html");

这将为以下 URL 创建URL对象：

  1. http://example.com:80/pages/page1.html

如果使用这些构造器之一构造URL对象，则可以使用URL对象的toString方法或等效的toExternalForm方法获取包含完整 URL 地址的String。

带有特殊字符的 URL 地址

某些 URL 地址包含特殊字符，例如空格字符。像这样：

  1. http://example.com/hello world/

要使这些字符合法，需要在将它们传递给 URL 构造器之前对其进行编码。

  1. URL url = new URL("http://example.com/hello%20world");

对此示例中的特殊字符进行编码很容易，因为只有一个字符需要编码，但对于具有多个这些字符的 URL 地址，或者如果您不确定在编写代码时需要访问哪些 URL 地址，您可以使用 java.net.URI 类的多参数构造器自动为您处理编码。

  1. URI uri = new URI("http", "example.com", "/hello world/", "");

然后将 URI 转换为 URL。

  1. URL url = uri.toURL();

MalformedURLException 的

如果构造器的参数引用null或未知协议，则四个URL构造器中的每一个都抛出MalformedURLException。通常，您希望通过在try / catch对中嵌入 URL 构造器语句来捕获和处理此异常，如下所示：

  1. try {
  2.     URL myURL = new URL(...);
  3. } 
  4. catch (MalformedURLException e) {
  5.     // exception handler code here
  6.     // ...
  7. }

有关处理异常的信息，请参见例外。

Note:

URL是“一次写入”对象。一旦创建了URL对象，就无法更改其任何属性（协议，主机名，文件名或端口号）。