com.google.gwt.user.server.rpc.impl

Class ServerSerializationStreamWriter

java.lang.Object

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

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

com.google.gwt.user.server.rpc.impl.ServerSerializationStreamWriter

All Implemented Interfaces:

SerializationStreamWriter

public final class ServerSerializationStreamWriter
extends AbstractSerializationStreamWriter

For internal use only. Used for server call serialization. This class is carefully matched with the client-side version.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ServerSerializationStreamWriter.LengthConstrainedArray Builds a string that evaluates into an array containing the given elements.

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
ServerSerializationStreamWriter(SerializationPolicy serializationPolicy)

Method Summary

Modifier and Type	Method and Description
protected void	append(String token) Append a token to the underlying output buffer.
static String	escapeString(String toEscape) This method takes a string and outputs a JavaScript string literal.
static String	escapeStringSplitNodes(String toEscape) This method takes a string and outputs a JavaScript string literal.
protected String	getObjectTypeSignature(Object instance) Compute and return the type signature for an object.
void	prepareToWrite()
protected void	serialize(Object instance, String typeSignature) Serialize an object into the stream.
void	serializeValue(Object value, Class<?> type)
String	toString() Build an array of JavaScript string literals that can be decoded by the client via the eval function.
void	writeLong(long value)

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

addString, getAsDoubleArray, getIndexForObject, getStringTable, makeLongComponents, saveIndexForObject, writeBoolean, writeByte, writeChar, writeDouble, writeFloat, writeInt, writeObject, writeShort, writeString

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

ServerSerializationStreamWriter

public ServerSerializationStreamWriter(SerializationPolicy serializationPolicy)

Method Detail

escapeString

public static String escapeString(String toEscape)

This method takes a string and outputs a JavaScript string literal. The data is surrounded with quotes, and any contained characters that need to be escaped are mapped onto their escape sequence. Assumptions: We are targeting a version of JavaScript that that is later than 1.3 that supports unicode strings.

escapeStringSplitNodes

public static String escapeStringSplitNodes(String toEscape)

This method takes a string and outputs a JavaScript string literal. The data is surrounded with quotes, and any contained characters that need to be escaped are mapped onto their escape sequence. This splits strings into 64KB chunks to workaround an issue with the hosted mode client where the Rhino parser can't handle string nodes larger than 64KB, e.g. "longstring" is converted to "long" + "string". Assumptions: We are targeting a version of JavaScript that that is later than 1.3 that supports unicode strings.

prepareToWrite

public void prepareToWrite()

Overrides:

prepareToWrite in class AbstractSerializationStreamWriter

serializeValue

public void serializeValue(Object value,
                           Class<?> type)
                    throws SerializationException

Throws:

SerializationException

toString

public String toString()

Build an array of JavaScript string literals that can be decoded by the client via the eval function. NOTE: We build the array in reverse so the client can simply use the pop function to remove the next item from the list.

Specified by:

toString in interface SerializationStreamWriter

Specified by:

toString in class AbstractSerializationStreamWriter

Returns:

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

writeLong

public void writeLong(long value)

Specified by:

writeLong in interface SerializationStreamWriter

Specified by:

writeLong in class AbstractSerializationStreamWriter

append

protected void append(String token)

Description copied from class: AbstractSerializationStreamWriter

Append a token to the underlying output buffer.

Specified by:

append in class AbstractSerializationStreamWriter

Parameters:

token - the token to append

getObjectTypeSignature

protected String getObjectTypeSignature(Object instance)
                                 throws SerializationException

Description copied from class: AbstractSerializationStreamWriter

Compute and return the type signature for an object.

Specified by:

getObjectTypeSignature in class AbstractSerializationStreamWriter

Parameters:

instance - the instance to inspect

Returns:

the type signature of the instance

Throws:

SerializationException

serialize

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

Description copied from class: AbstractSerializationStreamWriter

Serialize an object into the stream.

Specified by:

serialize in class AbstractSerializationStreamWriter

Parameters:

instance - the object to serialize

typeSignature - the type signature of the object

Throws:

SerializationException