de.jsystems.tools.exception
Class BaseException

java.lang.Object
  java.lang.Throwable
      java.lang.Exception
          de.jsystems.tools.exception.BaseException

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

IniFileFormatException, ReadOnlySaveException, WrongParamIndexException, WrongTypeException

public abstract class BaseException

extends Exception

Basisklasse für Exceptions. Hier findet eigentlich schon das gesamte Handling für Exceptions statt. Fehlermeldungen können direkt angezeigt werden. Für jede Exception wird ein Fehlerlevel mitgegeben. Dabei haben die Level folgende Bedeutung:

LEVEL_WARNING - Leichter Fehler, der nicht um Abbruch des Programms führt.

LEVEL_ERROR - Fehler in einer Methode. Das Programm reagiert nicht mehr unbedingt stabil

LEVEL_FATAL - Fataler Fehler in einer Methode. Das Programm sollte abgebrochen werden.
Hierbei ist aber ganz besonders zu beachten, das es sich dabei um eine willkürliche Einteilung handelt. Denn es handelt sich hierbei immer noch nur um Exceptions die normalerweise nicht zum Abbruch eines Programms führen, sondern nur zum vorzeitigen beenden einer Methode. Die verschiedenen Level machen lediglich ein differenziertes Loggen möglich, was eine Auswertung der aufgetretenen Fehler vereinfachen kann. Auch das Mitloggen in einer Datei ist möglich. Dafür gibt es eine statische Methode, mit der das Verhalten eingestellt werden kann. Defaultmäßig wird nichts in einer Datei mitgeloggt.

Version:

1.0

Author:

Jens Homm

See Also:

Serialized Form

Field Summary

static int	LEVEL_ERROR
static int	LEVEL_FATAL
static int	LEVEL_WARNING
static int	LOG_ERROR
static int	LOG_FATAL_ERROR
static int	LOG_NONE
static int	LOG_WARNING

Fields inherited from class java.lang.Exception

Constructor Summary

BaseException()
Erzeugt eine Exception ohne Text.

BaseException(Exception origin, int level)
Erzeugt eine neue Exception aufgrund einer anderen Exception.

BaseException(Exception origin, String message, int level)
Erzeugt eine neue Exception aufgrund einer anderen Exception.

BaseException(Object source, Exception origin, int level)
Erzeugt eine neue Exception aufgrund einer anderen Exception.

BaseException(Object source, Exception origin, String message, int level)
Erzeugt eine neue Exception aufgrund einer anderen Exception.

BaseException(Object source, String message, int level)
Erzeugt eine neue Exception.

BaseException(String message)
Erzeugt eine neue Exception mit einer spezifizierten Fehlermeldung.

BaseException(String message, int level)
Erzeugt eine neue Exception.

Method Summary

int	getLevel() Gibt den Fehlerlevel dieser Exception zurück.
Exception	getOrigin() Gibt die Originalexception zurück, die beim initialisieren übergeben wurde oder NULL wenn es keine gibt.
String	getOriginMessage() Gibt die Fehlermeldung der ursprünglichen Fehlermeldung zurück sofern diese Exception mit einer anderen Exception initialisiert wurde.
Object	getSource() Gibt die Quelle der Exception zurück die beim initialisieren übergeben wurde oder NULL, wenn keine Quelle übergeben wurde.
protected void	logException() Schreibt die Message der Exception in eine Fehlerdatei.
static void	logException(int level) Legt fest, was alles geloggt werden soll.
int	showMessage() Zeigt die Fehlermeldung als Dialog an.

Methods inherited from class java.lang.Throwable

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

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

Field Detail

LEVEL_WARNING

public static final int LEVEL_WARNING

See Also:

Constant Field Values

LEVEL_ERROR

public static final int LEVEL_ERROR

See Also:

Constant Field Values

LEVEL_FATAL

public static final int LEVEL_FATAL

See Also:

Constant Field Values

LOG_NONE

public static final int LOG_NONE

See Also:

Constant Field Values

LOG_WARNING

public static final int LOG_WARNING

See Also:

Constant Field Values

