Ein ArrayOutputRecordStream-Objekt repräsentiert ein für den sequentiellen Schreib-Zugriff geöffnetes Array von Record-Objekten. Das Array wird beim Öffnen implizit angelegt (siehe Abschnitt „Öffnen und Schließen“ unten) und wächst mit den hineingeschriebenen Daten.
Die ArrayOutputRecordStream-Klasse bietet Methoden zum Schreiben von Sätzen. Beim Schreiben werden Datensätze immer am Ende des Arrays hinzugefügt. Außerdem bietet diese Klasse noch Methoden, um den kompletten Inhalt des Datenstroms abzuholen, ihn zu löschen oder die Größe abzufragen.
Öffnen und Schließen
Bei der Konstruktion eines ArrayOutputRecordStream-Objektes wird ein Array intern bereitgestellt, in das später Datensätze geschrieben werden sollen. Der Aufrufer kann dabei angeben, wie viele Datensätze das Array zunächst aufnehmen soll. Tut er das nicht, wird eine Standardgröße angenommen. Reicht diese Größe dann aber nicht aus, um die geschriebenen Datensätze aufzunehmen, wird das Array automatisch intern vergrößert.
Die Methode close() ist zwar vorhanden, hat aber für diese Klasse keine Funktion.
Methoden zum Schreiben von Sätzen
Die Methode write() fügt einen Satz hinter den letzten vorhandenen Satz des Arrays hinzu.
Die Methode flush() ist zwar vorhanden, hat aber für diese Klasse keine Funktion.
Methoden für den Zugriff auf den Inhalt eines Datenstroms
Die Methode size() liefert die Anzahl der Datensätze, die sich im Array befinden.
Mit der Methode reset() kann der komplette Inhalt des Arrays gelöscht werden. Das Array selbst bleibt dabei in seiner gewachsenen Größe erhalten und wird bei weiteren write() Aufrufen wieder gefüllt.
Die Methode toRecordArray() liefert den kompletten momentanen Inhalt des Datenstroms als Array von Record-Objekten. Das gelieferte Array ist, im Gegensatz zu dem intern verwendeten, genauso groß, wie zur Aufnahme der Daten erforderlich. Die einzelnen Datensätze werden dabei aber nicht kopiert, so dass Manipulationen an den Satzinhalten Auswirkungen auf den Inhalt des Datenstroms haben.
Die Methode writeTo() schreibt den kompletten momentanen Inhalt des Daten-stroms in einen gegebenen anderen Datenstrom. Dafür ist jeder Datenstrom geeignet, dessen Implementierung von der abstrakten Klasse OutputRecordStream abgeleitet wurde.