Java - Jar ファイルの中のリソースの読み込みについて nullを参照してしまう

Question

##目的
Java で Jar ファイルの中にリソースファイルを入れ、
そのリソースファイルを読み込みたいのですが、
その読み込むクラスと同じ階層のファイルしか読み込むことができません。

一つ下の階層のファイルまで読み込むにはどうすればよいのでしょか。

勉強は Eclipse を使っています。Eclipse で起動したときは下のようなエラーは発生しません。

###ファイル構成

![

Out.txt は起動後に生成されます。

###ファイルの内容

• same.txt <= same
• first.txt <= first
• second.txt <= second
• third.txt <= third

それぞれのファイル名が一文ずつ入力されています。

##エラーメッセージ

Exception in thread "main" java.lang.NullPointerException
             at java.io.Reader.<init>(Reader.java:78)
             at java.io.InputStreamReader.<init>(InputStreamReader.java:97)
             at step16.Test.<init>(Test.java:23)
             at step16.Test.main(Test.java:45)

生成した Jar ファイルをコマンドプロンプトで起動しました。
リソースファイルが見つからないようです。

###ソースコード

package step16;

import java.io.*;

public class Test {
	Test(String name){
		try {
			File f            = new File("Out.txt");
			FileWriter fw     = new FileWriter(f,true);
			BufferedWriter bw = new BufferedWriter(fw);
			PrintWriter pw    = new PrintWriter(bw);
			
			InputStream is        = getClass().getResourceAsStream(name);
			InputStreamReader isr = new InputStreamReader(is,"UTF-8");
			BufferedReader br     = new BufferedReader(isr);
			
			while (true){
				String temp = br.readLine();
				
				if (temp==null){
					break;
				}
				
				pw.println(temp);
			}
			
			pw.close();
			br.close();
		} catch (IOException e) {
		}
	}
	@SuppressWarnings("unused")
	public static void main(String[] args){
		Test t1=new Test("same.txt");             //同じ階層のファイル
		Test t2=new Test("first\\first.txt");     //一つ下の階層のファイル
		Test t3=new Test("../second.txt");        //一つ上の階層のファイル
		Test t4=new Test("../third\\third.txt");  //一つ上の階層にあるディレクトリにあるファイル
	}
}

###実行結果

Eclipseで起動
Out.txt の内容は

1. same
2. first
3. second
4. third

でした。

Test.jar にエクスポートして起動（ダブルクリックやコマンドプロンプトから）
Out.txt の内容は

1. same

でした。

Answer 1

HouraijiICさんの回答の通りかと思います。

Javaのclass loaderのAPIドキュメントを見ても今一つ詳しく書いてくれてはいないですね。

Class#getResourceはClassLoader#getResourceに移譲されるのですが、その際に相対パスで指定したリソース名は絶対パスに変換されます。指定リソース名を絶対パスに変換する規則では「一つ上の階層を".."で解釈する」といったようなことはしてくれず単純にパッケージ名（の"."を"/"に置き換えたもの）へ指定名を連結して生成されます。よって次のようなものがリソースの絶対パスとして解釈されてしまいます。

"step16/first\first.txt"
"step16/../second/second.txt"

上記はjar内ではなくWindowsのディレクトリー上に直接置かれたクラスに対するClassLoaderではWindowsのファイルパスとして解釈され/も\もディレクトリーの区切りとして解釈され..は単にそういう名前のディレクトリーとして解釈されます。ご存知のようにWindowsでもLinuxでも".."は一つ上のディレクトリーを表す単なるディレクトリーなので質問者さんが意図したとおりのファイルを見つけることができます。しかしLinux上で同様のことをすると\はディレクトリーの区切りとはみなしてくれないため同様のトラブルが発生すると思います。

またjarファイルの中にあるクラスのClassLoaderは、指定されたパスをjava.util.jar.JarFile#getJarEntryに渡すパスとして解釈します。jarファイルのエントリー名はディレクトリーに似た階層を表現できはしますがそこには「..を一つ上の階層として解釈する」といったような仕様はなく指定した名前と単純比較されるだけです。このためご質問のような結果となります。

以上よりgetResourceに指定する名前はClassLoaderが解釈できるような名前でなくてはならないことを意識し、どのような場所に置かれたクラスでも同様にアクセスできるようにするためには/を区切りに用い、..は用いないようにするのがよいといえるでしょう。

Comments

[FoolHotari]

今後は ClassLoader で .. を使用しないようにします。
ありがとうございます。

Answer 2

https://docs.oracle.com/javase/jp/8/docs/technotes/guides/lang/resources.html内
・「位置に依存しない方法でのリソースへのアクセス」
・・「java.lang.Classのメソッドの使用」内の↓辺りではないかと。。。

『上記URLより引用-ここから』
getResourceおよびgetResourceAsStreamメソッドは、指定された名前のリソースを検索します。これらのメソッドは、指定された名前のリソースが見つからないとnullを返します。指定されたクラスに関連するリソースを検索するための規則は、そのクラスのClassLoaderによって実装されます。Classのメソッドは、命名規則の適用後にClassLoaderメソッドに委譲されます。リソース名が「/」で始まる場合は、その名前がそのまま使用されます。そうでない場合は、すべてのピリオド(.)がスラッシュ(/)に変換されてから、パッケージ名が先頭に付加されます。
『上記URLより引用-ここまで』

ということで、ClassLoaderを使った例は検索すれば、多々見つかるので、
とりあえず、提示されたコードをエラー無く
java -classpath Test.jar top.third.step16/Test
するため、下記の様にしてみました。

※first\firstはfirst/firstへ変更。
※t3,t4はクラストップからのパスへ変更。

src
 |-top
 |  |-third
 |  |  |-step16
 |  |  |  |-first
 |  |  |  |  |-first.txt
 |  |  |  |-Test.java
 |  |  |  |-same.txt
 |  |  |-third.txt
 |  |-second.txt

	public static void main(String[] args){
        Test t1=new Test("same.txt");             //同じ階層のファイル
        Test t2=new Test("first/first.txt");      //一つ下の階層のファイル
        Test t3=new Test("/top/second.txt");      //一つ上の階層のファイル
        Test t4=new Test("/top/third/third.txt"); //一つ上の階層にあるディレクトリにあるファイル
    }

Comments

[FoolHotari]

main メソッドを訂正したところ、期待通りに読み込まれました。
ありがとうございます。