com.codename1.io

Interface Externalizable

All Known Implementing Classes:

AccessToken, CachedData, CloudObject, Cookie, Receipt

public interface Externalizable

Externalizable is similar to the Java SE Externalizable interface this interface. Notice that due to the lack of reflection and use of obfuscation these objects must be registered with the Util class.
Also notice that all externalizable objects must have a default public constructor.

Built-In Object types

The externalization process supports serializing these types and considers them to be Externalizable. E.g. you can just write Storage.getInstance().writeObject(new Object[] {"Str1", "Str2"}); and it will work as expected.
Notice that while these objects can be written, the process doesn't guarantee they will be read with the same object type. E.g. if you write a LinkedList you could get back a ArrayList as both implement Collection:
String, Collection, Map, ArrayList, HashMap, Vector, Hashtable, Integer, Double, Float, Byte, Short, Long, Character, Boolean, Object[], byte[], int[], float[], long[], double[].

The sample below demonstrates the usage and registration of the Externalizable interface:

WARNING: The externalization process caches objects so the app will seem to work and only fail on restart!

Author:

Shai Almog

See Also:

Object Persistence in Codename One

Method Summary

Modifier and Type	Method and Description
void	externalize(DataOutputStream out) Allows us to store an object state, this method must be implemented in order to save the state of an object
String	getObjectId() The object id must be unique, it is used to identify the object when loaded even when it is obfuscated.
int	getVersion() Returns the version for the current persistance code, the version will be pased to internalized thus allowing the internalize method to recognize classes persisted in older revisions
void	internalize(int version, DataInputStream in) Loads the object from the input stream and allows deserialization

Method Detail

getVersion

int getVersion()

Returns the version for the current persistance code, the version will be pased to internalized thus allowing the internalize method to recognize classes persisted in older revisions

Returns:

version number for the persistant code

externalize

void externalize(DataOutputStream out)
          throws IOException

Allows us to store an object state, this method must be implemented in order to save the state of an object

Parameters:

out - the stream into which the object must be serialized

Throws:

IOException - the method may throw an exception

internalize

void internalize(int version,
                 DataInputStream in)
          throws IOException

Loads the object from the input stream and allows deserialization

Parameters:

version - the version the class returned during the externalization processs

in - the input stream used to load the class

Throws:

IOException - the method may throw an exception

getObjectId

String getObjectId()

The object id must be unique, it is used to identify the object when loaded even when it is obfuscated.

Returns:

a unique id