Technische Konzepte: Logger - Versionsgeschichte

Chge: /* Wo ist der Logger zu finden? */

2012-05-02T10:23:12Z

Wo ist der Logger zu finden?

← Nächstältere Version		Version vom 2. Mai 2012, 10:23 Uhr
Zeile 36:		Zeile 36:
	== Wo ist der Logger zu finden? ==		== Wo ist der Logger zu finden? ==

−	Der Logger ist Bestandteil des Jar-Files "tools", ~~dass~~ auch noch den ConfigManager beherbergt.	+	Der Logger ist Bestandteil des Jar-Files "tools", das auch noch den ConfigManager beherbergt.
	Das Paket ist mit einer Classpath Variable bereits in unserem Projekt eingebunden.		Das Paket ist mit einer Classpath Variable bereits in unserem Projekt eingebunden.
−	Er kann einfach mit Logger.xx (xx für die entsprechende Methode) benutzt werden. Wobei aufgepasst werden muss dass auch unser Logger verwendet wird (Auswahlliste in Eclipse). Da der Logger statisch ist muss nichts initialisiert werden. Es sollte aber das LogLevel nur an einer zentralen Stelle geändert werden (z.b. gleich in der Starter-->main)	+	Er kann einfach mit Logger.xx (xx für die entsprechende Methode) benutzt werden. Wobei aufgepasst werden muss, dass auch unser Logger verwendet wird (Auswahlliste in Eclipse). Da der Logger statisch ist muss nichts initialisiert werden. Es sollte aber das LogLevel nur an einer zentralen Stelle geändert werden. (z.B. gleich in der Starter-->main)

−	Der Logger benutzt Standardmäßig das LogLevel INFO	+	Der Logger benutzt Standardmäßig das LogLevel INFO.

Chge: /* Welche Methoden stellt der Logger bereit? */

2012-05-02T10:20:52Z

Welche Methoden stellt der Logger bereit?

← Nächstältere Version		Version vom 2. Mai 2012, 10:20 Uhr
Zeile 26:		Zeile 26:
	== Welche Methoden stellt der Logger bereit? ==		== Welche Methoden stellt der Logger bereit? ==

−	Es gibt ~~zum einen~~ verschiedene Methoden um z.B. das LogLevel ~~zu ändern~~ oder den Dateipfad für die LogDatei.	+	Es gibt verschiedene Methoden um z.B. das LogLevel oder den Dateipfad für die LogDatei zu ändern.

−	Viel wichtiger sind die beiden Methoden zum eigentlichen ~~loggen~~.	+	Viel wichtiger sind aber die beiden Methoden zum eigentlichen Loggen.
−	~~Zum einen~~ gibt es die Methode "log" mit 2 Parametern. Wird diese Methode verwendet wird nur das LogLevel benötigt für das diese LogNachricht bestimmt ist und mit dem zweiten Parameter wird die eigentliche LogMessage angegeben.	+	Einerseits gibt es die Methode "log" mit 2 Parametern. Wird diese Methode verwendet wird nur das LogLevel benötigt für das diese LogNachricht bestimmt ist und mit dem zweiten Parameter wird die eigentliche LogMessage angegeben.

−	Über diese Methode hinaus gibt es die Methode "log" mit insgesamt 5 Parametern. Diese enthält die beiden, wie sie eben beschrieben wurden und zusätzlich verschiedene Angaben, die die Meldung näher spezifizieren. Es kann ein bestimmter "Header" für die Error Nachricht angegeben werden, die dem User ~~Grafisch~~ bei einem Error präsentiert wird. Es kann ein Klassenname (als String) und eine Exception als Objekt übergeben werden.	+	Über diese Methode hinaus gibt es die Methode "log" mit insgesamt 5 Parametern. Diese enthält die beiden, wie sie eben beschrieben wurden und zusätzlich verschiedene Angaben, die die Meldung näher spezifizieren. Es kann ein bestimmter "Header" für die Error Nachricht angegeben werden, die dem User grafisch bei einem Error präsentiert wird. Es kann ein Klassenname (als String) und eine Exception als Objekt übergeben werden.
	Sollte ein Parameter mit null oder leer ("") belegt sein, so wird dieser ignoriert.		Sollte ein Parameter mit null oder leer ("") belegt sein, so wird dieser ignoriert.

Chge: /* Auf welche Arten wird geloggt? */

2012-05-02T09:47:22Z

Auf welche Arten wird geloggt?

← Nächstältere Version		Version vom 2. Mai 2012, 09:47 Uhr
Zeile 17:		Zeile 17:
	== Auf welche Arten wird geloggt? ==		== Auf welche Arten wird geloggt? ==

−	Der Logger gibt einerseits eine Meldung an die Konsole ~~und~~ außerdem wird ein Log-File erstellt.	+	Der Logger gibt einerseits eine Meldung an die Konsole, außerdem wird ein Log-File erstellt.
−	Im besonders kritischen ~~Fall~~ wird ~~außerdem~~ ein GUI-Error-Fenster angezeigt, ~~dass~~ dem Nutzer den Fehler direkt präsentiert.	+	In besonders kritischen Fällen wird zusätzlich ein GUI-Error-Fenster angezeigt, das dem Nutzer den Fehler direkt präsentiert.

