rsb.converter

Class StringConverter

java.lang.Object

rsb.converter.StringConverter

All Implemented Interfaces:

Converter<ByteBuffer>

public class StringConverter
extends Object
implements Converter<ByteBuffer>

A converter with wire type ByteBuffer that is capable of handling strings with different encodings.

Author:

swrede, jwienke

Constructor Summary

Constructors

Constructor and Description
StringConverter() Creates a converter for UTF-8 encoding with utf-8-string wire schema.
StringConverter(Charset charset, String wireSchema) Creates a converter that uses the specified charset for strings.
StringConverter(String encoding, String wireSchema) Creates a converter that uses the specified encoding for strings.

Method Summary

Methods

Modifier and Type	Method and Description
UserData<ByteBuffer>	deserialize(String wireSchema, ByteBuffer bytes) Deserializes the data from the wire.
ConverterSignature	getSignature() Get signature for this converter.
WireContents<ByteBuffer>	serialize(Class<?> typeInfo, Object data) Serializes user data to a wire representation.

Methods inherited from class java.lang.Object

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

Constructor Detail

StringConverter

public StringConverter()

Creates a converter for UTF-8 encoding with utf-8-string wire schema.

StringConverter

public StringConverter(String encoding,
               String wireSchema)

Creates a converter that uses the specified encoding for strings.

Parameters:

encoding - encoding name for the data

wireSchema - wire schema of the serialized data

Throws:

IllegalArgumentException - invalid encoding name

StringConverter

public StringConverter(Charset charset,
               String wireSchema)

Creates a converter that uses the specified charset for strings.

Parameters:

charset - encoding for the data

wireSchema - wire schema of the serialized data

Method Detail

serialize

public WireContents<ByteBuffer> serialize(Class<?> typeInfo,
                                 Object data)
                                   throws ConversionException

Description copied from interface: Converter

Serializes user data to a wire representation.

Specified by:

serialize in interface Converter<ByteBuffer>

Parameters:

typeInfo - Java class describing the type of the data to serialize

data - data to serialize

Returns:

serialized data and generated wire schema

Throws:

ConversionException - error converting the data

deserialize

public UserData<ByteBuffer> deserialize(String wireSchema,
                               ByteBuffer bytes)
                                 throws ConversionException

Description copied from interface: Converter

Deserializes the data from the wire.

Specified by:

deserialize in interface Converter<ByteBuffer>

Parameters:

wireSchema - wire schema of the serialized data

bytes - serialized data

Returns:

deserialized data

Throws:

ConversionException - error deserializing from the wire

getSignature

public ConverterSignature getSignature()

Description copied from interface: Converter

Get signature for this converter.

Specified by:

getSignature in interface Converter<ByteBuffer>

Returns:

the @See ConverterSignature of this converter instance