Roblet®-Development-Kit
1.3 (11Sep10)
API für Anwendungen

genRob.genControl.unit.log
Interface Logger2

All Superinterfaces:
Unit

public interface Logger2
extends Unit

Mit dieser Einheit kann ein Roblet Nachrichten ins Logbuch des Roblet®-Servers eintragen.  Die Nachrichten müssen serialisierbar sein.

Die Anforderungen an eine Nachricht umfassen nicht nur die Serialisierbarkeit der übergebenen Instanz, was auch bedeutet, daß alle referenzierten Instanzen serialisierbar sein müssen, sondern auch, daß alle Referenzen als final gekennzeichnet sind.  Letzteres stellt sicher, daß eine Nachricht nicht nachträglich noch (fälschlicherweise) verändert werden kann.  Eine komplette Liste von Prüfungskriterien findet sich im Kapitel Instanzprüfung der Paketbeschreibung.

Wird beim Loggen festgestellt, daß o.g. Bedingungen nicht eingehalten werden, so wird die Object.toString()-Methode benutzt, um so einen String zu erzeugen, der dann stattdessen verwendet wird.  Ein die Nachricht interpretierendes Programm kann dann später die Nachricht u.U. nicht mehr speziell verarbeiten.  Die genannten Tests und gegebenenfalls Wandlungen geschehen im Kontext des loggenden Threads.

Diese Einheit ersetzt Logger.

See Also:
Log2

Method Summary
 void log(Serializable message)
          Schreibt eine Nachricht in das Logbuch des Roblet®-Servers.
 

Method Detail

log

public void log(Serializable message)
Schreibt eine Nachricht in das Logbuch des Roblet®-Servers.

Entspricht die Nachricht nicht den Anforderungen, so wird stattdessen eine Instanz vom Typ String erzeugt durch Aufruf der Methode Object.toString() in das Logbuch geschrieben.

Parameters:
message - Nachricht

Roblet®-Development-Kit
1.3 (11Sep10)
API für Anwendungen

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