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.intBestimmt die Version des konkreten Deserialisierers.booleanLiest und deserialisiert einenboolean-Wert vom Eingabe-Strom dieses Deserialisierers.bytereadByte()Liest und deserialisiert einenbyte-Wert vom Eingabe-Stream dieses Deserialisierers.voidreadBytes(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.voidLiest und deserialisiert einen Datensatz aus dem Eingabe-Stream dieses Deserialisierers.voidreadData(Data data, ObjectLookup dataModel) Liest und deserialisiert einen Datensatz aus dem Eingabe-Stream dieses Deserialisierers.doubleLiest und deserialisiert einendouble-Wert vom Eingabe-Stream dieses Deserialisierers.floatLiest und deserialisiert einenfloat-Wert vom Eingabe-Stream dieses Deserialisierers.intreadInt()Liest und deserialisiert einenint-Wert vom Eingabe-Stream dieses Deserialisierers.longreadLong()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.shortLiest 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.intLiest und deserialisiert einenbyte-Wert vom Eingabe-Stream dieses Deserialisierers und interpretiert den Wert als vorzeichenlose Zahl.longLiest und deserialisiert einenint-Wert vom Eingabe-Stream dieses Deserialisierers und interpretiert den Wert als vorzeichenlose Zahl.intLiest und deserialisiert einenshort-Wert vom Eingabe-Stream dieses Deserialisierers und interpretiert den Wert als vorzeichenlose Zahl.voidsetInputStream(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 oder0wenn 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.
-