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

genRob.genControl.unit.log
Interface Log2

All Superinterfaces:
Unit

public interface Log2
extends Unit

Einheit, die den lesenden Zugriff auf das Logbuch des jeweiligen Roblet®-Servers ermöglicht.

Log-Einträge werden mit Null beginnend fortlaufend nummeriert.

Diese Einheit ersetzt Log.

See Also:
Logger2

Method Summary
 LogEntry2[] getEntries(long start, int count)
          Gibt eine ausgewählte Anzahl von Log-Einträgen zurück.
 long getSize()
          Gibt die Größe des Logbuchs zurück.
 

Method Detail

getSize

public long getSize()
Gibt die Größe des Logbuchs zurück.

Returns:
Anzahl der Log-Einträge

getEntries

public LogEntry2[] getEntries(long start,
                              int count)
Gibt eine ausgewählte Anzahl von Log-Einträgen zurück.  Zu jeder Eintragsnummer gibt es jeweils nur eine Instanz des zugehörigen Log-Eintrages.  Referenzen auf diese Instanzen werden als Feld zurückgegeben.

Die zurückgegebene Feldgröße ist möglicherweise kleiner, als die gewünschte Anzahl Log-Einträge, es wird jedoch stets ein Feld zurückgegeben.

Ist die geforderte Anzahl kleiner oder gleich Null, so wird ein leeres Feld zurückgegeben.  Daraus folgt eine theoretische Feldgröße von maximal Integer.MAX_VALUE, welche jedoch durch die Implementierung weiter eingeschränkt werden kann.

Ist die Nummer des ersten Eintrags kleiner als Null und über die Anzahl addressierten Einträge hätten alle eine Nummer kleiner Null, so wird ein leeres Feld zurückgegeben.

Da die Nummerierung der Log-Einträge bei Null beginnt, gilt folgendes:  Ist die Nummer des ersten Log-Eintrags größer oder gleich der Anzahl aller Log-Einträge, so wird ein leeres Feld zurückgegeben.

Parameters:
start - Nummer des ersten Log-Eintrag
count - Anzahl der Einträge
Returns:
Feld mit Log-Einträgen;
stets nicht-null

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

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