ea

Class DateiManager

java.lang.Object

ea.DateiManager

public class DateiManager
extends java.lang.Object

Der Dateimanager ist eine Klasse, die die systemspezifischen Pfadregeln beachtend die jeweils korrekten Zeichenketten für die entsprechenden Dateiverzeichnisse kennt.

Ausserdem kann sie die Informationen eines Pixelfeldes im .eaf-Format (Engine-Alpha-Figur-Format) speichern sowie die eines String- oder Integer-Arrays im .eaa-Format (Engine-Alpha-Array-Format) lesen und speichern.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	bruch Das allgemein gültige Zeichen für einen Zeilenumbruch.
static java.lang.String	sep Das allgemein gültige Zeichen für ein Unterverzeichnis
static java.lang.String	verz Das grundlegende Verzeichnis.

Method Summary

Methods

Modifier and Type	Method and Description
static java.awt.Color	ausListe(java.awt.Color farbe) Die Listenmethode beim Figureinlesen und für das speicherarme Raum-Objekt-Färben.
static java.lang.String	farbeAnalysieren(java.awt.Color c) Analysiert eine Farbe und weist ihr einen String zu.
static java.awt.Color	farbeEinlesen(java.lang.String s) Liest einen String ein und konvertiert ihn zu einer Farbe.
static java.lang.String	feldInfo(PixelFeld f) Berechnet aus einem PixelFeld die Informationen und gibt sie als String zurück.
static Figur	figurEinlesen(java.io.File file) Liest eine Figur ein.
static Figur	figurEinlesen(java.lang.String verzeichnis) Liest eine Figur ein.
static Figur	figurEinlesen(java.lang.String verzeichnis, boolean relativ) Deprecated.
static Figur	figurLaden(java.lang.String verzeichnis) Liesst eine Figur ein und gibt die geladene Figur zurueck.
static int[]	integerArrayEinlesen(java.lang.String pfad) Liest eine .eaa-int-Array-Datei ein.
static boolean	integerArraySchreiben(int[] array, java.lang.String pfad) Schreibt ein int-Array (bzw. ein int[]-Objekt) als eigenständige Datei auf.
static boolean	schreiben(Figur f, java.lang.String pfad) Vereinfachte Version der Schreibmethode.
static boolean	schreiben(Figur f, java.lang.String verzeichnis, java.lang.String name) Schreibt die “.eaf”-Datei zu einer Figur.
static boolean	schreiben(Figur f, java.lang.String name, java.lang.String verzeichnis, boolean relativ) Schreibt die “.eaf”-Datei zu einer Figur.
static java.lang.String[]	stringArrayEinlesen(java.lang.String pfad) Liest eine .eaa-String-Array-Datei ein.
static boolean	stringArraySchreiben(java.lang.String[] array, java.lang.String pfad) Schreibt ein String-Array (bzw. ein String[]-Objekt) als eigenständige Datei auf.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

bruch

public static final java.lang.String bruch

Das allgemein gültige Zeichen für einen Zeilenumbruch.

sep

public static final java.lang.String sep

Das allgemein gültige Zeichen für ein Unterverzeichnis

verz

public static final java.lang.String verz

Das grundlegende Verzeichnis. Dies ist die absolute Pfadangabe zum aktuellen Arbeitsverzeichnis. Das Arbeitsverzeichnis ist das Verzeichnis in dem sich deine .jar-Datei bzw. dein Projekt befindet.

Method Detail

stringArraySchreiben

public static boolean stringArraySchreiben(java.lang.String[] array,
                           java.lang.String pfad)

Schreibt ein String-Array (bzw. ein String[]-Objekt) als eigenständige Datei auf.

Hierfür wird das .eaa-Format verwendet (Engine-Alpha-Array).

Parameters:

array - Das zu schreibende Array.

pfad - Der Dateipfad, der sowohl das Verzeichnis wie auch den Dateinamen angibt.

       Dieser sollte mit <code>.eaa</code> enden. Wenn nicht, wird dies
       automatisch angehängt.

Returns:

true, falls die Datei erfolgreich geschrieben wurde, sonst false.

stringArrayEinlesen

public static java.lang.String[] stringArrayEinlesen(java.lang.String pfad)

Liest eine .eaa-String-Array-Datei ein.

Parameters:

