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

Class SerializabilityUtil

java.lang.Object

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

public class SerializabilityUtil
extends Object

Serialization utility class used by the server-side RPC code.

Field Summary

Fields

Modifier and Type	Field and Description
static Comparator<Field>	FIELD_COMPARATOR Comparator used to sort fields.

Constructor Summary

Constructors

Constructor and Description
SerializabilityUtil()

Method Summary

Modifier and Type	Method and Description
static Field[]	applyFieldSerializationPolicy(Class<?> clazz) Returns the fields of a particular class that can be considered for serialization.
static SerializedInstanceReference	decodeSerializedInstanceReference(String encodedSerializedInstanceReference)
static String	encodeSerializedInstanceReference(Class<?> instanceType, SerializationPolicy policy)
static Type	findActualType(Type unresolved, DequeMap<TypeVariable<?>,Type> resolvedTypes) Resolve type variables to concrete types if possible.
static Type[]	findExpectedParameterTypes(Class<?> instanceClass, Type expectedType, DequeMap<TypeVariable<?>,Type> resolvedTypes) Determine the expected types for any instance type parameters.
static Class<?>	getClassFromType(Type type, DequeMap<TypeVariable<?>,Type> resolvedTypes) Find the Class that a given type refers to.
static String	getSerializationSignature(Class<?> instanceType, SerializationPolicy policy)
static String	getSerializedTypeName(Class<?> instanceType)
static Class<?>	hasCustomFieldSerializer(Class<?> instanceType) Returns the Class which can serialize the given instance type, or null if this class has no custom field serializer.
static Class<?>	hasServerCustomFieldSerializer(Class<?> instanceType) Returns the server-side Class which can serialize the given instance type, or null if this class has no type-checking custom field serializer.
static void	releaseTypes(Type methodType, DequeMap<TypeVariable<?>,Type> resolvedTypes) Remove all of the actual types that arose from the given type.
static void	resolveTypes(Type methodType, DequeMap<TypeVariable<?>,Type> resolvedTypes) Find all the actual types we can from the information in the given type, and put the mapping from TypeVariable objects to actual types into the resolved types map.

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, toString

Field Detail

FIELD_COMPARATOR

public static final Comparator<Field> FIELD_COMPARATOR

Comparator used to sort fields.

Constructor Detail

SerializabilityUtil

public SerializabilityUtil()

Method Detail

applyFieldSerializationPolicy

public static Field[] applyFieldSerializationPolicy(Class<?> clazz)

Returns the fields of a particular class that can be considered for serialization. The returned list will be sorted into a canonical order to ensure consistent answers.

decodeSerializedInstanceReference

public static SerializedInstanceReference decodeSerializedInstanceReference(String encodedSerializedInstanceReference)

encodeSerializedInstanceReference

public static String encodeSerializedInstanceReference(Class<?> instanceType,
                                                       SerializationPolicy policy)

findActualType

public static Type findActualType(Type unresolved,
                                  DequeMap<TypeVariable<?>,Type> resolvedTypes)

Resolve type variables to concrete types if possible. Otherwise, just return the type variable.

Parameters:

unresolved - The type to resolve

resolvedTypes - A map of generic types to actual types.

Returns:

The actual type, which may be of any subclass of Type.

findExpectedParameterTypes

public static Type[] findExpectedParameterTypes(Class<?> instanceClass,
                                                Type expectedType,
                                                DequeMap<TypeVariable<?>,Type> resolvedTypes)

Determine the expected types for any instance type parameters. This method also determines whether or not the instance can be assigned to the expected type. We combine the tasks because they require traversing the same data structures.

Parameters:

instanceClass - The instance for which we want generic parameter types

expectedType - The type we are expecting this instance to be

resolvedTypes - The types that have been resolved to actual values

Returns:

The expected types of the instance class' parameters. If null, the instance class is not assignable to the expected type.

getClassFromType

public static Class<?> getClassFromType(Type type,
                                        DequeMap<TypeVariable<?>,Type> resolvedTypes)

Find the Class that a given type refers to.

Parameters:

type - The type of interest

Returns:

The Class that type represents

getSerializationSignature

public static String getSerializationSignature(Class<?> instanceType,
                                               SerializationPolicy policy)

getSerializedTypeName

public static String getSerializedTypeName(Class<?> instanceType)

hasCustomFieldSerializer

public static Class<?> hasCustomFieldSerializer(Class<?> instanceType)

Returns the Class which can serialize the given instance type, or null if this class has no custom field serializer. Note that arrays never have custom field serializers.

hasServerCustomFieldSerializer

public static Class<?> hasServerCustomFieldSerializer(Class<?> instanceType)

Returns the server-side Class which can serialize the given instance type, or null if this class has no type-checking custom field serializer. Note that arrays never have custom field serializers.

releaseTypes

public static void releaseTypes(Type methodType,
                                DequeMap<TypeVariable<?>,Type> resolvedTypes)

Remove all of the actual types that arose from the given type. This method should always be called after a corresponding call to resolveTypes.

Parameters:

methodType - The type we wish to assign this instance to

resolvedTypes - The types that have been resolved to actual values

resolveTypes

public static void resolveTypes(Type methodType,
                                DequeMap<TypeVariable<?>,Type> resolvedTypes)

Find all the actual types we can from the information in the given type, and put the mapping from TypeVariable objects to actual types into the resolved types map. The method releaseTypes should always be called after a call to this method, unless the resolved types map is about to be discarded.

Parameters:

methodType - The type we wish to assign this instance to

resolvedTypes - The types that have been resolved to actual values