com.gwtplatform.dispatch.rest.client.serialization.Serialization Maven / Gradle / Ivy
/**
* Copyright 2013 ArcBees Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations under
* the License.
*/
package com.gwtplatform.dispatch.rest.client.serialization;
/**
* Offers basic serialization methods. The results depends on the implementation used.
*
* @see JsonSerialization
*/
public interface Serialization {
// Storing the parameterized type as a string works for limited use cases.
// Guice's TypeLiteral has very limited uses client-side (.equals() doesn't work).
// We may create a custom TypeLiteral that fits our need when it is required.
/**
* Verify if the given parameterized type can be serialized.
*
* @param parameterizedType the parameterized type.
* @return {@code true} if parameterizedType can be serialized, otherwise {@code false}.
*/
boolean canSerialize(String parameterizedType);
/**
* Serializes the object as a type represented by parameterizedType.
*
* @param object the object to serialized.
* @param parameterizedType the parameterized type of the object to serialize.
* @param the type of the object.
* @return the serialized object as a String.
*/
String serialize(T object, String parameterizedType);
/**
* Verify if the given parameterized type can be deserialized.
*
* @param parameterizedType the parameterized type.
* @return {@code true} if parameterizedType can be deserialized, otherwise {@code false}.
*/
boolean canDeserialize(String parameterizedType);
/**
* Deserializes the object to the type represented by parameterizedType.
*
* @param serializedObject the String representing the serialized object.
* @param parameterizedType the parameterized type of the expected return type.
* @param the return type.
* @return The deserialized object of type T.
*/
T deserialize(String serializedObject, String parameterizedType);
}