de.bsvrz.sys.funclib.debug
Class Debug

java.lang.Object
  extended by de.bsvrz.sys.funclib.debug.Debug

public class Debug
extends Object

Stellt Methoden für die Debugausgabe zur Vefügung.
Unterstützt werden neben unterschiedlichen DebugLeveln auch hierarisch verwaltete DebugBereiche, die je Klasse angelegt werden können. Für die Ausgabe stehen verschiedene Ausgabekänale mit jeweils spezifischen Formatierungen der Ausgabe zur Verfügung (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.

Author:
Kappich+Kniß Systemberatung Aachen (K2S), Hans Christian Kniß (HCK)

Field Summary
private static boolean _debugFileAppend
          Legt fest ob an bereits existente Ausgabedateien angehängt werden darf, oder ob die alte Datei überschrieben wird.
private static int _debugFileCount
          Anzahl der Ausgabedateien, die wie ein Ringpuffer beschrieben werden.
private static String _debugFileNamePattern
          Dateinamemuster für Ausgabedateien.
private static String _debugFilePath
          Pfad für Ausgabedateien.
private static int _debugFileSize
          Ungefähre maximale Größe einer Ausgabedatei.
private static Level _debugLevelFileExcel
          Aktueller DebugLevel für Dateiausgaben im csv-Format Kann über Aufrufparameter geändert werden.
private static Level _debugLevelFileHTML
          Aktueller DebugLevel für Dateiausgaben im HTML-Format Kann über Aufrufparameter geändert werden.
private static Level _debugLevelFileText
          Aktueller DebugLevel für Dateiausgaben im Text-Format Kann über Aufrufparameter geändert werden.
private static Level _debugLevelFileXML
          Aktueller DebugLevel für Dateiausgaben im XML-Format Kann über Aufrufparameter geändert werden.
private static Level _debugLevelStdErrText
          Aktueller DebugLevel für StdErr-Ausgaben im Text-Format Kann über Aufrufparameter geändert werden.
private static File _debugPath
           
private static String _fileExtensionExcel
          Dateiendung für Excel-Dateien.
private static String _fileExtensionHTML
          Dateiendung für HTML-Dateien.
private static String _fileExtensionText
          Dateiendung für Text-Dateien.
private static String _fileExtensionXML
          Dateiendung für XML-Dateien.
private static Formatter _formatterExcel
          Aktueller Formatter für Ausgaben im csv-Format
private static Formatter _formatterFileText
          Aktueller Formatter für Ausgaben im Text-Format auf Datei
private static Formatter _formatterHTML
          Aktueller Formatter für Ausgaben im HTML-Format
private static Formatter _formatterStdErrText
          Aktueller Formatter für Ausgaben im Text-Format auf StdErr
private static Formatter _formatterXML
          Aktueller Formatter für Ausgaben im XML-Format
private static Handler _handlerFileExcel
          Aktueller Handler für Dateiausgabe im csv-Format
private static Handler _handlerFileHTML
          Aktueller Handler für Dateiausgabe im HTML-Format
private static Handler _handlerFileText
          Aktueller Handler für Dateiausgabe im Text-Format
private static Handler _handlerFileXML
          Aktueller Handler für Dateiausgabe im XML-Format
private static Handler _handlerStderrText
          Aktueller Handler für stderr-Ausgabe im Text-Format
private  Logger _logger
          Logger Objekt.
private static Debug _rootLogger
          Wurzel-DebugLogger, von dem alle weiteren Logger die Eigenschaften erben
private static String _rootName
          (Default) Name des Wurzel-DebugLogger, wird auch als Bestandteil der Ausgabedateien verwendet
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.
 
Constructor Summary
private Debug(Logger logger)
          Konstruktor (nur intern verwendet).
 
Method Summary
 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.
private  void status(String msg)
          Debugausgabe interner Art (auf Level INFO) für Ausgabe der aktuellen Einstellungen oder bei Änderung der Einstellungen.
private static Level string2Level(String s)
          Konvertiert den Debuglevel aus den Aufrufparametern von String in Level.
 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.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

NEWLINE

public static final String NEWLINE
Zeilenumbruch plattformunabhängig


ERROR

public static final Level ERROR
FEHLER ist höchster Level: Verwendung ausschließlich für "echte" Fehler


WARNING

public static final Level WARNING
Verwendung nur für Warnungen, die vom Programm zwar noch abgefangen werden können, aber unbedingt behoben werden müssen.


INFO

public static final Level INFO
Verwendung für Infoausgaben (z.B. Status des Programms, verwendete Startparameter etc.).


CONFIG

public static final Level CONFIG
Verwendung für Konfigurationsinformationen (z.B. angemeldete Objekte etc.).


FINE

public static final Level FINE
Verwendung für programmnahe Ausgaben zur Verfolgung des Programmablaufs.


FINER

public static final Level FINER
Wie bei FINE, aber feinere Ausgabe.


FINEST

public static final Level FINEST
Wie bei FINER, aber mit allen Details.


ALL

public static final Level ALL
Schaltet die Ausgabe aller Level ein


OFF

public static final Level OFF
Schaltet die Ausgabe aller Level aus


_rootLogger

private static Debug _rootLogger
Wurzel-DebugLogger, von dem alle weiteren Logger die Eigenschaften erben


_rootName

private static String _rootName
(Default) Name des Wurzel-DebugLogger, wird auch als Bestandteil der Ausgabedateien verwendet


_formatterXML

private static Formatter _formatterXML
Aktueller Formatter für Ausgaben im XML-Format


_formatterStdErrText

private static Formatter _formatterStdErrText
Aktueller Formatter für Ausgaben im Text-Format auf StdErr


_formatterFileText

private static Formatter _formatterFileText
Aktueller Formatter für Ausgaben im Text-Format auf Datei


_formatterExcel

private static Formatter _formatterExcel
Aktueller Formatter für Ausgaben im csv-Format


_formatterHTML

private static Formatter _formatterHTML
Aktueller Formatter für Ausgaben im HTML-Format


_handlerFileXML

private static Handler _handlerFileXML
Aktueller Handler für Dateiausgabe im XML-Format


_handlerFileText

private static Handler _handlerFileText
Aktueller Handler für Dateiausgabe im Text-Format


_handlerFileExcel

private static Handler _handlerFileExcel
Aktueller Handler für Dateiausgabe im csv-Format


_handlerFileHTML

private static Handler _handlerFileHTML
Aktueller Handler für Dateiausgabe im HTML-Format


_handlerStderrText

private static Handler _handlerStderrText
Aktueller Handler für stderr-Ausgabe im Text-Format


_debugFilePath

private static String _debugFilePath
Pfad für Ausgabedateien. Der komplette Dateiname wird gebildet aus _debugFilePath/debug/_rootName._debugFileNamePattern._fileExtensionXYZ (z.B. "C:/root-%u-%g.xml") Kann über Aufrufparameter geändert werden.


_debugPath

private static File _debugPath

_debugFileNamePattern

private static String _debugFileNamePattern
Dateinamemuster für Ausgabedateien. Der komplette Dateiname wird gebildet aus _debugFilePath/_rootName._debugFileNamePattern._fileExtensionXYZ (z.B. "C:/root-%u-%g.xml") Kann über Aufrufparameter geändert werden.


_fileExtensionXML

private static String _fileExtensionXML
Dateiendung für XML-Dateien. Der komplette Dateiname wird gebildet aus _debugFilePath/_rootName._debugFileNamePattern._fileExtensionXML (z.B. "C:/root-%u-%g.log.xml") Kann über Aufrufparameter geändert werden.


_fileExtensionText

private static String _fileExtensionText
Dateiendung für Text-Dateien. Der komplette Dateiname wird gebildet aus _debugFilePath/_rootName._debugFileNamePattern._fileExtensionText (z.B. "C:/root-%u-%g.log.txt") Kann über Aufrufparameter geändert werden.


_fileExtensionHTML

private static String _fileExtensionHTML
Dateiendung für HTML-Dateien. Der komplette Dateiname wird gebildet aus _debugFilePath/_rootName._debugFileNamePattern._fileExtensionHTML (z.B. "C:/root-%u-%g.log.html") Kann über Aufrufparameter geändert werden.


_fileExtensionExcel

private static String _fileExtensionExcel
Dateiendung für Excel-Dateien. Der komplette Dateiname wird gebildet aus _debugFilePath/_rootName._debugFileNamePattern._fileExtensionExcel (z.B. "C:/root-%u-%g.log.csv") Kann über Aufrufparameter geändert werden.


_debugFileSize

private static int _debugFileSize
Ungefähre maximale Größe einer Ausgabedatei. Kann über Aufrufparameter geändert werden.


_debugFileCount

private static int _debugFileCount
Anzahl der Ausgabedateien, die wie ein Ringpuffer beschrieben werden. Kann über Aufrufparameter geändert werden.


_debugFileAppend

private static boolean _debugFileAppend
Legt fest ob an bereits existente Ausgabedateien angehängt werden darf, oder ob die alte Datei überschrieben wird. Kann über Aufrufparameter geändert werden.


_debugLevelFileXML

private static Level _debugLevelFileXML
Aktueller DebugLevel für Dateiausgaben im XML-Format Kann über Aufrufparameter geändert werden.


_debugLevelFileText

private static Level _debugLevelFileText
Aktueller DebugLevel für Dateiausgaben im Text-Format Kann über Aufrufparameter geändert werden.


_debugLevelFileExcel

private static Level _debugLevelFileExcel
Aktueller DebugLevel für Dateiausgaben im csv-Format Kann über Aufrufparameter geändert werden.


_debugLevelFileHTML

private static Level _debugLevelFileHTML
Aktueller DebugLevel für Dateiausgaben im HTML-Format Kann über Aufrufparameter geändert werden.


_debugLevelStdErrText

private static Level _debugLevelStdErrText
Aktueller DebugLevel für StdErr-Ausgaben im Text-Format Kann über Aufrufparameter geändert werden.


_logger

private final Logger _logger
Logger Objekt.

Constructor Detail

Debug

private Debug(Logger logger)
Konstruktor (nur intern verwendet).

Parameters:
logger - Ein LoggerObjekt.
Method Detail

init

public static void init(String rootName,
                        ArgumentList argumentList)
Initialisiert den DebugLogger.

Folgende Initialisierungen werden durchgeführt: <

Parameters:
argumentList - Liste der bei Applikationsstart übergebenen Parameter zur Voreinstellung.
rootName - Wurzel-Name aller verwalteter DebugLogger
Since:
V 1.0

reinstallConsoleHandler

public static void reinstallConsoleHandler()

string2Level

private static Level string2Level(String s)
Konvertiert den Debuglevel aus den Aufrufparametern von String in Level.

Parameters:
s - Zu konvertierender String.
Returns:
Konvertierter Level.

status

private void status(String msg)
Debugausgabe interner Art (auf Level INFO) für Ausgabe der aktuellen Einstellungen oder bei Änderung der Einstellungen. Bei Ausgabe über status wird der DebugLevel nur für diese Ausgabe auf INFO gesetzt

Parameters:
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,...)

