de.jsystems.tools.resource
Class ResourceReader

java.lang.Object
  extended byde.jsystems.tools.resource.ResourceReader

public class ResourceReader
extends Object

Diese Klasse ist in der Lage, in einer JAR-Datei hinterlegte Ressourcen auszulesen. Dabei wird die entsprechenden Datei gelesen wie eine Klasse. Es gibt die Möglichkeit, sich direkt den Stream geben zu lassen, oder aber einen entsprechenden String(sinnvoll bei Textdateien) oder aber Bilder auszulesen. Als Bild auslesen geht hier aber nur mit GIF und JPG.

Version:
1.0
Author:
Jens Homm

Constructor Summary
ResourceReader()
          Erzeugt einen RessourceReader.
 
Method Summary
 InputStream getResourceStream(String path, String file)
          Holt einen Stream zum lesen einer Ressource im Classpath.
 Image loadImageResource(String path, String file)
          Liest eine Bildressource aus, die sich mit in einer JAR-Datei befindet.
 String loadTextResource(String path, String file)
          Liest eine Textressource aus, die sich mit in einer JAR-Datei befindet.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ResourceReader

public ResourceReader()
Erzeugt einen RessourceReader.

Method Detail

getResourceStream

public InputStream getResourceStream(String path,
                                     String file)
Holt einen Stream zum lesen einer Ressource im Classpath. Der erste Parameter dabei ist der Pfadname zur gewünschten Datei als Packagepfad (also mit Punkten). Falls sich der Ordner mit den Ressourcen auf der gleichen Höhe befindet wie der Beginn des Packagepfades(z.B.: Das Package beginnt mit 'de'. Dort, wo sich dieser Ordner befindet, befindet sich auch der Ressourcenordner 'ressource'), wird einfach nur der Ordnername angegeben. Der zweite Parameter enthält den Namen der zu lesenden Datei.

Parameters:
path - - Der Pfad zur Ressourcedatei, beginnend auf der Höhe des Beginns der Packages.
file - - Der Name der Ressourcedatei
Returns:
Einen InputStream für die Ressource

loadTextResource

public String loadTextResource(String path,
                               String file)
                        throws IOException
Liest eine Textressource aus, die sich mit in einer JAR-Datei befindet. Der erste Parameter dabei ist der Pfadname zur gewünschten Datei als Packagepfad (also mit Punkten). Falls sich der Ordner mit den Ressourcen auf der gleichen Höhe befindet wie der Beginn des Packagepfades(z.B.: Das Package beginnt mit 'de'. Dort, wo sich dieser Ordner befindet, befindet sich auch der Ressourcenordner 'ressource'), wird einfach nur der Ordnername angegeben. Der zweite Parameter enthält den Namen der zu lesenden Datei. Falls es die Ressourcedatei nicht gibt, wird null zurückgegeben.

Parameters:
path - - Der Pfad zur Ressourcedatei, beginnend auf der Höhe des Beginns der Packages.
file - - Der Name der Ressourcedatei
Returns:
Einen String mit dem Inhalt der Ressourcedatei oder null.
Throws:
IOException

loadImageResource

public Image loadImageResource(String path,
                               String file)
                        throws IOException
Liest eine Bildressource aus, die sich mit in einer JAR-Datei befindet. Der erste Parameter dabei ist der Pfadname zur gewünschten Datei als Packagepfad (also mit Punkten). Falls sich der Ordner mit den Ressourcen auf der gleichen Höhe befindet wie der Beginn des Packagepfades(z.B.: Das Package beginnt mit 'de'. Dort, wo sich dieser Ordner befindet, befindet sich auch der Ressourcenordner 'ressource'), wird einfach nur der Ordnername angegeben. Der zweite Parameter enthält den Namen der zu lesenden Datei. Falls es die Ressourcedatei nicht gibt, wird null zurückgegeben.

Parameters:
path - - Der Pfad zur Ressourcedatei, beginnend auf der Höhe des Beginns der Packages.
file - - Der Name der Ressourcedatei
Returns:
Das gewünschte Bild als Image oder null.
Throws:
IOException