it.uniroma2.sag.kelp.utils

Interface ObjectSerializer

All Known Implementing Classes:

JacksonSerializerWrapper

public interface ObjectSerializer

It is a serializer, i.e., an object that is able to convert objects into a String representation, preserving all their properties. The serializer is then able to deserialize those textual representations to instantiate again the original serialized object

Author:

Simone Filice, Danilo Croce

Method Summary

Methods

Modifier and Type	Method and Description
<T> T	readValue(File file, Class<T> valueType) Deserializes an object that has been previously converted into a textual format
<T> T	readValue(InputStream inputStream, Class<T> valueType) Deserializes an object that has been previously converted into a textual format
<T> T	readValue(String content, Class<T> valueType) Deserializes an object that has been previously converted into a textual format
String	writeValueAsString(Object object) Converts an object into a textual representation, preserving all the object properties.
void	writeValueOnFile(Object object, String filePath) Converts an object into a textual representation, preserving all the object properties, and write this String into a file.
void	writeValueOnGzipFile(Object object, String filePath) Converts an object into a textual representation, preserving all the object properties, and write this String into a GZip file.

Method Detail

writeValueAsString

String writeValueAsString(Object object)
                          throws IOException

Converts an object into a textual representation, preserving all the object properties.

Parameters:

object - the object to be serialized

Returns:

a textual representation of object

Throws:

IOException

writeValueOnFile

void writeValueOnFile(Object object,
                    String filePath)
                      throws IOException

Converts an object into a textual representation, preserving all the object properties, and write this String into a file.

Parameters:

object - the object to be serialized

filePath - the path of the file where object must be serialized

Throws:

IOException

writeValueOnGzipFile

void writeValueOnGzipFile(Object object,
                        String filePath)
                          throws IOException

Converts an object into a textual representation, preserving all the object properties, and write this String into a GZip file.

Parameters:

object - the object to be serialized

filePath - the path of the file where object must be serialized

Throws:

IOException

readValue

<T> T readValue(String content,
              Class<T> valueType)
            throws IOException,
                   com.fasterxml.jackson.core.JsonParseException,
                   com.fasterxml.jackson.databind.JsonMappingException

Deserializes an object that has been previously converted into a textual format

Parameters:

content - the object in its textual format

valueType - the class of the object to be deserialized

Returns:

the deserialized object

Throws:

IOException

com.fasterxml.jackson.core.JsonParseException

com.fasterxml.jackson.databind.JsonMappingException

readValue

<T> T readValue(File file,
              Class<T> valueType)
            throws IOException,
                   com.fasterxml.jackson.core.JsonParseException,
                   com.fasterxml.jackson.databind.JsonMappingException

Deserializes an object that has been previously converted into a textual format

Parameters:

file - the file from which the serialized format must be read

valueType - the class of the object to be deserialized

Returns:

the deserialized object

Throws:

IOException

com.fasterxml.jackson.core.JsonParseException

com.fasterxml.jackson.databind.JsonMappingException

readValue

<T> T readValue(InputStream inputStream,
              Class<T> valueType)
            throws IOException,
                   com.fasterxml.jackson.core.JsonParseException,
                   com.fasterxml.jackson.databind.JsonMappingException

Deserializes an object that has been previously converted into a textual format

Parameters:

inputStream - the input stream from which the serialized format must be read

valueType - the class of the object to be deserialized

Returns:

the deserialized object

Throws:

IOException

com.fasterxml.jackson.core.JsonParseException

com.fasterxml.jackson.databind.JsonMappingException