debugInfo

public static String debugInfo()
TESTMETHODE: Gibt Info über angemeldete Logger aus

Returns:
Liste aller angemelder Logger als Text

getLogger

public static Debug getLogger()
Gibt eine DebugLogger zurück, der automatisch in der Klassenhierachie unter dem WurzelLogger einsortiert wurde. Existiert der DebugLogger noch nicht, wird er erzeugt, ansonsten wird der bereits existierende DebugLogger mit dem angeforderten Namen zurückgegeben. Als Name wird automatisch gebildet aus "rootName.voll qualifizierter ClassName" z.B. "root.sys.funclib.Debug". Für jeden Logger kann der DebugLevel per DaV-Telegramm geändert werden.

Returns:
Logger Objekt, welches für die Debugausgeben und zur Steuerung des Debuglevels verwendet wird.

setLoggerLevel

public static void setLoggerLevel(String logger,
                                  Level level)
TESTMETHODE: Setzt DebugLevel des entsprechenden Loggers. Setzt den Level des angebenen Loggers UND aller untergeordneten Logger auf den eingestellten Level.

Es wird dazu der Name des Loggers verwendet. Als untergeordnet gelten aller Logger, deren Namensanfang mit dem des angegebenen Loggers übereinstimmt.

Parameters:
logger - Name des mit getLogger() erzeugter DebugLogger, dessen Level geändert werden soll
level - Neuer DebugLevel (ERROR, WARNING, INFO, CONFIG, FINE, FINER, FINEST, ALL, OFF).

