public class Debug extends Object
DebugFormatterXML
, DebugFormatterFileText
, DebugFormatterExcel
, DebugFormatterHTML
).
Die Ausgabe (über den DebugLevel) kann zur Laufzeit sowohl für die verfügbaren Ausgabekanäle als auch die DebugBereiche geändert werden.
Für jeden DebugBereich (jeder Klasse, in denen DebugAusgben vorgenommen werden) kann der Level (ERROR
, WARNING
, INFO
, CONFIG
, FINE
, FINER
, FINEST
, ALL
, OFF
) unabhängig vom Level des jeweiligen Ausgabekanals (DebugFormatterXML
, DebugFormatterStdErrText
, DebugFormatterFileText
, DebugFormatterExcel
, DebugFormatterHTML
) eingestellt
werden. Damit nicht bei einer Applikation mit hunderten von Klassen (und damit entsprechend vielen DebugBereichen) nicht jeden DebugBereich einzeln
einstellen zu müssen, werden die DebugBereiche entsprechend ihrer Hierachie verwaltet. Wird der Level eines DebugBereichs geändert, so werden auch alle Level
für die untergeordneten Bereiche mit umgestellt. Setzt man also den Level des WurzelLoggers auf FEHLER, so werden alle Logger auf diesen Level gesetzt und
nur noch Fehlermeldungen protokolliert. Anschließend kann dann der Logger einer speziel zu untersuchenden Klasse auf z.B. den Level FEINER gesetzt werden, um
so genauere Informationen über einen speziellen Programmteil zu protokollieren.Modifier and Type | Field and Description |
---|---|
static Level |
ALL
Schaltet die Ausgabe aller Level ein
|
static Level |
CONFIG
Verwendung für Konfigurationsinformationen (z.B.
|
static Level |
ERROR
FEHLER ist höchster Level: Verwendung ausschließlich für "echte" Fehler
|
static Level |
FINE
Verwendung für programmnahe Ausgaben zur Verfolgung des Programmablaufs.
|
static Level |
FINER
Wie bei
FINE , aber feinere Ausgabe. |
static Level |
FINEST
Wie bei
FINER , aber mit allen Details. |
static Level |
INFO
Verwendung für Infoausgaben (z.B.
|
static String |
NEWLINE
Zeilenumbruch plattformunabhängig
|
static Level |
OFF
Schaltet die Ausgabe aller Level aus
|
static Level |
WARNING
Verwendung nur für Warnungen, die vom Programm zwar noch abgefangen werden können, aber unbedingt behoben werden müssen.
|
Modifier and Type | Method and Description |
---|---|
void |
config(String msg)
Debugausgabe auf Level CONFIG.
|
void |
config(String msg,
Object param)
Debugausgabe auf Level CONFIG.
|
void |
config(String msg,
Object[] param)
Debugausgabe auf Level CONFIG.
|
void |
config(String msg,
Throwable thrown)
Debugausgabe auf Level CONFIG.
|
static String |
debugInfo()
TESTMETHODE: Gibt Info über angemeldete Logger aus
|
void |
error(String msg)
Debugausgabe auf Level ERROR.
|
void |
error(String msg,
Object param)
Debugausgabe auf Level ERROR.
|
void |
error(String msg,
Object[] param)
Debugausgabe auf Level ERROR.
|
void |
error(String msg,
Throwable thrown)
Debugausgabe auf Level ERROR.
|
void |
fine(String msg)
Debugausgabe auf Level FINE.
|
void |
fine(String msg,
Object param)
Debugausgabe auf Level FINE.
|
void |
fine(String msg,
Object[] param)
Debugausgabe auf Level FINE.
|
void |
fine(String msg,
Throwable thrown)
Debugausgabe auf Level FINE.
|
void |
finer(String msg)
Debugausgabe auf Level FINER.
|
void |
finer(String msg,
Object param)
Debugausgabe auf Level FINER.
|
void |
finer(String msg,
Object[] param)
Debugausgabe auf Level FINER.
|
void |
finer(String msg,
Throwable thrown)
Debugausgabe auf Level FINER.
|
void |
finest(String msg)
Debugausgabe auf Level FINEST.
|
void |
finest(String msg,
Object param)
Debugausgabe auf Level FINEST.
|
void |
finest(String msg,
Object[] param)
Debugausgabe auf Level FINEST.
|
void |
finest(String msg,
Throwable thrown)
Debugausgabe auf Level FINEST.
|
static Debug |
getLogger()
Gibt eine DebugLogger zurück, der automatisch in der Klassenhierachie unter dem WurzelLogger einsortiert wurde.
|
void |
info(String msg)
Debugausgabe auf Level INFO.
|
void |
info(String msg,
Object param)
Debugausgabe auf Level INFO.
|
void |
info(String msg,
Object[] param)
Debugausgabe auf Level INFO.
|
void |
info(String msg,
Throwable thrown)
Debugausgabe auf Level INFO.
|
static void |
init(String rootName,
ArgumentList argumentList)
Initialisiert den DebugLogger.
|
static void |
reinstallConsoleHandler() |
static void |
setHandlerLevel(String s,
Level level)
TESTMETHODE: Setzt DebugLevel des entsprechenden Ausgabekanals.
|
void |
setLoggerLevel(Level level)
TESTMETHODE: Setzt DebugLevel des entsprechenden Loggers.
|
static void |
setLoggerLevel(String logger,
Level level)
TESTMETHODE: Setzt DebugLevel des entsprechenden Loggers.
|
void |
warning(String msg)
Debugausgabe auf Level WARNING.
|
void |
warning(String msg,
Object param)
Debugausgabe auf Level WARNING.
|
void |
warning(String msg,
Object[] param)
Debugausgabe auf Level WARNING.
|
void |
warning(String msg,
Throwable thrown)
Debugausgabe auf Level WARNING.
|
public static final String NEWLINE
public static final Level ERROR
public static final Level WARNING
public static final Level INFO
public static final Level CONFIG
public static final Level FINE
public static final Level ALL
public static final Level OFF
public static void init(String rootName, ArgumentList argumentList)
argumentList
- Liste der bei Applikationsstart übergebenen Parameter zur Voreinstellung.rootName
- Wurzel-Name aller verwalteter DebugLoggerpublic static void reinstallConsoleHandler()
public static String debugInfo()
public static Debug getLogger()
public static void setLoggerLevel(String logger, Level level)
public static void setHandlerLevel(String s, Level level)
public void config(String msg)
msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit ausgegeben,
so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr der
Meldung,...)public void config(String msg, Throwable thrown)
msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit
ausgegeben, so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr
der Meldung,...)thrown
- Zusätzliche Meldungen, die sich aus der übergebenen Exeption ergibt.public void config(String msg, Object[] param)
msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit
ausgegeben, so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr
der Meldung,...)param
- Zusätzliche Meldungen, die über die Object.toString()
Methode an den übergebenen Objekten ausgewertet werden.public void config(String msg, Object param)
msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit
ausgegeben, so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr
der Meldung,...)param
- Zusätzliche Meldung, die über die Object.toString()
Methode am übergebenen Objekt ausgewertet werden.public void error(String msg, Throwable thrown)
msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit
ausgegeben, so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr
der Meldung,...)thrown
- Zusätzliche Meldungen, die sich aus der übergebenen Exeption ergibt.public void error(String msg, Object[] param)
msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit
ausgegeben, so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr
der Meldung,...)param
- Zusätzliche Meldungen, die über die Object.toString()
Methode an den übergebenen Objekten ausgewertet werden.public void error(String msg, Object param)
msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit
ausgegeben, so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr
der Meldung,...)param
- Zusätzliche Meldung, die über die Object.toString()
Methode am übergebenen Objekt ausgewertet werden.public void fine(String msg)
msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit ausgegeben,
so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr der
Meldung,...)public void fine(String msg, Throwable thrown)
msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit
ausgegeben, so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr
der Meldung,...)thrown
- Zusätzliche Meldungen, die sich aus der übergebenen Exeption ergibt.public void fine(String msg, Object[] param)
msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit
ausgegeben, so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr
der Meldung,...)param
- Zusätzliche Meldungen, die über die Object.toString()
Methode an den übergebenen Objekten ausgewertet werden.public void fine(String msg, Object param)
msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit
ausgegeben, so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr
der Meldung,...)param
- Zusätzliche Meldung, die über die Object.toString()
Methode am übergebenen Objekt ausgewertet werden.public void finer(String msg)
fine(java.lang.String)
, aber feinere Ausgabe.msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit ausgegeben,
so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr der
Meldung,...)public void finer(String msg, Throwable thrown)
fine(java.lang.String)
, aber feinere Ausgabe.msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit
ausgegeben, so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr
der Meldung,...)thrown
- Zusätzliche Meldungen, die sich aus der übergebenen Exeption ergibt.public void finer(String msg, Object[] param)
fine(java.lang.String)
, aber feinere Ausgabe.msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit
ausgegeben, so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr
der Meldung,...)param
- Zusätzliche Meldungen, die über die Object.toString()
Methode an den übergebenen Objekten ausgewertet werden.public void finer(String msg, Object param)
fine(java.lang.String)
, aber feinere Ausgabe.msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit
ausgegeben, so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr
der Meldung,...)param
- Zusätzliche Meldung, die über die Object.toString()
Methode am übergebenen Objekt ausgewertet werden.public void finest(String msg)
finer(java.lang.String)
, aber maximale Details.msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit ausgegeben,
so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr der
Meldung,...)public void finest(String msg, Throwable thrown)
finer(java.lang.String)
, aber maximale Details.msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit
ausgegeben, so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr
der Meldung,...)thrown
- Zusätzliche Meldungen, die sich aus der übergebenen Exeption ergibt.public void finest(String msg, Object[] param)
finer(java.lang.String)
, aber maximale Details.msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit
ausgegeben, so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr
der Meldung,...)param
- Zusätzliche Meldungen, die über die Object.toString()
Methode an den übergebenen Objekten ausgewertet werden.public void finest(String msg, Object param)
finer(java.lang.String)
, aber maximale Details.msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit
ausgegeben, so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr
der Meldung,...)param
- Zusätzliche Meldung, die über die Object.toString()
Methode am übergebenen Objekt ausgewertet werden.public void info(String msg)
msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit ausgegeben,
so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr der
Meldung,...)public void info(String msg, Throwable thrown)
msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit
ausgegeben, so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr
der Meldung,...)thrown
- Zusätzliche Meldungen, die sich aus der übergebenen Exeption ergibt.public void info(String msg, Object[] param)
msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit
ausgegeben, so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr
der Meldung,...)param
- Zusätzliche Meldungen, die über die Object.toString()
Methode an den übergebenen Objekten ausgewertet werden.public void info(String msg, Object param)
msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit
ausgegeben, so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr
der Meldung,...)param
- Zusätzliche Meldung, die über die Object.toString()
Methode am übergebenen Objekt ausgewertet werden.public void setLoggerLevel(Level level)
public void error(String msg)
msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit ausgegeben,
so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr der
Meldung,...)public void warning(String msg)
msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit ausgegeben,
so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr der
Meldung,...)public void warning(String msg, Throwable thrown)
msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit
ausgegeben, so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr
der Meldung,...)thrown
- Zusätzliche Meldungen, die sich aus der übergebenen Exeption ergibt.public void warning(String msg, Object[] param)
msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit
ausgegeben, so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr
der Meldung,...)param
- Zusätzliche Meldungen, die über die Object.toString()
Methode an den übergebenen Objekten ausgewertet werden.public void warning(String msg, Object param)
msg
- Auszugebender Debugtext. Der Text kann auch mehrzeilig formatiert sein. Neben dem Text werden noch folgende Ausgaben automatisch mit
ausgegeben, so dass diese nicht im Text enthalten sein sollten. (Datum, Zeit, Fehlerlevel (FEHLER, WARNUNG,...), Klasse des Aufrufers, lfdNr
der Meldung,...)param
- Zusätzliche Meldung, die über die Object.toString()
Methode am übergebenen Objekt ausgewertet werden.