Java Language
リソース（クラスパス上）

前書き

備考

package com.example;

public class ExampleApplication {
    public void readImage()
    throws IOException {

        URL imageURL = ExampleApplication.class.getResource("icon.png");

        // The above statement is identical to:
        // ClassLoader loader = ExampleApplication.class.getClassLoader();
        // URL imageURL = loader.getResource("com/example/icon.png");

        Image image = ImageIO.read(imageURL);
    }
}

リソースからイメージをロードする

バンドルされたイメージをロードするには：

package com.example;

public class ExampleApplication {
    private Image getIcon() throws IOException {
        URL imageURL = ExampleApplication.class.getResource("icon.png");
        return ImageIO.read(imageURL);
    }
}

デフォルト設定の読み込み

デフォルトの構成プロパティーを読み取るには：

package com.example;

public class ExampleApplication {
    private Properties getDefaults() throws IOException {
        Properties defaults = new Properties();

        try (InputStream defaultsStream =
            ExampleApplication.class.getResourceAsStream("config.properties")) {

            defaults.load(defaultsStream);
        }

        return defaults;
    }
}

複数のJARから同じ名前のリソースをロードする

同じパスと名前を持つリソースは、クラスパス上の複数のJARファイルに存在する可能性があります。一般的なケースは、慣習に従ったリソースまたはパッケージ仕様の一部であるリソースです。そのようなリソースの例は次のとおりです。

• META-INF / MANIFEST.MF
• META-INF / beans.xml（CDI仕様）
• 実装プロバイダを含むServiceLoaderプロパティ

別の瓶でこれらのすべてのリソースへのアクセスを得るためには、このためのメソッドを持つクラスローダを使用する必要があります。返されたEnumerationは、Collections関数を使用してList簡単に変換できます。

Enumeration<URL> resEnum = MyClass.class.getClassLoader().getResources("META-INF/MANIFEST.MF");
ArrayList<URL> resources = Collections.list(resEnum);

クラスローダーを使用したリソースの検索と読み取り

Javaでのリソースのロードは、次の手順で構成されます。

1. リソースを見つけるClassまたはClassLoader検索。
2. リソースを見つける。
3. リソースのバイトストリームを取得します。
4. バイトストリームの読み取りと処理。
5. バイトストリームを閉じます。

最後の3つのステップは、通常、URLをライブラリメソッドまたはコンストラクタに渡してリソースをロードすることによって実現されます。通常、この場合はgetResourceメソッドを使用しgetResource 。アプリケーションコード内のリソースデータを読み取ることもできます。通常、この場合はgetResourceAsStreamを使用しgetResourceAsStream 。

絶対および相対リソースパス

クラスパスからロードできるリソースは、パスで示されます 。パスの構文は、UNIX / Linuxファイルパスに似ています。スラッシュ（ / ）文字で区切られた単純な名前で構成されています。 相対パスは名前で始まり、 絶対パスはセパレータで始まります。

クラスパスの例で説明しているように、JVMのクラスパスは、クラスパスにディレクトリとJARまたはZIPファイルの名前空間をオーバーレイすることによって名前空間を定義します。絶対パスが解決されると、クラスローダーは最初の/を名前空間のルートを意味するものとして解釈します。対照的に、相対パスは名前空間内の任意の「フォルダ」に対して解決される可能性があります。使用されるフォルダは、パスを解決するために使用するオブジェクトによって異なります。

クラスまたはクラスローダの取得

リソースは、 ClassオブジェクトまたはClassLoaderオブジェクトのいずれかを使用してClassLoaderます。 Classオブジェクトは相対パスを解決することができるため、（クラス）相対リソースがある場合は、通常はこれらのいずれかを使用します。 Classオブジェクトを取得するにはさまざまな方法があります。例えば：

• クラスリテラルは、Javaソースコードで名前を付けることができる任意のクラスのClassオブジェクトを提供します。例えばString.classはString型のClassオブジェクトを提供します。

• Object.getClass()は、任意のオブジェクトタイプのClassオブジェクトを提供します。例えば"hello".getClass()は、 String型のClassを取得する別の方法です。

• Class.forName(String)メソッドは（必要に応じて）クラスを動的にロードし、そのClassオブジェクトを返します。例： Class.forName("java.lang.String") 。

ClassLoaderオブジェクトは、通常、 Classオブジェクトに対してgetClassLoader()を呼び出すことによって取得されます。静的なClassLoader.getSystemClassLoader()メソッドを使用して、JVMのデフォルトクラスローダーを取得することもできます。

getメソッド

ClassまたはClassLoaderインスタンスをClassLoaderたら、次のいずれかの方法でリソースを見つけることができます。

ノート：

• ClassLoaderとClassバージョンのメソッドの主な違いは、相対パスが解釈される方法です。

  • Classメソッドは、クラスパッケージに対応する "フォルダ"内の相対パスを解決します。
  • ClassLoaderメソッドは、相対パスを絶対パスとして扱います。つまり、クラスパス名前空間の "ルートフォルダ"でそれらを解決します。

• 要求されたリソース（またはリソース）が見つからない場合、 getResourceおよびgetResourceAsStream methods return nullをmethods return , and the getResources methods return an empty Enumeration`をmethods return an emptyます。

• 返されるURLは、 URL.toStream()を使用して解決できます。それらはfile: URLや他の従来のURLでもかまいませんが、リソースがJARファイルにある場合、JARファイルとその中の特定のリソースを識別するjar: URLになります。

• コードがgetResourceAsStreamメソッド（またはURL.toStream() ）を使用してInputStreamを取得する場合は、ストリームオブジェクトを閉じる必要があります。ストリームを閉じないと、リソースがリークする可能性があります。