S-JIS[2010-01-22] 変更履歴

URI

java.net.URIクラスは、URIを扱うクラス。JDK1.4以降。
このクラスは不変オブジェクト。

• URIを生成する方法
• 判断用メソッド
• 値取得メソッド
• 使用例

URI生成例

コンストラクターでは、生成したURIが間違った形式の時はURISyntaxExceptionが発生する。
create()メソッドだと、間違っていたらIllegalArgumentExceptionが発生する（RuntimeException系なので、明示的にcatchを書く必要が無い）。プログラムで生成したURI文字列を渡すなど、「間違っていないはず」の場合に使用する。

URIから別のURIを生成するメソッド。

relativize()は、「接頭辞として一致するURI」からしか相対URIを生成できないのが残念。

他クラスとURIとの変換。

判断メソッド

値取得メソッド

java.net.URIは不変クラスなので、ゲッターメソッドは有るがセッターメソッドは無い。

通常のクラスではゲッターメソッドはコンストラクターで指定した値をそのまま返す事が多いが、
java.net.URIでは、単なるゲッターメソッドのほとんどはデコードされた文字列を返す。（%XX形式を“人間が読める文字”に変換する）
コンストラクターで指定した値をそのまま取得したい場合は、「getRaw」で始まるゲッターメソッドを使用する。

URLのエンコード・デコードにはURLEncoder・URLDecoderを使うものだと思うが、
java.net.URIの個々のゲッターメソッドのデコードにはCharsetDecoder、
toASCIIString()のエンコードにはCharsetEncoderが使われているようだ。

URIクラスでは「scheme」というつづりなので（「schema」という単語は別途あるし）、日本語では「スキーム」が正しいんじゃないかと思わなくもないが、Javadocでは「スキーマ」となっている。
でも確かに「http:」とかを「スキーマ」と呼んでる人の方が多いので、「スキーム」と言われると違和感があるかも(苦笑)

データ取得例

変換例

ローカルファイルの絶対パスを相対パスに変換する例

基準となる親ディレクトリーからの相対パスに変換する例。

	File dir = new File("C:\\temp\\html");
	File f   = new File("C:\\temp\\html\\abc\\index.html");

	URI fru = dir.toURI().relativize(f.toURI());
	File rf = new File(fru.toString());

	System.out.println("相対パスのFile：" + rf);
	System.out.println(rf.isAbsolute());

↓

相対パスのFile：abc\index.html
false

ちなみにFileで相対パスから絶対パスにしたい場合、URIを使うまでもなく、new File(dir, rf.getPath())でよい。
（相対パスに含まれる「..」とかを除去したい場合は、さらにFile#getCanonicalFile()を呼び出すとか）

ローカルファイルの絶対パスからhttpのURIに変換する例

「C:\temp\html」の下にある「abc\index.html」を、ベースURI「http://host/root/」を基準とした「http://host/root/abc/index.html」に変換する例。

	File dir = new File("C:\\temp\\html");
	File f   = new File("C:\\temp\\html\\abc\\index.html");

	URI fru = dir.toURI().relativize(f.toURI());
	System.out.println("ファイルの相対パスのURI：" + fru);

	URI base = new URI("http://host/root/"); //ベースURI
	URI uri = base.resolve(fru);
	System.out.println(uri);

↓

ファイルの相対パスのURI：abc/index.html
http://host/root/abc/index.html

Fileのパスは相対パスでも大丈夫。（normalize()されるようだ）