ch.elexis.util
Class Log

java.lang.Object
  ch.elexis.util.Log

public class Log
extends java.lang.Object

Standardisiertes Log. Ein Programm kann das Log mit Log.get(präfix) anfordern und fortan Ausgaben ins Log mittels Log(Text,level) machen. Die Ausgabe erfolgt einstellbar nach stdout oder in eine Datei. Ob eine bestimmte Ausgabe ins Log gelangt, hängt vom LogLevel und dem Text-Level ab. Wenn der Level einer Meldung gleich oder niedriger ist, als der aktuell eingestellte LogLevel, wird die Ausgabe gemacht, andernfalls wird sie verworfen. Ausserdem kann festgelegt werden, ab welchem level eine Nachricht zu einer direkten Benachrichtigung des Anwenders mittels MessageBox führt (setAlert und setAlertLevel

Author:

G. Weirich

Field Summary

static int	DEBUGMSG F�r Debugzwecke gedachte Meldungen
static int	DEFAULT_LOGFILE_MAX_SIZE
static int	ERRORS Nichtfatale Fehler, Programm kann weiterlaufen
static int	FATALS Fatale Fehler, Programmabbruch
static int	INFOS Reine Informationen, kein Einfluss aufs Programm
static int	NOTHING Experimentell
static int	SYNCMARK Immer auszugebende Meldungen, automatisch mit einem Timestamp versehen
static int	TRACE Immer auszugebende Meldungen, die aber keinem Fehler entsprechen
static int	WARNINGS Warnung, Programm l�uft normal weiter, es k�nnten aber Probleme auftreten

Method Summary

static Log	get(java.lang.String prefix) Das Log anfordern.
boolean	isDebug()
boolean	isError()
boolean	isInfo()
boolean	isWarn()
void	log(java.lang.String message, int level) Eine Log-Nachricht ausgeben.
void	log(java.lang.Throwable t) Eine Exception als Log-Nachricht ausgeben.
void	log(java.lang.Throwable t, java.lang.String message, int level) Eine Exception als Log-Nachricht ausgeben.
static void	setAlert(Shell cmp) Alert inetellen oder l�schen.
static void	setAlertLevel(int l) AlertLevel einstellen. wenn der Level einer Nachricht unter diesem Level liegt, wird eine Alertbox zur Nazeige der Nachricht ge�ffnet (Anstatt nur zu loggen).
static void	setLevel(int l) LogLevel einstellen
static void	setOutput(java.lang.String name, int maxSize) Ausgabeziel einstellen.
static void	trace(java.lang.String msg)

Methods inherited from class java.lang.Object

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

Field Detail

NOTHING

public static final int NOTHING

Experimentell

See Also:

Constant Field Values

FATALS

public static final int FATALS

Fatale Fehler, Programmabbruch

See Also:

Constant Field Values

ERRORS

public static final int ERRORS

Nichtfatale Fehler, Programm kann weiterlaufen

See Also:

Constant Field Values

WARNINGS

public static final int WARNINGS

Warnung, Programm l�uft normal weiter, es k�nnten aber Probleme auftreten

See Also:

Constant Field Values

INFOS

public static final int INFOS

Reine Informationen, kein Einfluss aufs Programm

See Also:

Constant Field Values

DEBUGMSG

public static final int DEBUGMSG

F�r Debugzwecke gedachte Meldungen

See Also:

Constant Field Values

TRACE

public static final int TRACE

Immer auszugebende Meldungen, die aber keinem Fehler entsprechen

See Also:

Constant Field Values

SYNCMARK

public static final int SYNCMARK

Immer auszugebende Meldungen, automatisch mit einem Timestamp versehen

See Also:

Constant Field Values

DEFAULT_LOGFILE_MAX_SIZE

public static final int DEFAULT_LOGFILE_MAX_SIZE

See Also:

Constant Field Values

Method Detail

setOutput

public static void setOutput(java.lang.String name,
                             int maxSize)

Ausgabeziel einstellen. Ist immer global f�r alle Klassen des aktuellen Pogramms.

Parameters:

name - null oder "" oder none: Ausgabe nach stdout, andernfalls ein Dateiname, der die Ausgabedatei definiert.

maxSize - maximale Grösse (unbeschränkt, falls <= 0)

setLevel

public static void setLevel(int l)

LogLevel einstellen

Parameters:

l - der gew�nschte Level. Ist immer global f�r alle Klassen des aktuellen Programms.

setAlertLevel

public static void setAlertLevel(int l)

AlertLevel einstellen. wenn der Level einer Nachricht unter diesem Level liegt, wird eine Alertbox zur Nazeige der Nachricht ge�ffnet (Anstatt nur zu loggen). Dies geht nur, wenn mit setAlert auch eine parent-Shell gesetzt worden ist.

setAlert

public static void setAlert(Shell cmp)

Alert inetellen oder l�schen. Wenn cmp nicht null ist, wird bei jeder Fehlermeldung>Log.Errors eine Alertbox mit der Fehlermeldung ausgegeben.

Parameters:

cmp - die Paent-Komponente f�r die Alertbox

get

public static Log get(java.lang.String prefix)

Das Log anfordern. Es gibt pro Programm nur ein Log.

Parameters:

prefix - Ein String, der allen Log-Ausgaben dieser Instanz vorangestellt wird

Returns:

eine Log-Instanz

log

public void log(java.lang.String message,
                int level)

Eine Log-Nachricht ausgeben.

Parameters:

message - die Nachricht

level - der level

log

public void log(java.lang.Throwable t,
                java.lang.String message,
                int level)

Eine Exception als Log-Nachricht ausgeben.

Parameters:

t - die Exception

message - die Nachricht

level - der level

log

public void log(java.lang.Throwable t)

Eine Exception als Log-Nachricht ausgeben.

Parameters:

t - die Exception

level - der level

trace

public static void trace(java.lang.String msg)

isDebug

public boolean isDebug()

isInfo

public boolean isInfo()

isWarn

public boolean isWarn()

isError

public boolean isError()