pfad - Der Dateipfad, der sowohl das Verzeichnis wie auch den Dateinamen angibt.

       Dieser sollte mit <code>.eaa</code> enden. Wenn nicht, wird dies
       automatisch angehängt.

Returns:

Array, das eingelesen wurde oder null, wenn ein Fehler aufgetreten ist.

integerArraySchreiben

public static boolean integerArraySchreiben(int[] array,
                            java.lang.String pfad)

Schreibt ein int-Array (bzw. ein int[]-Objekt) als eigenständige Datei auf.

Hierfür wird das .eaa-Format verwendet (Engine-Alpha-Array).

Parameters:

array - Das zu schreibende Array.

pfad - Der Dateipfad, der sowohl das Verzeichnis wie auch den Dateinamen angibt.

       Dieser sollte mit <code>.eaa</code> enden. Wenn nicht, wird dies
       automatisch angehängt.

Returns:

true, falls die Datei erfolgreich geschrieben wurde, sonst false.

integerArrayEinlesen

public static int[] integerArrayEinlesen(java.lang.String pfad)

Liest eine .eaa-int-Array-Datei ein.

Parameters:

pfad - Der Dateipfad, der sowohl das Verzeichnis wie auch den Dateinamen angibt.

       Dieser sollte mit <code>.eaa</code> enden. Wenn nicht, wird dies
       automatisch angehängt.

Returns:

Array, das eingelesen wurde oder null, wenn ein Fehler aufgetreten ist.

schreiben

public static boolean schreiben(Figur f,
                java.lang.String name,
                java.lang.String verzeichnis,
                boolean relativ)

Schreibt die “.eaf”-Datei zu einer Figur.
Hierbei wird eine eventuell bestehende Datei dieses Namens rigoros geloescht, sofern moeglich.
Diese Methode ggibt zurueck, ob das schreiben der Datei erfolgreich war oder nicht.

Parameters:

f - Die zu schreibende Figur

name - Der Name der Datei. Dieser sollte mit “.eaf” enden, wenn nicht, wird dies automatisch angehaengt.
Sollte der String allerdings sonst ein “.”-Zeichen enthalten, wird nur eine Fehlermeldung ausgespuckt!

verzeichnis - Das Verzeichnis, in dem die Datei gespeichert werden soll. Ist dies ein leerer String (""), so wird die Figur nur nach ihrem namen gespeichert.

relativ - Gibt an, ob das Verzeichnis relativ zum Spielprojekt geshen werden soll (standard)

Returns:

Ist true, wenn die Datei erfolgreich geschrieben wurde, ansonsten false.

schreiben

public static boolean schreiben(Figur f,
                java.lang.String verzeichnis,
                java.lang.String name)

Schreibt die “.eaf”-Datei zu einer Figur.
Hierbei wird eine eventuell bestehende Datei dieses Namens rigoros geloescht, sofern moeglich.
Diese Methode ggibt zurueck, ob das schreiben der Datei erfolgreich war oder nicht.

Parameters:

f - Die zu schreibende Figur

name - Der Name der Datei. Dieser sollte mit “.eaf” enden, wenn nicht, wird dies automatisch angehaengt.
Sollte der String allerdings sonst ein “.”-Zeichen enthalten, wird nur eine Fehlermeldung ausgespuckt!

verzeichnis - Das Verzeichnis, in dem die Datei gespeichert werden soll. Ist dies ein leerer String (""), so wird die Figur nur nach ihrem namen gespeichert.

Returns:

Ist true, wenn die Datei erfolgreich geschrieben wurde, ansonsten false.

schreiben

public static boolean schreiben(Figur f,
                java.lang.String pfad)

Vereinfachte Version der Schreibmethode.
Hierbei wird die eingegebene Figur nach dem selben Algorythmus geschrieben, jedoch gibt der eine Eingabeparameter den Namen und den gesamten Pfad an.

Parameters:

f - Die zu schreibende Figur

pfad - Der absolute (oder auch relative) Dateipfad, der sowohl das Verzeichnis wie auch den Dateinamen angibt.

Returns:

Ist true, wenn die Datei erfolgreich geschrieben wurde, ansonsten false.

See Also:

schreiben(Figur, String, String)

figurLaden

public static Figur figurLaden(java.lang.String verzeichnis)

