net.openhft.chronicle.hash.serialization

Interface BytesWriter<E>

Type Parameters:

E - the type of the object marshalled

All Superinterfaces:

Serializable

All Known Subinterfaces:

BytesInterop<E>

public interface BytesWriter<E>
extends Serializable

Serializer (object to Bytes writer) which 1) knows the length of serialized form of any object before actual serialization 2) doesn't include that length in the serialized form itself, assuming it will be passed by the ChronicleHash into BytesReader.read(Bytes, long) deserialization method.

Implementation example:

 class LongPair { long first, second; }

 enum LongPairArrayWriter implements BytesWriter<LongPair[]> {
     INSTANCE;

     @Override
     public long size(LongPair[] longPairs) {
         return longPairs.length * 16L;
     }

     @Override
     public void write(Bytes bytes, LongPair[] longPairs) {
         for (LongPair pair : longPairs) {
             bytes.writeLong(pair.first);
             bytes.writeLong(pair.second);
         }
     }
 }

See Also:

BytesReader, BytesInterop

Method Summary

Methods

Modifier and Type	Method and Description
long	size(E e) Returns the length (in bytes) of the serialized form of the given object.
void	write(Bytes bytes, E e) Serializes the given object to the given bytes, without writing the length of the serialized form itself.

Method Detail

size

long size(E e)

Returns the length (in bytes) of the serialized form of the given object. Serialization form in terms of this interface, i. e. how much bytes are written to bytes on write(bytes, e) call.

Parameters:

e - the object which serialized form length should be returned

Returns:

the length (in bytes) of the serialized form of the given object

write

void write(Bytes bytes,
         E e)

Serializes the given object to the given bytes, without writing the length of the serialized form itself.

Implementation of this method should increment the bytes' position by size(e). The given object should be written into these range between the initial bytes' position and the position after this method call returns. Implementation of this method must not alter the bytes' limit and contents outside of the specified range.

Parameters:

bytes - the Bytes to write the given object to

e - the object to serialize to the given bytes

See Also:

BytesReader.read(Bytes, long)