Roblet®-Development-Kit
1.2 (22Jul10)
API für Anwendungen

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
Log Deprecated. Nutzen Sie bitte Log2
Log2 Einheit, die den lesenden Zugriff auf das Logbuch des jeweiligen Roblet®-Servers ermöglicht.
Logger Deprecated. Nutzen Sie bitte Logger2
Logger2 Mit dieser Einheit kann ein Roblet Nachrichten ins Logbuch des Roblet®-Servers eintragen.
 

Class Summary
ChainReport Enthält die Beschreibung einer Verkettung.
LogEntry Deprecated. Siehe Log2
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.
ThreadInfo Deprecated. Siehe Log2
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ß:

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.

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


Roblet®-Development-Kit
1.2 (22Jul10)
API für Anwendungen

Copyright © 2001-2010, roblet®.org, Hagen Stanek, http://roblet.org/rdk