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.int
Bestimmt die Version des konkreten Serialisierers.void
setOutputStream
(OutputStream outputStream) Setzt den zu verwendenden Ausgabe-Stream.void
writeBoolean
(boolean value) Serialisiert einenboolean
-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.void
writeByte
(int value) Serialisiert einenbyte
-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.void
writeBytes
(byte[] bytes) Schreibt ein Byte-Array auf den Ausgabe-Stream.void
writeBytes
(byte[] bytes, int offset, int length) Schreibt ein Folge von Bytes aus einem Byte-Array auf den Ausgabe-Stream.void
Serialisiert einen Datensatz in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.void
writeDouble
(double value) Serialisiert einendouble
-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.void
writeFloat
(float value) Serialisiert einenfloat
-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.void
writeInt
(int value) Serialisiert einenint
-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.void
writeLong
(long value) Serialisiert einenlong
-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.void
writeObjectReference
(SystemObject object) Serialisiert die id eines Systemobjekts in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.void
writeShort
(int value) Serialisiert einenshort
-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.void
writeString
(String value) Serialisiert einenString
-Wert mit einer maximalLänge von 65535 in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.void
writeString
(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 oder0
wenn 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.
-