setHandlerLevel

public static void setHandlerLevel(String s,
                                   Level level)
TESTMETHODE: Setzt DebugLevel des entsprechenden Ausgabekanals. Damit werden alle nur noch Ausgaben auf diesem Kanal mit dem eingestellten Level oder darüber ausgegeben, unabhängig davon ob einzelne Logger einen feineren Level eingestellt haben. Die Leveleinstellungen der einzelnen Logger werden aber nicht verändert.

Parameters:
s - Ausgabekanal, dessem Level geändert werden soll (StdErr, FileText, FileXML, FileHTML, FileExcel)
level - Neuer DebugLevel (ERROR, WARNING, INFO, CONFIG, FINE, FINER, FINEST, ALL, OFF).

config

public void config(String msg)
Debugausgabe auf Level CONFIG.

Verwendung für Konfigurationsinformationen (z.B. angemeldete Objekte etc.)

Parameters:
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,...)

config

public void config(String msg,
                   Throwable thrown)
Debugausgabe auf Level CONFIG.

Verwendung für Konfigurationsinformationen (z.B. angemeldete Objekte etc.)

Parameters:
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.

config

public void config(String msg,
                   Object[] param)
Debugausgabe auf Level CONFIG.

Verwendung für Konfigurationsinformationen (z.B. angemeldete Objekte etc.)

