Java Language
Bronnen (op classpath)

Invoering

Opmerkingen

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);
    }
}

Een afbeelding laden vanuit een bron

Een gebundelde afbeelding laden:

package com.example;

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

Standaardconfiguratie laden

Standaard configuratie-eigenschappen lezen:

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;
    }
}

Bron met dezelfde naam laden vanuit meerdere JAR's

Bron met hetzelfde pad en dezelfde naam kan voorkomen in meer dan één JAR-bestand op het klassepad. Veel voorkomende gevallen zijn middelen volgens een conventie of die deel uitmaken van een verpakkingsspecificatie. Voorbeelden van dergelijke middelen zijn

• META-INF / MANIFEST.MF
• META-INF / beans.xml (CDI Spec)
• ServiceLoader-eigenschappen met implementatieproviders

Om toegang te krijgen tot al deze bronnen in verschillende potten, moet men een ClassLoader gebruiken, die hiervoor een methode heeft. De geretourneerde Enumeration kan eenvoudig worden omgezet in een List met behulp van een Collectiefunctie.

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

Bronnen zoeken en lezen met een classloader

Het laden van bronnen in Java omvat de volgende stappen:

1. De Class of ClassLoader zoeken die de bron zal vinden.
2. De bron vinden.
3. De bytestream verkrijgen voor de bron.
4. De bytestream lezen en verwerken.
5. De bytestream sluiten.

De laatste drie stappen worden meestal uitgevoerd door de URL door te geven aan een bibliotheekmethode of constructor om de bron te laden. In dit geval gebruikt u meestal een methode getResource . Het is ook mogelijk om de brongegevens in de toepassingscode te lezen. In dit geval gebruikt u meestal getResourceAsStream .

Absolute en relatieve bronpaden

Bronnen die vanuit het classpath kunnen worden geladen, worden aangegeven met een pad . De syntaxis van het pad is vergelijkbaar met een UNIX / Linux-bestandspad. Het bestaat uit eenvoudige namen gescheiden door schuine streep ( / ) tekens. Een relatief pad begint met een naam en een absoluut pad begint met een scheidingsteken.

Zoals de Classpath-voorbeelden beschrijven, definieert een JVM's classpath een naamruimte door de naamruimten van de mappen en JAR- of ZIP-bestanden in het classpath te overlappen. Wanneer een absoluut pad is opgelost, interpreteren de classloaders de initiaal / als de root van de naamruimte. Een relatief pad kan daarentegen worden omgezet ten opzichte van elke "map" in de naamruimte. De gebruikte map is afhankelijk van het object dat u gebruikt om het pad op te lossen.

Een klasse of Classloader verkrijgen

Een resource kan worden gevonden met behulp van een Class object of een ClassLoader object. Een Class object kan relatieve paden oplossen, dus u gebruikt meestal een van deze als u een (class) relatieve resource hebt. Er zijn verschillende manieren om een Class object te verkrijgen. Bijvoorbeeld:

• Een letterlijke klasse geeft u het Class object voor elke klasse die u in Java-broncode kunt noemen; bijv. String.class geeft u het Class object voor het String type.

• Object.getClass() geeft u het Class object voor het type od elk object; bijv. "hello".getClass() is een andere manier om Class van het String type te krijgen.

• De methode Class.forName(String) laadt (indien nodig) een klasse dynamisch en retourneert het Class object; bijv. Class.forName("java.lang.String") .

Een ClassLoader object wordt meestal verkregen door getClassLoader() aan te roepen op een Class object. Het is ook mogelijk om de standaardklasse- ClassLoader.getSystemClassLoader() van de JVM te verkrijgen met behulp van de statische methode ClassLoader.getSystemClassLoader() .

De get methoden

Zodra u een instantie Class of ClassLoader hebt, kunt u een bron vinden op een van de volgende manieren:

Opmerkingen:

• Het belangrijkste verschil tussen de ClassLoader en Class versies van de methoden is dat relatieve paden worden geïnterpreteerd.

  • Met de Class methoden wordt een relatief pad in de "map" opgelost dat overeenkomt met het klassenpakket.
  • De ClassLoader methoden behandelen relatieve paden alsof ze absoluut zijn; dat wil zeggen het oplossen ervan in de "hoofdmap" van de classpath-naamruimte.

• Als de gevraagde resource (of resources) niet kunnen worden gevonden, retourneren de methods return getResource en getResourceAsStream null , and the retourneren de methods return an empty getResources methods return an empty Enumeratie`.

• De geretourneerde URL's kunnen worden URL.toStream() met URL.toStream() . Dit kunnen file: URL's of andere conventionele URL's zijn, maar als de bron zich in een JAR-bestand bevindt, zijn dit jar: URL's die het JAR-bestand en een specifieke bron erin identificeren.

• Als uw code een methode getResourceAsStream (of URL.toStream() ) gebruikt om een InputStream te verkrijgen, is deze verantwoordelijk voor het afsluiten van het stream-object. Als de stroom niet wordt afgesloten, kan er een bronlek optreden.