Classpath resources（クラスパスからリソースを読み込むあれこれ。jarの中とか。）

java

Webではあまり気にしたことのなかったリソースの配置場所なのですが、
スタンドアロンで配布する場合どこに置いてどう読み込むのかと。
（jarに全部固める場合とか、絶対パス指定できないとか）


propertiesファイルをjarの中に入れてしまいたいのです。


で、そういえばSeasarさんは何個かdiconファイルがjarの中にあったなーと思い、色々のぞいてみて
「おぉ、クラスローダーを使うのか」となりました。（ResourceUtilらへんを参照させてもらいました）。


その流れで
http://www.javaworld.com/javaworld/javaqa/2003-08/01-qa-0808-property.html
のステキな表にたどり着いたのでコピっておきます。

Behavioral differences

Method Parameter format Lookup failure behavior Usage example
ClassLoader.getResourceAsStream() "/"-separated names; no leading "/" (all names are absolute) Silent (returns null) this.getClass().getClassLoader().getResourceAsStream("some/pkg/resource.properties")
Class.getResourceAsStream() "/"-separated names; leading "/" indicates absolute names; all other names are relative to the class's package Silent (returns null) this.getClass().getResourceAsStream("resource.properties")
ResourceBundle.getBundle() "."-separated names; all names are absolute; .properties suffix is implied Throws unchecked java.util.MissingResourceException ResourceBundle.getBundle("some.pkg.resource")
  • ClassLoader.getResourceAsStream()
    • クラスパスの頭から。
    • 区切りは「/」で。
    • 頭に「/」は入れない。
  • Class.getResourceAsStream()
    • クラスのある場所から。
    • 区切りは「/」で。
    • 先頭に「/」を入れたら、クラスパスの頭から。
  • ResourceBundle.getBundle()
    • クラスパスの頭から。
    • 区切りは「.」で。