Interface Serializer
public interface Serializer
Schnittstelle zum Serialisieren von Datensätzen. Konkrete Objekte zum Serialisieren können mit den verschiedenen Methoden der Klasse
SerializingFactory erzeugt werden. Dabei kann der Ausgabe-Stream für die Serialisierung vorgegeben werden.
Mit den verschiedenen write-Methoden können primitive Datentypen, Referenzen auf System-Objekte und ganze Datensätze auf einen OutputStream serialisiert werden.
Über die getVersion() Methode kann die Version eines konkreten Serialisieres abgefragt werden.
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionBestimmt den für die Serialisierung zu verwendenden Ausgabe-Stream.intBestimmt die Version des konkreten Serialisierers.voidsetOutputStream(OutputStream outputStream) Setzt den zu verwendenden Ausgabe-Stream.voidwriteBoolean(boolean value) Serialisiert einenboolean-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.voidwriteByte(int value) Serialisiert einenbyte-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.voidwriteBytes(byte[] bytes) Schreibt ein Byte-Array auf den Ausgabe-Stream.voidwriteBytes(byte[] bytes, int offset, int length) Schreibt ein Folge von Bytes aus einem Byte-Array auf den Ausgabe-Stream.voidSerialisiert einen Datensatz in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.voidwriteDouble(double value) Serialisiert einendouble-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.voidwriteFloat(float value) Serialisiert einenfloat-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.voidwriteInt(int value) Serialisiert einenint-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.voidwriteLong(long value) Serialisiert einenlong-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.voidwriteObjectReference(SystemObject object) Serialisiert die id eines Systemobjekts in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.voidwriteShort(int value) Serialisiert einenshort-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.voidwriteString(String value) Serialisiert einenString-Wert mit einer maximalLänge von 65535 in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.voidwriteString(String value, int maxLength) Serialisiert einenString-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.
-
Method Details
-
getVersion
int getVersion()Bestimmt die Version des konkreten Serialisierers.- Returns:
- Version des Serialisierers.
-
getOutputStream
OutputStream getOutputStream()Bestimmt den für die Serialisierung zu verwendenden Ausgabe-Stream.- Returns:
- Für die Serialisierung zu verwendenden Ausgabe-Stream.
-
setOutputStream
Setzt den zu verwendenden Ausgabe-Stream.- Parameters:
outputStream- Zu verwendender Ausgabe-Stream
-
writeData
Serialisiert einen Datensatz in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.- Parameters:
data- Der zu serialisierende Datensatz.- Throws:
IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.
-
writeBoolean
Serialisiert einenboolean-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.- Parameters:
value- Der zu serialisierende Wert.- Throws:
IOException- Wenn ein I/O Fehler beim Schreiben auf den Ausgabe-Strom auftritt.
-
writeObjectReference
Serialisiert die id eines Systemobjekts in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.- Parameters:
object- Das Systemobjekt dessen id serialisiert werden soll.- Throws:
IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.
-
writeLong
Serialisiert einenlong-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.- Parameters:
value- Der zu serialisierende Wert.- Throws:
IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.
-
writeInt
Serialisiert einenint-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.- Parameters:
value- Der zu serialisierende Wert.- Throws:
IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.
-
writeShort
Serialisiert einenshort-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.- Parameters:
value- Der zu serialisierende Wert.- Throws:
IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.
-
writeByte
Serialisiert einenbyte-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.- Parameters:
value- Der zu serialisierende Wert.- Throws:
IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.
-
writeDouble
Serialisiert einendouble-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.- Parameters:
value- Der zu serialisierende Wert.- Throws:
IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.
-
writeFloat
Serialisiert einenfloat-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.- Parameters:
value- Der zu serialisierende Wert.- Throws:
IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.
-
writeString
Serialisiert einenString-Wert mit einer maximalLänge von 65535 in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.- Parameters:
value- Der zu serialisierende Wert.- Throws:
IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.IllegalArgumentException- Wenn die Länge des Strings größer als 65535 Zeichen ist.
-
writeString
Serialisiert einenString-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream. Es ist zu beachten, dass beim Deserialiseren die gleiche Maximalgröße wie beim serialisieren angegeben wird.- Parameters:
value- Der zu serialisierende Wert.maxLength- Maximale Länge des zu serialisierenden Strings oder0wenn keine Begrenzung vorgegeben werden kann.- Throws:
IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.IllegalArgumentException- Wenn die Länge des Strings größer als die angegebene Maximallänge ist.
-
writeBytes
Schreibt ein Byte-Array auf den Ausgabe-Stream. Es ist zu beachten, dass die Größe des Arrays nicht implizit serialisiert wird und beim Deserialisieren angegeben werden muss.- Parameters:
bytes- Zu schreibendes Byte-Array- Throws:
IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.
-
writeBytes
Schreibt ein Folge von Bytes aus einem Byte-Array auf den Ausgabe-Stream. Es ist zu beachten, dass die Anzahl der Bytes nicht implizit serialisiert wird und beim Deserialisieren passend angegeben werden muss.- Parameters:
bytes- Byte-Array mit den zu schreibenden Bytesoffset- Start-Offset des ersten zu schreibenden Bytes im Arraylength- Anzahl der zu schreibenden Bytes- Throws:
IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.
-