Liesst eine Figur ein und gibt die geladene Figur zurueck.
Diese Methode macht nichts weiter als die Methode figurEinlesen(String). Diese wurde aufgrund der Namensnaehe zur Verhinderung ungeliebter Falschschreibungen hinzugefuegt und wrappt diese Methode lediglich.

Parameters:

verzeichnis - Das Verzeichnis der einzulesenden Datei.
Die Eingabe muss ein Dateiname mit dem ende “.eaf” sein. Dies kann ohne Ordnerangaben gemacht werden, wenn die Datei im Quelltextordner ist.

Returns:

Die eingelesene Figur.
Tritt ein Fehler auf, weil die Datei nicht einlesbar ist oder nicht existiert, ist dieser wert null.
Trotzdem kann es sein, dass eine beschuedigte Datei nicht mehr korrekt einlesbar ist, dennoch ein Ergebnis liefert.

See Also:

figurEinlesen(String)

figurEinlesen

public static Figur figurEinlesen(java.io.File file)

Liest eine Figur ein.

Parameters:

file - Verzeichnis der einzulesenden Datei.

       Die Eingabe <b>muss</b> ein Dateiname mit dem Ende <code>.eaf</code>
       sein. Dies kann ohne Ordnerangaben gemacht werden, wenn die
       Datei im Quelltextordner ist.

Returns:

Eingelesene Figur.

    Tritt ein Fehler auf, weil die Datei nicht einlesbar ist
    oder nicht existiert, ist dieser wert <code>null</code>.

    Trotzdem kann es sein, dass eine beschädigte Datei nicht mehr
    korrekt einlesbar ist, dennoch ein Ergebnis liefert.

See Also:

figurLaden(String), figurEinlesen(String)

figurEinlesen

@Deprecated
public static Figur figurEinlesen(java.lang.String verzeichnis,
                             boolean relativ)

Deprecated.

figurEinlesen

public static Figur figurEinlesen(java.lang.String verzeichnis)

Liest eine Figur ein.

Parameters:

verzeichnis - Verzeichnis der einzulesenden Datei.

       Die Eingabe <b>muss</b> ein Dateiname mit dem Ende <code>.eaf</code>
       sein. Dies kann ohne Ordnerangaben gemacht werden, wenn die
       Datei im Quelltextordner ist.

Returns:

Eingelesene Figur.

    Tritt ein Fehler auf, weil die Datei nicht einlesbar ist
    oder nicht existiert, ist dieser wert <code>null</code>.

    Trotzdem kann es sein, dass eine beschädigte Datei nicht mehr
    korrekt einlesbar ist, dennoch ein Ergebnis liefert.

feldInfo

public static java.lang.String feldInfo(PixelFeld f)

Berechnet aus einem PixelFeld die Informationen und gibt sie als String zurück.

ACHTUNG: Umbruchzeichen werden gesetzt, jedoch endet der String nicht mit einem Zeilenumbruch, daher muss bei der Informationsbindung aus mehreren Feldern eine Zeile nach dem verwenden dieses Strings geschaltet werden.

farbeAnalysieren

public static java.lang.String farbeAnalysieren(java.awt.Color c)

Analysiert eine Farbe und weist ihr einen String zu.

Parameters:

c - Zu analysierende Farbe

Returns:

Stringrepräsentation der Farbe

farbeEinlesen

public static java.awt.Color farbeEinlesen(java.lang.String s)

Liest einen String ein und konvertiert ihn zu einer Farbe.

Parameters:

s - zu konvertierender String

Returns:

Color-Objekt, das gelesen wurde.

    <code>null</code>, wenn der String nicht eingelesen werden konnte!

ausListe

public static java.awt.Color ausListe(java.awt.Color farbe)

Die Listenmethode beim Figureinlesen und für das speicherarme Raum-Objekt-Färben.

Diese Methode wird verwendet um den Speicher zu entlasten, da Farbobjekte, die bereits in der Liste enthalten sind, nicht zurückgegeben werden, sondern durch den vorhandenen Farbewert ersetzt werden.

Somit hat jede Farbe beim Einlesen genau eine Instanz innerhalb der gesamten Engine.

Parameters:

farbe - Farbe, die auf Existenz in der Liste geprüft werden soll.

Returns:

Das zurückgegebene Farbobjekt ist vom Zustand her genau das selbe wie das Eingegebene.

    Jedoch bleibt dank dieser Methode für jede Farbe nur ein
    Farbobjekt, was Speicherplatz spart.