rsb.converter

Class StringConverter

java.lang.Object

rsb.converter.StringConverter

All Implemented Interfaces:

Converter<java.nio.ByteBuffer>

public class StringConverter
extends java.lang.Object
implements Converter<java.nio.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(java.nio.charset.Charset charset, java.lang.String wireSchema) Creates a converter that uses the specified charset for strings.
StringConverter(java.lang.String encoding, java.lang.String wireSchema) Creates a converter that uses the specified encoding for strings.

Method Summary

Methods

Modifier and Type	Method and Description
UserData<java.nio.ByteBuffer>	deserialize(java.lang.String wireSchema, java.nio.ByteBuffer bytes) Deserializes the data from the wire.
ConverterSignature	getSignature() Get signature for this converter.
WireContents<java.nio.ByteBuffer>	serialize(java.lang.Class<?> typeInfo, java.lang.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(java.lang.String encoding,
               java.lang.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:

java.lang.IllegalArgumentException - invalid encoding name

StringConverter

public StringConverter(java.nio.charset.Charset charset,
               java.lang.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<java.nio.ByteBuffer> serialize(java.lang.Class<?> typeInfo,
                                          java.lang.Object data)
                                            throws ConversionException

Description copied from interface: Converter

Serializes user data to a wire representation.

Specified by:

serialize in interface Converter<java.nio.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<java.nio.ByteBuffer> deserialize(java.lang.String wireSchema,
                                        java.nio.ByteBuffer bytes)
                                          throws ConversionException

Description copied from interface: Converter

Deserializes the data from the wire.

Specified by:

deserialize in interface Converter<java.nio.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<java.nio.ByteBuffer>

Returns:

the @See ConverterSignature of this converter instance