−	An dieser Stelle soll ~~nochmal~~ betont werden, dass wirklich nur geloggt wird wenn das LogLevel stimmt. ~~Das~~ LogLevel muss mindestens genauso "schlimm" sein oder noch "schlimmer" ~~als~~ das, was im Logger ~~eingestellt~~ ist.	+	An dieser Stelle soll nochmals betont werden, dass wirklich nur geloggt wird, wenn das LogLevel stimmt. D.h. das LogLevel muss mindestens genauso "schlimm" sein oder noch "schlimmer" wie das, was im Logger definiert ist.

	Das LogLevel kann im laufenden Betrieb geändert werden.		Das LogLevel kann im laufenden Betrieb geändert werden.

Chge: /* LogLevel */

2012-05-02T09:34:40Z

LogLevel

← Nächstältere Version		Version vom 2. Mai 2012, 09:34 Uhr
Zeile 8:		Zeile 8:
	Für unser relativ kleines Projekt sind nicht viele LogLevel notwendig.		Für unser relativ kleines Projekt sind nicht viele LogLevel notwendig.
	* Debug		* Debug
−	Das DebugLevel ist für Meldungen gedacht die eher zum Programmablauf ~~gedacht sind~~, um zu verstehen wie ein Fehler auftreten kann. Es muss hier also kein konkreter Fehler direkt damit in Verbindung stehen.	+	Das DebugLevel ist für Meldungen gedacht, die eher zum Programmablauf gehören, um zu verstehen wie ein Fehler auftreten kann. Es muss hier also kein konkreter Fehler direkt damit in Verbindung stehen.
	* Info		* Info
−	Das Info-Level ist für Informationen gedacht, die auch eher den Programmablauf protokollieren, aber auch für den Anwender von Bedeutung sind. (Z.b. irgendwelche Verzweigungen, die zwar unvorhergesehen sind, das Programm aber durchaus ~~weiterlaufenn~~ kann --> Eine Variable kann nicht gelesen werden, es wird eine StandardVariable benutzt)	+	Das Info-Level ist für Informationen gedacht, die auch eher den Programmablauf protokollieren, aber auch für den Anwender von Bedeutung sind. (z.B. irgendwelche Verzweigungen, die zwar unvorhergesehen sind, das Programm aber durchaus weiterlaufen kann --> Eine Variable kann nicht gelesen werden, es wird eine StandardVariable benutzt)
	Das Info-Level ist standardmäßig eingestellt!		Das Info-Level ist standardmäßig eingestellt!
	* Error		* Error
−	Wird ein Error geloggt, dann handelt es sich um einen kritischen Fehler, das Programm (oder die gerade benutzte Funktion) kann so nicht weiter benutzt werden. Ein Error manifestiert sich außerdem zusätzlich in einem Fehlerfenster, das dem Nutzer angezeigt wird. (Z.b. damit nicht einfach das Programm ohne Fehlermeldung ~~abschmiert!~~)	+	Wird ein Error geloggt, dann handelt es sich um einen kritischen Fehler, das Programm (oder die gerade benutzte Funktion) kann so nicht weiter benutzt werden. Ein Error manifestiert sich außerdem zusätzlich in einem Fehlerfenster, das dem Nutzer angezeigt wird. (z.B. damit nicht einfach das Programm ohne Fehlermeldung abstürzt)

	== Auf welche Arten wird geloggt? ==		== Auf welche Arten wird geloggt? ==

Chge: /* LogLevel */

2012-05-02T09:32:04Z

LogLevel

← Nächstältere Version		Version vom 2. Mai 2012, 09:32 Uhr
Zeile 6:		Zeile 6:
	== LogLevel ==		== LogLevel ==

−	Für unser relativ kleines Projekt sind~~, denke ich,~~ nicht viele LogLevel notwendig.	+	Für unser relativ kleines Projekt sind nicht viele LogLevel notwendig.
	* Debug		* Debug
	Das DebugLevel ist für Meldungen gedacht die eher zum Programmablauf gedacht sind, um zu verstehen wie ein Fehler auftreten kann. Es muss hier also kein konkreter Fehler direkt damit in Verbindung stehen.		Das DebugLevel ist für Meldungen gedacht die eher zum Programmablauf gedacht sind, um zu verstehen wie ein Fehler auftreten kann. Es muss hier also kein konkreter Fehler direkt damit in Verbindung stehen.

Chge: /* Einleitung */

2012-05-02T09:31:37Z

Einleitung

← Nächstältere Version		Version vom 2. Mai 2012, 09:31 Uhr
Zeile 2:		Zeile 2:

	Für diverse Stellen in einem Programm muss es möglich sein bestimmte Schritte zu loggen. Das heißt konkret es werden Informationen, in welcher Form auch immer, gespeichert und protokolliert.		Für diverse Stellen in einem Programm muss es möglich sein bestimmte Schritte zu loggen. Das heißt konkret es werden Informationen, in welcher Form auch immer, gespeichert und protokolliert.
