de.bsvrz.sys.funclib.dataSerializer
Class SerializingFactory

java.lang.Object
  extended by de.bsvrz.sys.funclib.dataSerializer.SerializingFactory

public final class SerializingFactory
extends Object

Factory-Klasse zum Erzeugen von Objekten zur Serialisierung und Deserialisierung von Datensätzen. Es werden mehrere verschiedene Versionen von Serialisierung und Deserialisierung unterstützt. Dies ist vorgesehen, um nach Änderungen der Serialisierung eine reibungslose Migration der Software und des eventuell persistent gehaltenen Datenbestandes zu ermöglichen. Dies ist im Falle des Deserialisierens insbesondere dann wichtig, wenn Daten, die mit einer alten Version serialisiert wurden, wieder deserialisiert werden sollen. Im Falle des Serialisierens ist die Unterstützung von mehreren Versionen insbesondere auch dann wichtig, wenn mit einem Softwareupdate nicht notwendigerweise auch die Software aktualisiert wird, die die Daten wieder deserialisert.

Daten, die mit Serializer einer bestimmten Version serialisiert wurden, können mit einem Deserialisierer der gleichen Version wieder deserialisiert werden.

Mit den Klassen-Methoden createSerializer(java.io.OutputStream) und createDeserializer(java.io.InputStream) können Objekte zur Serialisierung bzw. zur Deserialisierung erzeugt werden.

Eine bestimmte Version der Serialisierung kann über einen entsprechenden Parameter beim Aufruf der createSerializer(int,OutputStream) Methode angefordert werden. Die createSerializer(OutputStream) Methode ohne Versions-Parameter liefert einen Serialisierer in der aktuellen Standardversion zurück (dies muss nicht zwangsweise die neueste Version sein).

Eine bestimmte Version der Deserialisierung kann über einen entsprechenden Parameter beim Aufruf der createDeserializer(int, InputStream) Methode angefordert werden. Die createDeserializer(InputStream) Methode ohne Versions-Parameter liefert einen Deserialisierer in der aktuellen Standardversion zurück (dies muss nicht zwangsweise die neueste Version sein).

Author:
Kappich Systemberatung

Method Summary
static Deserializer createDeserializer(InputStream inputStream)
          Erzeugt einen Deserialisierer in der aktuellen Standardversion.
static Deserializer createDeserializer(int version, InputStream inputStream)
          Erzeugt einen Deserialisierer einer bestimmten Version.
static Serializer createSerializer(int version, OutputStream outputStream)
          Erzeugt einen Serialisierer einer bestimmten Version.
static Serializer createSerializer(OutputStream outputStream)
          Erzeugt einen Serialisierer in der aktuellen Standardversion.
static int getDefaultVersion()
          Gibt die default-Version des Serializers zurück
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

createSerializer

public static Serializer createSerializer(OutputStream outputStream)
Erzeugt einen Serialisierer in der aktuellen Standardversion.

Parameters:
outputStream - Ausgabe-Stream auf den der zu erzeugende Serialisierer ausgeben soll.
Returns:
Serialisierer der aktuellen Standardversion.

createSerializer

public static Serializer createSerializer(int version,
                                          OutputStream outputStream)
                                   throws NoSuchVersionException
Erzeugt einen Serialisierer einer bestimmten Version.

Parameters:
version - Gewünschte Version des Serialisierers.
outputStream - Ausgabe-Stream auf den der zu erzeugende Serialisierer ausgeben soll.
Returns:
Serialisierer der gewünschten Version.
Throws:
NoSuchVersionException - Wenn die gewünschte Version des Serialisierers nicht verfügbar ist.

getDefaultVersion

public static int getDefaultVersion()
Gibt die default-Version des Serializers zurück

Returns:
default-Version des Serializers

createDeserializer

public static Deserializer createDeserializer(InputStream inputStream)
Erzeugt einen Deserialisierer in der aktuellen Standardversion.

Parameters:
inputStream - Eingabe-Stream von dem der zu erzeugende Deserialisierer einlesen soll.
Returns:
Deserialisierer der aktuellen Standardversion.

createDeserializer

public static Deserializer createDeserializer(int version,
                                              InputStream inputStream)
                                       throws NoSuchVersionException
Erzeugt einen Deserialisierer einer bestimmten Version.

Parameters:
version - Gewünschte Version des Deserialisierers.
inputStream - Eingabe-Stream von dem der zu erzeugende Deserialisierer einlesen soll.
Returns:
Deserialisierer der gewünschten Version.
Throws:
NoSuchVersionException - Wenn die gewünschte Version des Deserialisierers nicht verfügbar ist.