Parameters:
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.

config

public void config(String msg,
                   Object param)
Debugausgabe auf Level CONFIG.

Verwendung für Konfigurationsinformationen (z.B. angemeldete Objekte etc.)

Parameters:
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.

error

public void error(String msg,
                  Throwable thrown)
Debugausgabe auf Level ERROR.

Verwendung nur für "echte" Fehlerausgaben, die vom Programm nicht abgefangen werden oder die zu unkontrollierbaren Folgefehlern führen.

Parameters:
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.

error

public void error(String msg,
                  Object[] param)
Debugausgabe auf Level ERROR.

Verwendung nur für "echte" Fehlerausgaben, die vom Programm nicht abgefangen werden oder die zu unkontrollierbaren Folgefehlern führen.

Parameters:
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.

error

public void error(String msg,
                  Object param)
Debugausgabe auf Level ERROR.

Verwendung nur für "echte" Fehlerausgaben, die vom Programm nicht abgefangen werden oder die zu unkontrollierbaren Folgefehlern führen.

Parameters:
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.

fine

public void fine(String msg)
Debugausgabe auf Level FINE.

Verwendung für programmnahe Ausgaben zur Verfolgung des Programmablaufs.

Parameters:
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,...)

fine

public void fine(String msg,
                 Throwable thrown)
Debugausgabe auf Level FINE.

Verwendung für programmnahe Ausgaben zur Verfolgung des Programmablaufs.

Parameters:
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.

fine

public void fine(String msg,
                 Object[] param)
Debugausgabe auf Level FINE.

Verwendung für programmnahe Ausgaben zur Verfolgung des Programmablaufs.

Parameters:
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.

fine

public void fine(String msg,
                 Object param)
Debugausgabe auf Level FINE.

Verwendung für programmnahe Ausgaben zur Verfolgung des Programmablaufs.

Parameters:
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.

finer

public void finer(String msg)
Debugausgabe auf Level FINER.

