12.5 Ressourcen wie Grafiken aus dem Klassenpfad und aus Jar-Archiven laden

Um Ressourcen wie Grafiken oder Konfigurationsdateien aus Jar-Archiven zu laden, ist die Methode getResourceAsStream() beziehungsweise getResource() ideal. Sie sind Methoden des Class-Objekts. getResource() gibt ein URL-Objekt für die Ressource zurück. Da oft der Inhalt des Datenstroms interessant ist, liefert getResourceAsStream() einen InputStream. Intern wird aber nichts anderes gemacht als getResource() aufgerufen und mit openStream() ein Eingabe-Objekt geholt. Nur getResourceAsStream() fängt eine eventuelle IOException ab und liefert dann die Rückgabe null.

Da der Klassenlader die Ressource findet, entdeckt er alle Dateien, die im Pfad des Klassenladers eingetragen sind. Das gilt auch für Jar-Archive, denn dort ist alles vom Klassenlader verfügbar. Falls die Quelle nicht aufgelöst werden konnte, liefern die Methoden null. null wird auch zurückgegeben, wenn die Sicherheitsrichtlinien das Lesen verbieten.

class C
{
  InputStream in1 = C.class.getResourceAsStream( "kullin_fun.txt" );

  void lade()
  {
    InputStream in2 = getClass().getResourceAsStream( "hirse_fun.jpg" );
  }
}

Da zum Nutzen der getResourceXXX()-Methoden ein Class-Objekt nötig ist, zeigt das Beispiel zum einen, dass über C.class das Class-Objekt zu bekommen ist, und zum anderen, dass in einer Objektmethode ebenfalls die geerbte Object-Methode getClass() ein Class-Objekt liefert.