Package genRob.genControl.unit.log

Dieses Java™-Paket enthält die Einheiten und Hilfsklassen, die benötigt werden, um mit dem Logbuch des Roblet®-Servers arbeiten zu können.

See:
Description

Interface Summary

Log2	Einheit, die den lesenden Zugriff auf das Logbuch des jeweiligen Roblet®-Servers ermöglicht.
Logger2	Mit dieser Einheit kann ein Roblet Nachrichten ins Logbuch des Roblet®-Servers eintragen.

Class Summary

ChainReport	Enthält die Beschreibung einer Verkettung.
LogEntry2	Einträge im Logbuch werden in dieser Form zurückgegeben.
ModuleWrapper	Umschlag für einen Modul-Log-Eintrag, d.h. einen Eintrag, der von einem Modul im Roblet®-Server kommt.
ObjectInfo	Enthält Informationen zu einem Objekt (Instanz).
RobletWrapper	Umschlag für einen Roblet®-Log-Eintrag, d.h. einen Eintrag, der von einem Roblet® kommt, welches im Roblet®-Server läuft.
ServerWrapper	Umschlag für einen Server-Log-Eintrag, d.h. einen Eintrag, der vom Roblet®-Server selbst kommt.
StackTraceElementReport	Enthält die Beschreibung eines StackTraceElement.
ThreadInfo2	Eine Instanz diesen Typs enthält Informationen über einen Thread.
ThrowableReport	Enthält die Beschreibung eines Throwable.

Package genRob.genControl.unit.log Description

Dieses Java™-Paket enthält die Einheiten und Hilfsklassen, die benötigt werden, um mit dem Logbuch des Roblet®-Servers arbeiten zu können. Dabei kann ein Roblet® selbst Nachrichten ins Logbuch eintragen aber auch das Logbuch mit all seinen Einträgen inspizieren.

Per Einheit Logger2 kann ein Roblet® Nachrichten ins Logbuch eintragen lassen. Demgegenüber erlaubt die Einheit Log2 die Einsicht in das vom Roblet®-Server zentral geführte Logbuch, wofür dann Elemente vom Typ LogEntry2 zur Laufzeit zur weiteren Verarbeitung im Roblet® herausgegeben werden.

Instanzprüfung

Durch eine Instanzprüfung von Elementen, die für den Eintrag in das Logbuch übergeben werden, wird sichergestellt, daß die herausgegebenen Instanzen serialisierbar und unveränderlich sind. Weiterhin sind die in diesem Paket definierten Klassen, wie z.B. RobletWrapper und ThrowableReport, so gebaut, daß Instanzen auch netzwerkweit gleich sind, d.h. die Methoden Object.equals(Object) und Object.hashCode() sind passend implementiert. Auch liefert Object.toString() eine stets gleiche, für Menschen verständliche Information.

Folgendes sind die Kriterien, denen jede Instanz genügen muß:

• Die jeweilige Klasse der Instanz implementiert direkt oder über Oberklassen die Schnittstelle Serializable (instanceof-Prüfung).
• Die Instanz ist vom Typ String.
• Die direkte Oberklasse ist vom Typ Object oder genügt den hier niedergelegten Bedingungen (mit Ausnahme von Serializable).
• Die Klasse der Instanz wurde im Server nicht in einem Roblet® bzw. genauer durch einen Roblet®-Klassenlader erzeugt.
• Direkt oder durch Oberklassen implementierte Schnittstellen genügen den hier genannten Bedingungen (mit Ausnahme von Serializable).
• Die Felder einer Instanz sind:
  • wenn static, dann ohne weitere Prüfung,
  • desselben bei transient,
  • ansonsten aber final und public
  • weiterhin im Falle eines "primitive" beliebig
  • keine Felder ("array")
  • als Referenz auf ein Objekt null oder
  • als Referenz auf ein Objekt, welches den bisher genannten Bedingungen genügt.

Wird eine Information übergeben, welche nicht den eben genannten Bedingungen genügt, so wird mit Hilfe der toString() eine Zeichenkette erzeugt. Damit sind dann jedoch alle Typinformationen verlorengegangen.

Es gibt einige vorgefertigte Klassen, die als Beschreibung von Instanzen von Klassen dienen können, die von Natur aus nicht den oben genannten Bedingungen genügen.

• Um Ausnahmen (Throwable) zu übergeben, kann auf ThrowableReport zurückgegriffen werden.
• Eine Verkettung ähnlich zu MessageFormat läßt sich über ChainReport-Instanzen darstellen.

Generell gilt für die in diesem Paket definierten vorgefertigten Klassen folgende Benennungsregel:

• Mit Hilfe eines Loggers werden Strings oder Reports ins Logbuch geschrieben.
• Zugriff auf das Logbuch erhält man über ein Log, welches LogEntrys zurückgibt, die einen Wrapper enthalten, welcher aus Server-erzeugten Infos und per Logger geschreibenen Reports und Strings besteht.