Interface Serializer
-
public interface SerializerSchnittstelle zum Serialisieren von Datensätzen. Konkrete Objekte zum Serialisieren können mit den verschiedenen Methoden der KlasseSerializingFactoryerzeugt werden. Dabei kann der Ausgabe-Stream für die Serialisierung vorgegeben werden.Mit den verschiedenen
write-Methoden können primitive Datentypen, Referenzen aufSystem-Objekteund ganzeDatensätzeauf einen OutputStream serialisiert werden.Über die
getVersion()Methode kann die Version eines konkreten Serialisieres abgefragt werden.- See Also:
Deserializer
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description java.io.OutputStreamgetOutputStream()Bestimmt den für die Serialisierung zu verwendenden Ausgabe-Stream.intgetVersion()Bestimmt die Version des konkreten Serialisierers.voidsetOutputStream(java.io.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.voidwriteData(Data data)Serialisiert 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(java.lang.String value)Serialisiert einenString-Wert mit einer maximalLänge von 65535 in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.voidwriteString(java.lang.String value, int maxLength)Serialisiert einenString-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.
-
-
-
Method Detail
-
getVersion
int getVersion()
Bestimmt die Version des konkreten Serialisierers.- Returns:
- Version des Serialisierers.
-
getOutputStream
java.io.OutputStream getOutputStream()
Bestimmt den für die Serialisierung zu verwendenden Ausgabe-Stream.- Returns:
- Für die Serialisierung zu verwendenden Ausgabe-Stream.
-
setOutputStream
void setOutputStream(java.io.OutputStream outputStream)
Setzt den zu verwendenden Ausgabe-Stream.- Parameters:
outputStream- Zu verwendender Ausgabe-Stream
-
writeData
void writeData(Data data) throws java.io.IOException
Serialisiert einen Datensatz in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.- Parameters:
data- Der zu serialisierende Datensatz.- Throws:
java.io.IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.
-
writeBoolean
void writeBoolean(boolean value) throws java.io.IOExceptionSerialisiert einenboolean-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.- Parameters:
value- Der zu serialisierende Wert.- Throws:
java.io.IOException- Wenn ein I/O Fehler beim Schreiben auf den Ausgabe-Strom auftritt.
-
writeObjectReference
void writeObjectReference(SystemObject object) throws java.io.IOException
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:
java.io.IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.
-
writeLong
void writeLong(long value) throws java.io.IOExceptionSerialisiert einenlong-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.- Parameters:
value- Der zu serialisierende Wert.- Throws:
java.io.IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.
-
writeInt
void writeInt(int value) throws java.io.IOExceptionSerialisiert einenint-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.- Parameters:
value- Der zu serialisierende Wert.- Throws:
java.io.IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.
-
writeShort
void writeShort(int value) throws java.io.IOExceptionSerialisiert einenshort-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.- Parameters:
value- Der zu serialisierende Wert.- Throws:
java.io.IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.
-
writeByte
void writeByte(int value) throws java.io.IOExceptionSerialisiert einenbyte-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.- Parameters:
value- Der zu serialisierende Wert.- Throws:
java.io.IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.
-
writeDouble
void writeDouble(double value) throws java.io.IOExceptionSerialisiert einendouble-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.- Parameters:
value- Der zu serialisierende Wert.- Throws:
java.io.IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.
-
writeFloat
void writeFloat(float value) throws java.io.IOExceptionSerialisiert einenfloat-Wert in einen Bytestrom und schreibt diesen auf den Ausgabe-Stream.- Parameters:
value- Der zu serialisierende Wert.- Throws:
java.io.IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.
-
writeString
void writeString(java.lang.String value) throws java.io.IOExceptionSerialisiert 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:
java.io.IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.java.lang.IllegalArgumentException- Wenn die Länge des Strings größer als 65535 Zeichen ist.
-
writeString
void writeString(java.lang.String value, int maxLength) throws java.io.IOExceptionSerialisiert 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:
java.io.IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.java.lang.IllegalArgumentException- Wenn die Länge des Strings größer als die angegebene Maximallänge ist.
-
writeBytes
void writeBytes(byte[] bytes) throws java.io.IOExceptionSchreibt 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:
java.io.IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.
-
writeBytes
void writeBytes(byte[] bytes, int offset, int length) throws java.io.IOExceptionSchreibt 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:
java.io.IOException- Wenn ein I/O Fehler bei Schreiben auf den Ausgabe-Stream auftritt.
-
-