URL を作成する

URL オブジェクトを作成する最も簡単な方法は、URL アドレスの "人が読んで意味がわかる" 書式を表す文字列をもとに作成することである。これは一般に、別の人が URL について述べるときに使用する書式である。たとえば、Java 対応のサイトのリストをもつ Gamelan サイトを示すときは、次のような書式になる。
http://www.gamelan.com/ 
Java プログラムでは、上記のテキストをもたせた文字列を使って、URL オブジェクトを作成することができる。
URL gamelan = new URL("http://www.gamelan.com/");
上記で作成された URL オブジェクトは絶対パスの URL を表す。絶対パスの URL には当該の資源へ到達するのに必要な情報がすべて納められている。URL オブジェクトは相対パスの URL のアドレスから作成することもできる。

別の URL に相対的に位置する URL を作成する
相対パスの URL には別の URL に相対的に位置する (または別の URL のコンテキストにある) 資源へ到達するのに足りる情報だけが納められている。

相対パスの URL 指定は HTML ファイル内でしばしば使用される。たとえば、読者が JoesHomePage.html という名前の HTML ファイルを作成するとする。このページ内で、JoesHomePage.html と同じマシンの同じディレクトリにある別のページ、PicturesOfMe.html と MyKids.html へリンクするとする場合、 JoesHomePage.html からの PicturesOfMe.html と MyKids.html へのリンクは、次のように、ファイル名だけで指定できる。
<a href="PicturesOfMe.html">Pictures of Me</a>
<a href="MyKids.html">Pictures of My Kids</a>
これらの URL アドレスは相対パスの URL である。つまり、納められているファイル、JoesHomePage.html への相対位置で URL が指定されているのである。

Java プログラムでは、相対パスの URL 指定をもとに URL オブジェクトを作成することができる。たとえば、読者が自分のプログラムで "http://www.gamelan.com/" の URL をすでに作成していて、そのサイトにあるいくつかのファイルの名前 (Gamelan.network.html と Gamelan.animation.html) がわかっているとする。この場合、初めの Gamelan URL のコンテキストでファイル名を指定するだけで、Gamelan サイトの各ファイルの URL を作成することができる。ファイル名が相対パスの URL であり、初めの Gamelan URL との相対位置でとらえられる。
URL gamelan = new URL("http://www.gamelan.com/");
URL gamelanNetwork = new URL(gamelan, "Gamelan.network.html");
このコード片は、URL オブジェクト (ベース) と相対パスの URL をもとに URL オブジェクトを作成できる、URL クラスのコンストラクタを使用している。

このコンストラクタは、ファイル内で名前の付けられているアンカー (リファレンス とも呼ばれる) への URL を作成するときにも便利である。たとえば、 "Gamelan.network.html" ファイルの末尾に BOTTOM という名前のアンカーがあるとする。この場合、次のように相対パスの URL コンストラクタを使用して URL を作成することができる。
URL gamelanNetworkBottom = new URL(gamelanNetwork, "#BOTTOM");
この URL コンストラクタの一般的な書式は次のとおりである。
URL(URL baseURL, String relativeURL)
最初の引数は新規の URL のベースを指定する URL オブジェクトである。2 番目の引数はベースへの相対位置から資源名の残りを指定する文字列である。 baseURL が null の場合は、このコンストラクタは relativeURL の部分を絶対パスの URL 指定として扱う。逆に、relativeURL が絶対パスの URL 指定の場合は、コンストラクタは baseURL を無視する。
その他の URL コンストラクタ
URL クラスには URL オブジェクトを作成するためのコンストラクタがあと 2 つ追加されている。これらのコンストラクタは、URL の資源名の部分にホスト名や、ファイル名、ポート番号、リファレンスの構成要素をもつ、HTTP URL のような URL を扱うときに便利である。また、完全な URL 指定のための文字列は不明だが、URL のさまざまな構成要素はわかっている場合にも有効である。

たとえば、ファイル表示パネルに似せて、ユーザがマウスを使ってプロトコル、ホスト名、ポート番号、ファイル名を選択するネットワーク表示パネルを作成する場合、その構成要素をもとに URL を作成することができる。追加のコンストラクタの 1 つがプロトコル、ホスト名、ファイル名をもとに URL を作成する。次に示すコード片は、Gamelanサイトにある Gamelan.network.html ファイルの URL を作成している。
URL gamelan = new URL("http", "www.gamelan.com", 
"/Gamelan.network.html");
これは URL("http://www.gamelan.com/Gamelan.network.html") と等価である。最初の引数はプロトコル、2 番目の引数ホスト名、最後の引数はファイルのパス名である。ファイル名の先頭にスラッシュ (/) 文字があることに注意する。これはそのファイル名がホストのルートから指定されていることを表している。

最後の URL コンストラクタは前のコンストラクタで使用された引数のリストにポート番号を追加する。
URL gamelan = new URL("http", "www.gamelan.com", 80, 
"/Gamelan.network.html");
これは次に示す URL の URL オブジェクトを作成している。
http://www.gamelan.com:80/Gamelan.network.html
これまでに述べたコンストラクタの 1 つを使って URL を作成する場合、URL の toString() メソッドまたは同等の toExternalForm() メソッドにより、完成した URL アドレスをもつ文字列を得ることができる。
MalformedURLException
4 つの URL コンストラクタのどれでも、引数が null や不明のプロトコルを参照した場合は、MalformedURLException をあげる。一般に、この例外はキャッチして処理する必要がある。したがって、URL コンストラクタ文には try/catch の対を組み込んでおくのが普通である。
try {
    URL myURL = new URL(. . .)
} catch (MalformedURLException e) {
    . . .
    // 例外ハンドラのコードをここに記述する
    . . .
}
例外処理については、例外を使ってエラーを処理するを参照する。
注: URL は "1 回しか書き込めない" オブジェクトである。URL オブジェクトをいったん作成した後は、その属性 (プロトコル、ホスト名、ファイル名、ポート番号) をいっさい変更することができない。

URL を扱う