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.

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

long getSize()

Gibt die Größe des Logbuchs zurück.

Returns:

Anzahl der Log-Einträge

getEntries

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