LOG_ERROR

public static final int LOG_ERROR

See Also:

Constant Field Values

LOG_FATAL_ERROR

public static final int LOG_FATAL_ERROR

See Also:

Constant Field Values

Constructor Detail

BaseException

public BaseException()

Erzeugt eine Exception ohne Text. Der Level wird auf LEVEL_ERROR gesetzt.

BaseException

public BaseException(String message)

Erzeugt eine neue Exception mit einer spezifizierten Fehlermeldung. Der Level wird auf LEVEL_ERROR gesetzt.

BaseException

public BaseException(String message,
                     int level)

Erzeugt eine neue Exception. Übergeben wird ein String mit der Fehlermeldung.

Parameters:

message - - Die Fehlermeldung.

level - - Der Fehlerlevel dieser Eception.

BaseException

public BaseException(Exception origin,
                     int level)

Erzeugt eine neue Exception aufgrund einer anderen Exception. Die Originalexception wird gespeichert.

Parameters:

origin - - Die Originalexception.

level - - Der Fehlerlevel dieser Eception.

BaseException

public BaseException(Exception origin,
                     String message,
                     int level)

Erzeugt eine neue Exception aufgrund einer anderen Exception. Zusätzlichwird noch ein Fehlertext mit übergeben.

Parameters:

origin - - Die Originalexception.

message - - Die Fehlermeldung.

level - - Der Fehlerlevel dieser Eception.

BaseException

public BaseException(Object source,
                     String message,
                     int level)

Erzeugt eine neue Exception. Dieser Exception wird das Objekt mitgegeben, in dem die Exception erzeugt wurde. Zusätzlich wird ein String mit der Fehlermeldung übergeben.

Parameters:

source - - Das Objekt in dem die Exception ausgelöst wurde.

message - - Die Fehlermeldung.

level - - Der Fehlerlevel dieser Eception.

BaseException

public BaseException(Object source,
                     Exception origin,
                     int level)

Erzeugt eine neue Exception aufgrund einer anderen Exception. Zusätlich wird das Objekt mitgegeben, in dem die Exception erzeugt wurde.

Parameters:

source - - Das Objekt in dem die Exception ausgelöst wurde.

origin - - Die Originalexception.

level - - Der Fehlerlevel dieser Eception.

BaseException

public BaseException(Object source,
                     Exception origin,
                     String message,
                     int level)

Erzeugt eine neue Exception aufgrund einer anderen Exception. Zusätlich wird das Objekt mitgegeben, in dem die Exception erzeugt wurde und ein String mit einer Fehlermeldung.

Parameters:

source - - Das Objekt in dem die Exception ausgelöst wurde.

origin - - Die Originalexception.

message - - Die Fehlermeldung.

level - - Der Fehlerlevel dieser Eception.

Method Detail

logException

public static void logException(int level)

Legt fest, was alles geloggt werden soll. Entweder nichts, Warnungen, Errors oder Fatale Errors.

logException

protected void logException()

Schreibt die Message der Exception in eine Fehlerdatei.

getOriginMessage

public String getOriginMessage()

Gibt die Fehlermeldung der ursprünglichen Fehlermeldung zurück sofern diese Exception mit einer anderen Exception initialisiert wurde. Andernfalls wird ein Standardtext zurückgegeben.

Returns:

Den Fehlertext der OriginalException oder einen Standardtext.

getOrigin

public Exception getOrigin()

Gibt die Originalexception zurück, die beim initialisieren übergeben wurde oder NULL wenn es keine gibt.

Returns:

Originalexception oder NULL.

getSource

public Object getSource()

Gibt die Quelle der Exception zurück die beim initialisieren übergeben wurde oder NULL, wenn keine Quelle übergeben wurde.

Returns:

Objekt, in dem die Exception erzeugt wurde oder NULL.

getLevel

public int getLevel()

Gibt den Fehlerlevel dieser Exception zurück.

Returns:

den Fehlerlevel der Exception.

showMessage

public int showMessage()

Zeigt die Fehlermeldung als Dialog an.

Returns:

Den gedrückten Button des Dialoges.