Interface Deserializer
public interface Deserializer
Schnittstelle zum Deserialisieren von Datensätzen. Konkrete Objekte zum Deserialisieren können mit den verschiedenen Methoden der Klasse
SerializingFactory
erzeugt werden. Dabei kann der Eingabe-Stream für die Deserialisierung vorgegeben werden.
Mit den verschiedenen read
-Methoden können primitive Datentypen, Referenzen auf System-Objekte
und ganze Datensätze
von einem InputStream
eingelesen und deserialisiert werden.
Über die getVersion()
Methode kann die Version eines konkreten Deserialisieres abgefragt werden.
- See Also:
-
Method Summary
Modifier and TypeMethodDescriptionBestimmt den bei der Deserialisierung zu verwendenden Eingabe-Stream.int
Bestimmt die Version des konkreten Deserialisierers.boolean
Liest und deserialisiert einenboolean
-Wert vom Eingabe-Strom dieses Deserialisierers.byte
readByte()
Liest und deserialisiert einenbyte
-Wert vom Eingabe-Stream dieses Deserialisierers.void
readBytes
(byte[] buffer, int offset, int length) Liest eine vorgegebene Anzahl von Bytes vom Eingabe-Stream dieses Deserialisierers ein und speichert diese an einem vorgegebenen Offset in ein vorhandenes Byte-Array.byte[]
readBytes
(int length) Liest ein Byte-Array mit vorgegebener Länge vom Eingabe-Stream dieses Deserialisierers.readData
(AttributeGroup atg) Liest und deserialisiert einen Datensatz aus dem Eingabe-Stream dieses Deserialisierers.readData
(AttributeGroup atg, ObjectLookup dataModel) Liest und deserialisiert einen Datensatz aus dem Eingabe-Stream dieses Deserialisierers.void
Liest und deserialisiert einen Datensatz aus dem Eingabe-Stream dieses Deserialisierers.void
readData
(Data data, ObjectLookup dataModel) Liest und deserialisiert einen Datensatz aus dem Eingabe-Stream dieses Deserialisierers.double
Liest und deserialisiert einendouble
-Wert vom Eingabe-Stream dieses Deserialisierers.float
Liest und deserialisiert einenfloat
-Wert vom Eingabe-Stream dieses Deserialisierers.int
readInt()
Liest und deserialisiert einenint
-Wert vom Eingabe-Stream dieses Deserialisierers.long
readLong()
Liest und deserialisiert einenlong
-Wert vom Eingabe-Stream dieses Deserialisierers.readObjectReference
(ObjectLookup dataModel) Liest und deserialisiert eine Referenz auf ein Systemobjekt vom Eingabe-Stream dieses Deserialisierers.default List<SystemObject>
readObjectReferences
(DataModel dataModel) Liest mehrere Objektreferenzen vom Eingabe-Stream dieses Deserialisierers.short
Liest und deserialisiert einenshort
-Wert vom Eingabe-Stream dieses Deserialisierers.Liest und deserialisiert einenString
-Wert mit einer maximalen Länge von 65535 vom Eingabe-Stream dieses Deserialisierers.readString
(int maxLength) Liest und deserialisiert einenString
-Wert mit einer vorgegebenen Maximal-Länge vom Eingabe-Stream dieses Deserialisierers.int
Liest und deserialisiert einenbyte
-Wert vom Eingabe-Stream dieses Deserialisierers und interpretiert den Wert als vorzeichenlose Zahl.long
Liest und deserialisiert einenint
-Wert vom Eingabe-Stream dieses Deserialisierers und interpretiert den Wert als vorzeichenlose Zahl.int
Liest und deserialisiert einenshort
-Wert vom Eingabe-Stream dieses Deserialisierers und interpretiert den Wert als vorzeichenlose Zahl.void
setInputStream
(InputStream inputStream) Setzt den zu verwendenden Eingabe-Stream.
-
Method Details
-
getVersion
int getVersion()Bestimmt die Version des konkreten Deserialisierers.- Returns:
- Version des Deserialisierers.
-
getInputStream
InputStream getInputStream()Bestimmt den bei der Deserialisierung zu verwendenden Eingabe-Stream.- Returns:
- Bei der Deserialisierung zu verwendender Eingabe-Stream.
-
setInputStream
Setzt den zu verwendenden Eingabe-Stream.- Parameters:
inputStream
- Zu verwendender InputStream
-
readData
Liest und deserialisiert einen Datensatz aus dem Eingabe-Stream dieses Deserialisierers.- Parameters:
data
- Neuer Datensatz, der mit der Attributgruppe der erwarteten Daten initialisiert wurde.- Throws:
IOException
- Wenn beim Lesen vom Eingabe-Stream Fehler aufgetreten sind.- See Also:
-
readData
Liest und deserialisiert einen Datensatz aus dem Eingabe-Stream dieses Deserialisierers.- Parameters:
atg
- Attributgruppe des einzulesenden Datensatzes.- Returns:
- Eingelesener Datensatz
- Throws:
IOException
- Wenn beim Lesen vom Eingabe-Stream Fehler aufgetreten sind.
-
readData
Liest und deserialisiert einen Datensatz aus dem Eingabe-Stream dieses Deserialisierers.- Parameters:
data
- Neuer Datensatz, der mit der Attributgruppe der erwarteten Daten initialisiert wurde.dataModel
- Datenmodell mit dessen Hilfe Objektreferenzen aufgelöst werden.- Throws:
IOException
- Wenn beim Lesen vom Eingabe-Stream Fehler aufgetreten sind.- See Also:
-
readData
Liest und deserialisiert einen Datensatz aus dem Eingabe-Stream dieses Deserialisierers.- Parameters:
atg
- Attributgruppe des einzulesenden Datensatzes.dataModel
- Datenmodell mit dessen Hilfe Objektreferenzen aufgelöst werden.- Returns:
- Eingelesener Datensatz
- Throws:
IOException
- Wenn beim Lesen vom Eingabe-Stream Fehler aufgetreten sind.
-
readBoolean
Liest und deserialisiert einenboolean
-Wert vom Eingabe-Strom dieses Deserialisierers.- Returns:
- Der eingelesene Wert.
- Throws:
IOException
- Wenn beim Lesen vom Eingabe-Stream Fehler aufgetreten sind.
-
readObjectReference
Liest und deserialisiert eine Referenz auf ein Systemobjekt vom Eingabe-Stream dieses Deserialisierers.- Parameters:
dataModel
- Datenmodell mit dessen Hilfe Objektreferenzen aufgelöst werden.- Returns:
- Das referenzierte Systemobjekt oder
null
, wenn das referenzierte Objekt nicht bestimmt werden kann. - Throws:
IOException
- Wenn beim Lesen vom Eingabe-Stream Fehler aufgetreten sind.
-
readObjectReferences
Liest mehrere Objektreferenzen vom Eingabe-Stream dieses Deserialisierers. Diese Methode liefert das gleiche Resultat wiesize = readInt()
gefolgt von *size* Aufrufen von
readObjectReference().
- Parameters:
dataModel
- Datenmodell mit dessen Hilfe Objektreferenzen aufgelöst werden.- Returns:
- Arrays von referenzierten Systemobjekten (ggf. mit null-Elementen wenn ein Objekt nicht aufgelöst werden konnte)
- Throws:
IOException
- Wenn beim Lesen vom Eingabe-Stream Fehler aufgetreten sind.
-
readByte
Liest und deserialisiert einenbyte
-Wert vom Eingabe-Stream dieses Deserialisierers.- Returns:
- Der eingelesene Wert.
- Throws:
IOException
- Wenn beim Lesen vom Eingabe-Stream Fehler aufgetreten sind.
-
readUnsignedByte
Liest und deserialisiert einenbyte
-Wert vom Eingabe-Stream dieses Deserialisierers und interpretiert den Wert als vorzeichenlose Zahl.- Returns:
- Der eingelesene Wert als vorzeichenlose Zahl.
- Throws:
IOException
- Wenn beim Lesen vom Eingabe-Stream Fehler aufgetreten sind.
-
readShort
Liest und deserialisiert einenshort
-Wert vom Eingabe-Stream dieses Deserialisierers.- Returns:
- Der eingelesene Wert.
- Throws:
IOException
- Wenn beim Lesen vom Eingabe-Stream Fehler aufgetreten sind.
-
readUnsignedShort
Liest und deserialisiert einenshort
-Wert vom Eingabe-Stream dieses Deserialisierers und interpretiert den Wert als vorzeichenlose Zahl.- Returns:
- Der eingelesene Wert als vorzeichenlose Zahl.
- Throws:
IOException
- Wenn beim Lesen vom Eingabe-Stream Fehler aufgetreten sind.
-
readInt
Liest und deserialisiert einenint
-Wert vom Eingabe-Stream dieses Deserialisierers.- Returns:
- Der eingelesene Wert.
- Throws:
IOException
- Wenn beim Lesen vom Eingabe-Stream Fehler aufgetreten sind.
-
readUnsignedInt
Liest und deserialisiert einenint
-Wert vom Eingabe-Stream dieses Deserialisierers und interpretiert den Wert als vorzeichenlose Zahl.- Returns:
- Der eingelesene Wert als vorzeichenlose Zahl.
- Throws:
IOException
- Wenn beim Lesen vom Eingabe-Stream Fehler aufgetreten sind.
-
readLong
Liest und deserialisiert einenlong
-Wert vom Eingabe-Stream dieses Deserialisierers.- Returns:
- Der eingelesene Wert.
- Throws:
IOException
- Wenn beim Lesen vom Eingabe-Stream Fehler aufgetreten sind.
-
readFloat
Liest und deserialisiert einenfloat
-Wert vom Eingabe-Stream dieses Deserialisierers.- Returns:
- Der eingelesene Wert.
- Throws:
IOException
- Wenn beim Lesen vom Eingabe-Stream Fehler aufgetreten sind.
-
readDouble
Liest und deserialisiert einendouble
-Wert vom Eingabe-Stream dieses Deserialisierers.- Returns:
- Der eingelesene Wert.
- Throws:
IOException
- Wenn beim Lesen vom Eingabe-Stream Fehler aufgetreten sind.
-
readString
Liest und deserialisiert einenString
-Wert mit einer maximalen Länge von 65535 vom Eingabe-Stream dieses Deserialisierers.- Returns:
- Der eingelesene String.
- Throws:
IOException
- Wenn beim Lesen vom Eingabe-Stream Fehler aufgetreten sind.
-
readString
Liest und deserialisiert einenString
-Wert mit einer vorgegebenen Maximal-Länge vom Eingabe-Stream dieses Deserialisierers. Es ist zu beachten, dass beim Deserialiseren die gleiche Maximalgröße wie beim Serialisieren angegeben wird.- Parameters:
maxLength
- Maximale Länge des einzulesenden Strings oder0
wenn keine Begrenzung vorgegeben werden kann.- Returns:
- Der eingelesene String.
- Throws:
IOException
- Wenn beim Lesen vom Eingabe-Stream Fehler aufgetreten sind.
-
readBytes
Liest ein Byte-Array mit vorgegebener Länge vom Eingabe-Stream dieses Deserialisierers. Es ist zu beachten, das als Länge exakt die Größe des entsprechenden serialisierten Arrays angegeben werden muss.- Parameters:
length
- Länge des einzulesenden Byte-Arrays- Returns:
- Das eingelesene Byte-Array
- Throws:
IOException
- Wenn beim Lesen vom Eingabe-Stream Fehler aufgetreten sind.
-
readBytes
Liest eine vorgegebene Anzahl von Bytes vom Eingabe-Stream dieses Deserialisierers ein und speichert diese an einem vorgegebenen Offset in ein vorhandenes Byte-Array. Es ist zu beachten, das als Länge exakt die Größe des entsprechenden serialisierten Arrays angegeben werden muss.- Parameters:
buffer
- Byte-Array in das die eingelesenen Bytes gespeichert werden sollen.offset
- Startposition im Byte-Array ab der die eingelesenen Bytes gespeichert werden sollen.length
- Anzahl der einzulesenden Bytes- Throws:
IOException
- Wenn beim Lesen vom Eingabe-Stream Fehler aufgetreten sind.
-