Package net.morimekta.providence.serializer

Class BinarySerializer

java.lang.Object

net.morimekta.providence.serializer.Serializer

net.morimekta.providence.serializer.BinarySerializer

public class BinarySerializer
extends Serializer

Compact binary serializer. This usesd a format that is as close the the default thrift binary protocol as possible.

See data definition file docs/serializer-binary.md for format spec.

Field Summary

Fields

Modifier and Type	Field	Description
static java.lang.String	ALT_MEDIA_TYPE
static java.lang.String	MEDIA_TYPE

Fields inherited from class net.morimekta.providence.serializer.Serializer

DEFAULT_STRICT

Constructor Summary

Constructors

Constructor	Description
BinarySerializer()	Construct a serializer instance.
BinarySerializer(boolean readStrict)	Construct a serializer instance.
BinarySerializer(boolean readStrict, boolean versioned)	Construct a serializer instance.

Method Summary

Modifier and Type	Method	Description
boolean	binaryProtocol()
<Message extends PMessage<Message,Field>,Field extends PField> Message	deserialize(java.io.InputStream input, PMessageDescriptor<Message,Field> descriptor)	Deserialize a message.
<Message extends PMessage<Message,Field>,Field extends PField> PServiceCall<Message,Field>	deserialize(java.io.InputStream is, PService service)	Deserialize a service call.
java.lang.String	mediaType()
<Message extends PMessage<Message,Field>,Field extends PField> int	serialize(java.io.OutputStream os, Message message)	Serialize a message.
<Message extends PMessage<Message,Field>,Field extends PField> int	serialize(java.io.OutputStream os, PServiceCall<Message,Field> call)	Serialize a service call.

Methods inherited from class java.lang.Object

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

Methods inherited from class net.morimekta.providence.serializer.Serializer

isRequestCallType

Field Detail

MEDIA_TYPE

public static final java.lang.String MEDIA_TYPE

See Also:

Constant Field Values

ALT_MEDIA_TYPE

public static final java.lang.String ALT_MEDIA_TYPE

See Also:

Constant Field Values

Constructor Detail

BinarySerializer

public BinarySerializer()

Construct a serializer instance.

BinarySerializer

public BinarySerializer(boolean readStrict)

Construct a serializer instance.

Parameters:

readStrict - If the serializer should fail on bad reading.

BinarySerializer

public BinarySerializer(boolean readStrict,
                        boolean versioned)

Construct a serializer instance. The 'versioned' param is equivalent to to the TBinaryProtocol strict flag.

Parameters:

readStrict - If the serializer should fail on reading mismatched data.

versioned - If the serializer should use the versioned service call format.

Method Detail

binaryProtocol

public boolean binaryProtocol()

Specified by:

binaryProtocol in class Serializer

Returns:

True if the protocol of the serializer is "binary" a.k.a. unreadable to most humans.

mediaType

@Nonnull
public java.lang.String mediaType()

Specified by:

mediaType in class Serializer

Returns:

Media type of the content generated by the serializer. Can be used for Content-Type and Accept HTTP headers, MIME type etc.

serialize

public <Message extends PMessage<Message,Field>,Field extends PField> int serialize(@Nonnull
                                                                                    java.io.OutputStream os,
                                                                                    @Nonnull
                                                                                    Message message)
                                                                             throws java.io.IOException

Description copied from class: Serializer

Serialize a message.

Specified by:

serialize in class Serializer

Type Parameters:

Message - The message type.

Field - The message field type.

Parameters:

os - The output stream to write to.

message - The message to write.

Returns:

The number of bytes written to the output stream.

Throws:

java.io.IOException - If writing or serialization failed.

serialize

public <Message extends PMessage<Message,Field>,Field extends PField> int serialize(@Nonnull
                                                                                    java.io.OutputStream os,
                                                                                    @Nonnull
                                                                                    PServiceCall<Message,Field> call)
                                                                             throws java.io.IOException

Description copied from class: Serializer

Serialize a service call.

Specified by:

serialize in class Serializer

Type Parameters:

Message - The message type contained in the service call.

Field - The message field type.

Parameters:

os - The output stream to write to.

call - The service call to write.

Returns:

The number of bytes written to the output stream.

Throws:

java.io.IOException - If writing or serialization failed.

deserialize

@Nonnull
public <Message extends PMessage<Message,Field>,Field extends PField> Message deserialize(@Nonnull
                                                                                          java.io.InputStream input,
                                                                                          @Nonnull
                                                                                          PMessageDescriptor<Message,Field> descriptor)
                                                                                   throws java.io.IOException

Description copied from class: Serializer

Deserialize a message.

Specified by:

deserialize in class Serializer

Type Parameters:

Message - The message type.

Field - The message field type.

Parameters:

input - The input stream to read from.

descriptor - The descriptor of the message to read.

Returns:

The message read.

Throws:

java.io.IOException - If reading or deserialization failed.

deserialize

@Nonnull
public <Message extends PMessage<Message,Field>,Field extends PField> PServiceCall<Message,Field> deserialize(@Nonnull
                                                                                                              java.io.InputStream is,
                                                                                                              @Nonnull
                                                                                                              PService service)
                                                                                                       throws java.io.IOException

Description copied from class: Serializer

Deserialize a service call.

Specified by:

deserialize in class Serializer

Type Parameters:

Message - The message type contained in the returned service call.

Field - The message field type.

Parameters:

is - The input stream to read from.

service - The service definition to read for.

Returns:

The service call read.

Throws:

java.io.IOException - If reading or deserialization failed.