Wie bei fine(java.lang.String), aber feinere Ausgabe.

Parameters:
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,...)

finer

public void finer(String msg,
                  Throwable thrown)
Debugausgabe auf Level FINER.

Wie bei fine(java.lang.String), aber feinere Ausgabe.

Parameters:
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.

finer

public void finer(String msg,
                  Object[] param)
Debugausgabe auf Level FINER.

Wie bei fine(java.lang.String), aber feinere Ausgabe.

Parameters:
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.

finer

public void finer(String msg,
                  Object param)
Debugausgabe auf Level FINER.

Wie bei fine(java.lang.String), aber feinere Ausgabe.

Parameters:
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.

finest

public void finest(String msg)
Debugausgabe auf Level FINEST.

Wie bei finer(java.lang.String), aber maximale Details.

Parameters:
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,...)

finest

public void finest(String msg,
                   Throwable thrown)
Debugausgabe auf Level FINEST.

Wie bei finer(java.lang.String), aber maximale Details.

Parameters:
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.

finest

public void finest(String msg,
                   Object[] param)
Debugausgabe auf Level FINEST.

Wie bei finer(java.lang.String), aber maximale Details.

Parameters:
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.

finest

public void finest(String msg,
                   Object param)
Debugausgabe auf Level FINEST.

Wie bei finer(java.lang.String), aber maximale Details.

Parameters:
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.

info

public void info(String msg)
Debugausgabe auf Level INFO.

Verwendung für Infoausgaben (z.B. Status des Programms, verwendete Startparameter etc.)

Parameters:
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,...)

info

public void info(String msg,
                 Throwable thrown)
Debugausgabe auf Level INFO.

Verwendung für Infoausgaben (z.B. Status des Programms, verwendete Startparameter etc.)

Parameters:
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.

info

public void info(String msg,
                 Object[] param)
Debugausgabe auf Level INFO.

Verwendung für Infoausgaben (z.B. Status des Programms, verwendete Startparameter etc.)

Parameters:
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.

info

public void info(String msg,
                 Object param)
Debugausgabe auf Level INFO.

Verwendung für Infoausgaben (z.B. Status des Programms, verwendete Startparameter etc.)

Parameters:
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.

setLoggerLevel

public void setLoggerLevel(Level level)
TESTMETHODE: Setzt DebugLevel des entsprechenden Loggers. Setzt den Level des angebenen Loggers UND aller untergeordneten Logger auf den eingestellten Level.

Es wird dazu der Name des Loggers verwendet. Als untergeordnet gelten aller Logger, deren Namensanfang mit dem des angegebenen Loggers übereinstimmt.

Parameters:
level - Neuer DebugLevel (ERROR, WARNING, INFO, CONFIG, FINE, FINER, FINEST, ALL, OFF).

error

public void error(String msg)
Debugausgabe auf Level ERROR.

Verwendung nur für "echte" Fehlerausgaben, die vom Programm nicht abgefangen werden oder die zu unkontrollierbaren Folgefehlern führen.

Parameters:
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,...)

warning

public void warning(String msg)
Debugausgabe auf Level WARNING.

Verwendung nur für Warnungen, die vom Programm zwar noch abgefangen werden können, aber unbedingt behoben werden müssen.

Parameters:
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,...)

warning

public void warning(String msg,
                    Throwable thrown)
Debugausgabe auf Level WARNING.

Verwendung nur für Warnungen, die vom Programm zwar noch abgefangen werden können, aber unbedingt behoben werden müssen.

Parameters:
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.

warning

public void warning(String msg,
                    Object[] param)
Debugausgabe auf Level WARNING.

Verwendung nur für Warnungen, die vom Programm zwar noch abgefangen werden können, aber unbedingt behoben werden müssen.

Parameters:
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.

warning

public void warning(String msg,
                    Object param)
Debugausgabe auf Level WARNING.

Verwendung nur für Warnungen, die vom Programm zwar noch abgefangen werden können, aber unbedingt behoben werden müssen.

Parameters:
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.