com.google.gwt.user.client.rpc.impl

Class AbstractSerializationStreamWriter

java.lang.Object

com.google.gwt.user.client.rpc.impl.AbstractSerializationStream

com.google.gwt.user.client.rpc.impl.AbstractSerializationStreamWriter

All Implemented Interfaces:

SerializationStreamWriter

Direct Known Subclasses:

ClientSerializationStreamWriter, ServerSerializationStreamWriter

public abstract class AbstractSerializationStreamWriter
extends AbstractSerializationStream
implements SerializationStreamWriter

Base class for the client and server serialization streams. This class handles the basic serialization and deserialization formatting for primitive types since these are common between the client and the server. It also handles Object- and String-tracking for building graph references.

Field Summary

Fields inherited from class com.google.gwt.user.client.rpc.impl.AbstractSerializationStream

DEFAULT_FLAGS, FLAG_ELIDE_TYPE_NAMES, FLAG_RPC_TOKEN_INCLUDED, RPC_SEPARATOR_CHAR, SERIALIZATION_STREAM_MIN_VERSION, SERIALIZATION_STREAM_VERSION, VALID_FLAGS_MASK

Constructor Summary

Constructors

Constructor and Description
AbstractSerializationStreamWriter()

Method Summary

Modifier and Type	Method and Description
protected int	addString(String string) Add a string to the string table and return its index.
protected abstract void	append(String token) Append a token to the underlying output buffer.
static double[]	getAsDoubleArray(long value) Return a pair of doubles { low, high } that add up to the given number, such that "low" is always between 0 and 2^32-1 inclusive and "high" is always between -2^63 and 2^63-2^32 inclusive and is a multiple of 2^32.
protected int	getIndexForObject(Object instance) Get the index for an object that may have previously been saved via saveIndexForObject(Object).
protected abstract String	getObjectTypeSignature(Object instance) Compute and return the type signature for an object.
protected List<String>	getStringTable() Gets the string table.
protected static double[]	makeLongComponents(int lowBits, int highBits)
void	prepareToWrite()
protected void	saveIndexForObject(Object instance) Remember this object as having been seen before.
protected abstract void	serialize(Object instance, String typeSignature) Serialize an object into the stream.
abstract String	toString() Serializes the contents of this stream into a string.
void	writeBoolean(boolean fieldValue)
void	writeByte(byte fieldValue)
void	writeChar(char ch)
void	writeDouble(double fieldValue)
void	writeFloat(float fieldValue)
void	writeInt(int fieldValue)
abstract void	writeLong(long value)
void	writeObject(Object instance)
void	writeShort(short value)
void	writeString(String value)

Methods inherited from class com.google.gwt.user.client.rpc.impl.AbstractSerializationStream

addFlags, areFlagsValid, getFlags, getVersion, hasFlags, setFlags, setVersion

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode

Constructor Detail

AbstractSerializationStreamWriter

public AbstractSerializationStreamWriter()

Method Detail

getAsDoubleArray

public static double[] getAsDoubleArray(long value)

Return a pair of doubles { low, high } that add up to the given number, such that "low" is always between 0 and 2^32-1 inclusive and "high" is always between -2^63 and 2^63-2^32 inclusive and is a multiple of 2^32.

makeLongComponents

protected static double[] makeLongComponents(int lowBits,
                                             int highBits)

prepareToWrite

public void prepareToWrite()

toString

public abstract String toString()

Description copied from interface: SerializationStreamWriter

Serializes the contents of this stream into a string.

Specified by:

toString in interface SerializationStreamWriter

Overrides:

toString in class Object

Returns:

a string that is the serialization of the contents of this stream

writeBoolean

public void writeBoolean(boolean fieldValue)

Specified by:

writeBoolean in interface SerializationStreamWriter

writeByte

public void writeByte(byte fieldValue)

Specified by:

writeByte in interface SerializationStreamWriter

writeChar

public void writeChar(char ch)

Specified by:

writeChar in interface SerializationStreamWriter

writeDouble

public void writeDouble(double fieldValue)

Specified by:

writeDouble in interface SerializationStreamWriter

writeFloat

public void writeFloat(float fieldValue)

Specified by:

writeFloat in interface SerializationStreamWriter

writeInt

public void writeInt(int fieldValue)

Specified by:

writeInt in interface SerializationStreamWriter

writeLong

public abstract void writeLong(long value)

Specified by:

writeLong in interface SerializationStreamWriter

writeObject

public void writeObject(Object instance)
                 throws SerializationException

Specified by:

writeObject in interface SerializationStreamWriter

Throws:

SerializationException

writeShort

public void writeShort(short value)

Specified by:

writeShort in interface SerializationStreamWriter

writeString

public void writeString(String value)

Specified by:

writeString in interface SerializationStreamWriter

addString

protected int addString(String string)

Add a string to the string table and return its index.

Parameters:

string - the string to add

Returns:

the index to the string

append

protected abstract void append(String token)

Append a token to the underlying output buffer.

Parameters:

token - the token to append

getIndexForObject

protected int getIndexForObject(Object instance)

Get the index for an object that may have previously been saved via saveIndexForObject(Object).

Parameters:

instance - the object to save

Returns:

the index associated with this object, or -1 if this object hasn't been seen before

getObjectTypeSignature

protected abstract String getObjectTypeSignature(Object instance)
                                          throws SerializationException

Compute and return the type signature for an object.

Parameters:

instance - the instance to inspect

Returns:

the type signature of the instance

Throws:

SerializationException

getStringTable

protected List<String> getStringTable()

Gets the string table.

saveIndexForObject

protected void saveIndexForObject(Object instance)

Remember this object as having been seen before.

Parameters:

instance - the object to remember

serialize

protected abstract void serialize(Object instance,
                                  String typeSignature)
                           throws SerializationException

Serialize an object into the stream.

Parameters:

instance - the object to serialize

typeSignature - the type signature of the object

Throws:

SerializationException