org.sandev.basics.DataManager
Interface StringPersistConverter

All Known Implementing Classes:
SandStringPersistConverter

public interface StringPersistConverter

Defines a converter from an unsupported persistent field type to a String. A StringPersistConverter is principally used by the DataManager to convert types which would otherwise not be possible to store as direct components of a persistent message.

Persistence directly supports int, long, double, String, Date, and references to other persistent objects. A StringPersistConverter is used for everything else.


Method Summary
 java.util.Date[] dateArrayFromString(java.lang.String source)
          Restore this array of Date values from its storage String format
 java.lang.String dateArrayToString(java.util.Date[] source)
          Convert this array of Date values into a single String for storage.
 double[] doubleArrayFromString(java.lang.String source)
          Restore this array of double values from its storage String format
 java.lang.String doubleArrayToString(double[] source)
          Convert this array of double values to a String for storage.
 CharSerializer getObjSerializer()
          Return the CharSerializer being used
 int[] intArrayFromString(java.lang.String source)
          Restore this array of int values from its storage String format
 java.lang.String intArrayToString(int[] source)
          Convert this array of int values to a String for storage.
 long[] longArrayFromString(java.lang.String source)
          Restore this array of long values from its storage String format
 java.lang.String longArrayToString(long[] source)
          Convert this array of long values to a String for storage.
 java.lang.Object[] objectArrayFromString(java.lang.String source)
          Restore this object array from its storage String format.
 java.lang.String objectArrayToString(java.lang.Object[] source)
          Convert this object array into a String for storage.
 java.lang.Object objectFromString(java.lang.String source)
          Restore this object from its storage String format.
 java.lang.String objectToString(java.lang.Object source)
          Convert this unknown object to a String for storage.
 void setObjSerializer(CharSerializer serializer)
          Set the CharSerializer to be used for serializing objects.
 java.lang.String[] stringArrayFromString(java.lang.String source)
          Restore this array of String values from its storage String format
 java.lang.String stringArrayToString(java.lang.String[] source)
          Convert this array of String values into a single String for storage.
 

Method Detail

getObjSerializer

CharSerializer getObjSerializer()
Return the CharSerializer being used


setObjSerializer

void setObjSerializer(CharSerializer serializer)
Set the CharSerializer to be used for serializing objects.


objectToString

java.lang.String objectToString(java.lang.Object source)
                                throws StringPersistConverterException
Convert this unknown object to a String for storage. The object will not be a String or Date.

Throws:
StringPersistConverterException

objectFromString

java.lang.Object objectFromString(java.lang.String source)
                                  throws StringPersistConverterException
Restore this object from its storage String format.

Throws:
StringPersistConverterException

objectArrayToString

java.lang.String objectArrayToString(java.lang.Object[] source)
                                     throws StringPersistConverterException
Convert this object array into a String for storage. The objects in the array could be String or Date.

Throws:
StringPersistConverterException

objectArrayFromString

java.lang.Object[] objectArrayFromString(java.lang.String source)
                                         throws StringPersistConverterException
Restore this object array from its storage String format.

Throws:
StringPersistConverterException

doubleArrayToString

java.lang.String doubleArrayToString(double[] source)
                                     throws StringPersistConverterException
Convert this array of double values to a String for storage.

Throws:
StringPersistConverterException

doubleArrayFromString

double[] doubleArrayFromString(java.lang.String source)
                               throws StringPersistConverterException
Restore this array of double values from its storage String format

Throws:
StringPersistConverterException

longArrayToString

java.lang.String longArrayToString(long[] source)
                                   throws StringPersistConverterException
Convert this array of long values to a String for storage.

Throws:
StringPersistConverterException

longArrayFromString

long[] longArrayFromString(java.lang.String source)
                           throws StringPersistConverterException
Restore this array of long values from its storage String format

Throws:
StringPersistConverterException

intArrayToString

java.lang.String intArrayToString(int[] source)
                                  throws StringPersistConverterException
Convert this array of int values to a String for storage.

Throws:
StringPersistConverterException

intArrayFromString

int[] intArrayFromString(java.lang.String source)
                         throws StringPersistConverterException
Restore this array of int values from its storage String format

Throws:
StringPersistConverterException

stringArrayToString

java.lang.String stringArrayToString(java.lang.String[] source)
                                     throws StringPersistConverterException
Convert this array of String values into a single String for storage.

Throws:
StringPersistConverterException

stringArrayFromString

java.lang.String[] stringArrayFromString(java.lang.String source)
                                         throws StringPersistConverterException
Restore this array of String values from its storage String format

Throws:
StringPersistConverterException

dateArrayToString

java.lang.String dateArrayToString(java.util.Date[] source)
                                   throws StringPersistConverterException
Convert this array of Date values into a single String for storage.

Throws:
StringPersistConverterException

dateArrayFromString

java.util.Date[] dateArrayFromString(java.lang.String source)
                                     throws StringPersistConverterException
Restore this array of Date values from its storage String format

Throws:
StringPersistConverterException