−	Welche Informationen und ~~wie viel~~ protokolliert wird legt ein ~~sog.~~ LogLevel fest. Beim Entwicklen soll z.B. möglichst viel geloggt werden, im echten Betrieb nur wichtige Fehler.	+	Welche Informationen und wieviel protokolliert wird, legt ein sogenannter LogLevel fest. Beim Entwicklen soll z.B. möglichst viel geloggt werden, im echten Betrieb nur wichtige Fehler.

	== LogLevel ==		== LogLevel ==

Jonw: Die Seite wurde neu angelegt: „== Einleitung == Für diverse Stellen in einem Programm muss es möglich sein bestimmte Schritte zu loggen. Das heißt konkret es werden Informationen, in welche…“

2012-01-30T20:34:38Z

Die Seite wurde neu angelegt: „== Einleitung == Für diverse Stellen in einem Programm muss es möglich sein bestimmte Schritte zu loggen. Das heißt konkret es werden Informationen, in welche…“

Neue Seite

== Einleitung ==

Für diverse Stellen in einem Programm muss es möglich sein bestimmte Schritte zu loggen. Das heißt konkret es werden Informationen, in welcher Form auch immer, gespeichert und protokolliert.
Welche Informationen und wie viel protokolliert wird legt ein sog. LogLevel fest. Beim Entwicklen soll z.B. möglichst viel geloggt werden, im echten Betrieb nur wichtige Fehler.

== LogLevel ==

Für unser relativ kleines Projekt sind, denke ich, nicht viele LogLevel notwendig.
* Debug
Das DebugLevel ist für Meldungen gedacht die eher zum Programmablauf gedacht sind, um zu verstehen wie ein Fehler auftreten kann. Es muss hier also kein konkreter Fehler direkt damit in Verbindung stehen.
* Info
Das Info-Level ist für Informationen gedacht, die auch eher den Programmablauf protokollieren, aber auch für den Anwender von Bedeutung sind. (Z.b. irgendwelche Verzweigungen, die zwar unvorhergesehen sind, das Programm aber durchaus weiterlaufenn kann --> Eine Variable kann nicht gelesen werden, es wird eine StandardVariable benutzt)
Das Info-Level ist standardmäßig eingestellt!
* Error
Wird ein Error geloggt, dann handelt es sich um einen kritischen Fehler, das Programm (oder die gerade benutzte Funktion) kann so nicht weiter benutzt werden. Ein Error manifestiert sich außerdem zusätzlich in einem Fehlerfenster, das dem Nutzer angezeigt wird. (Z.b. damit nicht einfach das Programm ohne Fehlermeldung abschmiert!)

== Auf welche Arten wird geloggt? ==

Der Logger gibt einerseits eine Meldung an die Konsole und außerdem wird ein Log-File erstellt.
Im besonders kritischen Fall wird außerdem ein GUI-Error-Fenster angezeigt, dass dem Nutzer den Fehler direkt präsentiert.

An dieser Stelle soll nochmal betont werden, dass wirklich nur geloggt wird wenn das LogLevel stimmt. Das LogLevel muss mindestens genauso "schlimm" sein oder noch "schlimmer" als das, was im Logger eingestellt ist.

Das LogLevel kann im laufenden Betrieb geändert werden.

== Welche Methoden stellt der Logger bereit? ==

Es gibt zum einen verschiedene Methoden um z.B. das LogLevel zu ändern oder den Dateipfad für die LogDatei.

Viel wichtiger sind die beiden Methoden zum eigentlichen loggen.
Zum einen gibt es die Methode "log" mit 2 Parametern. Wird diese Methode verwendet wird nur das LogLevel benötigt für das diese LogNachricht bestimmt ist und mit dem zweiten Parameter wird die eigentliche LogMessage angegeben.

Über diese Methode hinaus gibt es die Methode "log" mit insgesamt 5 Parametern. Diese enthält die beiden, wie sie eben beschrieben wurden und zusätzlich verschiedene Angaben, die die Meldung näher spezifizieren. Es kann ein bestimmter "Header" für die Error Nachricht angegeben werden, die dem User Grafisch bei einem Error präsentiert wird. Es kann ein Klassenname (als String) und eine Exception als Objekt übergeben werden.
Sollte ein Parameter mit null oder leer ("") belegt sein, so wird dieser ignoriert.

== Wo ist der Logger zu finden? ==

Der Logger ist Bestandteil des Jar-Files "tools", dass auch noch den ConfigManager beherbergt.
Das Paket ist mit einer Classpath Variable bereits in unserem Projekt eingebunden.
Er kann einfach mit Logger.xx (xx für die entsprechende Methode) benutzt werden. Wobei aufgepasst werden muss dass auch unser Logger verwendet wird (Auswahlliste in Eclipse). Da der Logger statisch ist muss nichts initialisiert werden. Es sollte aber das LogLevel nur an einer zentralen Stelle geändert werden (z.b. gleich in der Starter-->main)

Der Logger benutzt Standardmäßig das LogLevel INFO