net.java.truelicense.core.codec

Class SerializationCodec

java.lang.Object

net.java.truelicense.core.codec.SerializationCodec

All Implemented Interfaces:

Codec

@Immutable
public class SerializationCodec
extends Object
implements Codec

A codec which encodes/decodes an object with an ObjectOutputStream/ObjectInputStream.

Author:

Christian Schlichtherle

Constructor Summary

Constructors

Constructor and Description
SerializationCodec()

Method Summary

Modifier and Type	Method and Description
String	contentTransferEncoding() Returns an identifier for the content transfer encoding used by this codec.
String	contentType() Returns an identifier for the content type used by this codec.
<T> T	decode(Source source, Type expected) Decodes a nullable object graph from the given source.
void	encode(Sink sink, Object obj) Encodes a nullable object graph to the given sink.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SerializationCodec

public SerializationCodec()

Method Detail

contentTransferEncoding

public String contentTransferEncoding()

Returns an identifier for the content transfer encoding used by this codec. The returned string must conform to the syntax specified in RFC2045 "Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies", Section 6.1 "Content-Transfer-Encoding Syntax", except that it must not start with "Content-Transfer-Encoding:" and optional spaces, i.e. the field name must be stripped.

If the Content-Transfer-Encoding equals (ignoring case) "8bit" and the Content-Type does not specify a charset parameter, then UTF-8 is assumed as the charset.

The implementation in the class SerializationCodec returns "binary".

Specified by:

contentTransferEncoding in interface Codec

See Also:

RFC 2045

contentType

public String contentType()

Returns an identifier for the content type used by this codec. The returned string must conform to the syntax specified in RFC2045 "Multipurpose Internet Mail Extensions (MIME) Part One: Format of Internet Message Bodies", Section 5.1 "Syntax of the Content-Type Header Field", except that it must not start with "Content-Type:" and optional spaces, i.e. the field name must be stripped.

The implementation in the class SerializationCodec returns "application/x-java-serialized-object".

Specified by:

contentType in interface Codec

See Also:

DataFlavor

decode

@Nullable
public <T> T decode(Source source,
                              Type expected)
                       throws Exception

Description copied from interface: Codec

Decodes a nullable object graph from the given source.

Specified by:

decode in interface Codec

Type Parameters:

T - the expected generic type of the decoded object.

Parameters:

source - the source from where to read the encoded object graph from.

expected - the expected generic type of the decoded object graph, e.g. String.class. This is just a hint and the implementation may ignore it.

Returns:

A duplicate of the original object graph. Its actual type may differ from the expected generic type. It may be null if and only if the original object graph was null.

Throws:

Exception

encode

public void encode(Sink sink,
                   @Nullable
                   Object obj)
            throws Exception

Description copied from interface: Codec

Encodes a nullable object graph to the given sink.

Specified by:

encode in interface Codec

Parameters:

sink - the sink to write the encoded object graph to.

obj - the nullable object graph. Implementations should support encoding null. If they do not support this, then this should be documented in the Javadoc.

Throws:

Exception