Serializer (mapdb 2.0-beta10 API)

java.lang.Object
- org.mapdb.Serializer<A>

Direct Known Subclasses:

BTreeMap.NodeSerializer, Queues.SimpleQueue.NodeSerializer, Serializer.Array, Serializer.BooleanSer, Serializer.CompressionDeflateWrapper, Serializer.CompressionWrapper, Serializer.EightByteSerializer, Serializer.FourByteSerializer, SerializerBase
```
public abstract class Serializer<A>
extends Object
```
Provides serialization and deserialization

Author:

Jan Kotek

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`Serializer.Array<T>`
`protected static class`	`Serializer.BooleanSer`
`static class`	`Serializer.CompressionDeflateWrapper<E>` wraps another serializer and (de)compresses its output/input using Deflate
`static class`	`Serializer.CompressionWrapper<E>` wraps another serializer and (de)compresses its output/input
`protected static class`	`Serializer.EightByteSerializer<E>`
`protected static class`	`Serializer.FourByteSerializer<E>`
`protected static class`	`Serializer.IntegerSerializer`
`protected static class`	`Serializer.LongSerializer`

Field Summary

Fields
Modifier and Type	Field and Description
`static Serializer<Object>`	`BASIC` Basic serializer for most classes in `java.lang` and `java.util` packages.
`static Serializer<BigDecimal>`	`BIG_DECIMAL`
`static Serializer<BigInteger>`	`BIG_INTEGER`
`static Serializer<Boolean>`	`BOOLEAN`
`static Serializer<boolean[]>`	`BOOLEAN_ARRAY`
`static Serializer<Byte>`	`BYTE`
`static Serializer<byte[]>`	`BYTE_ARRAY` Serializes `byte[]` it adds header which contains size information
`static Serializer<byte[]>`	`BYTE_ARRAY_NOSIZE` Serializes `byte[]` directly into underlying store It does not store size, so it can not be used in Maps and other collections.
`static Serializer<Character>`	`CHAR`
`static Serializer<char[]>`	`CHAR_ARRAY` Serializes `char[]` it adds header which contains size information
`static Serializer<Class<?>>`	`CLASS`
`static Serializer<Date>`	`DATE`
`static Serializer<Double>`	`DOUBLE`
`static Serializer<double[]>`	`DOUBLE_ARRAY` Serializes `double[]` it adds header which contains size information
`static Serializer<Float>`	`FLOAT`
`static Serializer<float[]>`	`FLOAT_ARRAY`
`static Serializer<Object>`	`ILLEGAL_ACCESS` Always throws `IllegalAccessError` when invoked.
`static Serializer<int[]>`	`INT_ARRAY` Serializes `int[]` it adds header which contains size information
`static Serializer<Integer>`	`INTEGER` Serializes Integer into 4 bytes, used mainly for testing.
`static Serializer<Integer>`	`INTEGER_PACKED` Packs positive Integer, so smaller positive values occupy less than 4 bytes.
`static Serializer<Integer>`	`INTEGER_PACKED_ZIGZAG` packs Integer so small values occupy less than 4 bytes.
`static Serializer<Object>`	`JAVA` Serializer which uses standard Java Serialization with `ObjectInputStream` and `ObjectOutputStream`
`static Serializer<Long>`	`LONG` Serializes Long into 8 bytes, used mainly for testing.
`static Serializer<long[]>`	`LONG_ARRAY` Serializes `long[]` it adds header which contains size information
`static Serializer<Long>`	`LONG_PACKED` Packs positive LONG, so smaller positive values occupy less than 8 bytes.
`static Serializer<Long>`	`LONG_PACKED_ZIGZAG` packs Long so small values occupy less than 8 bytes.
`static Serializer<Long>`	`RECID` Packs recid + it adds 3bits checksum.
`static Serializer<long[]>`	`RECID_ARRAY`
`static Serializer<Short>`	`SHORT`
`static Serializer<short[]>`	`SHORT_ARRAY`
`static Serializer<String>`	`STRING` Serializes strings using UTF8 encoding.
`static Serializer<String>`	`STRING_ASCII` Serializes strings using ASCII encoding (8 bit character).
`static Serializer<String>`	`STRING_INTERN` Serializes strings using UTF8 encoding.
`static Serializer<String>`	`STRING_NOSIZE` Serializes strings using UTF8 encoding.
`static Serializer<String>`	`STRING_XXHASH` Serializes strings using UTF8 encoding.
`static Serializer<UUID>`	`UUID` Serializers `UUID` class

Constructor Summary

Constructors
Constructor and Description

Serializer()

Constructors
Constructor and Description
`Serializer()`

Method Summary

Methods
Modifier and Type	Method and Description
`abstract A`	`deserialize(DataInput in, int available)` Deserialize the content of an object from a DataInput.
`boolean`	`equals(A a1, A a2)`
`int`	`fixedSize()` Data could be serialized into record with variable size or fixed size.
`BTreeKeySerializer`	`getBTreeKeySerializer(Comparator comparator)`
`int`	`hashCode(A a, int seed)`
`boolean`	`isTrusted()` MapDB has relax record size boundary checking.
`abstract void`	`serialize(DataOutput out, A value)` Serialize the content of an object into a ObjectOutput
`Object`	`valueArrayCopyOfRange(Object vals, int from, int to)`
`Object`	`valueArrayDeleteValue(Object vals, int pos)`
`Object`	`valueArrayDeserialize(DataInput in, int size)`
`Object`	`valueArrayEmpty()`
`Object`	`valueArrayFromArray(Object[] objects)`
`A`	`valueArrayGet(Object vals, int pos)`
`Object`	`valueArrayPut(Object vals, int pos, A newValue)`
`void`	`valueArraySerialize(DataOutput out, Object vals)`
`int`	`valueArraySize(Object vals)`
`Object`	`valueArrayUpdateVal(Object vals, int pos, A newValue)`

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - CHAR
```
public static final Serializer<Character> CHAR
```
  - STRING_XXHASH
```
public static final Serializer<String> STRING_XXHASH
```
    Serializes strings using UTF8 encoding. Stores string size so can be used as collection serializer. Does not handle null values
    Unlike STRING this method hashes String with more reliable XXHash.
  - STRING
```
public static final Serializer<String> STRING
```
    Serializes strings using UTF8 encoding. Stores string size so can be used as collection serializer. Does not handle null values
  - STRING_INTERN
```
public static final Serializer<String> STRING_INTERN
```
    Serializes strings using UTF8 encoding. Deserialized String is interned String.intern(), so it could save some memory. Stores string size so can be used as collection serializer. Does not handle null values
  - STRING_ASCII
```
public static final Serializer<String> STRING_ASCII
```
    Serializes strings using ASCII encoding (8 bit character). Is faster compared to UTF8 encoding. Stores string size so can be used as collection serializer. Does not handle null values
  - STRING_NOSIZE
```
public static final Serializer<String> STRING_NOSIZE
```
    Serializes strings using UTF8 encoding. Used mainly for testing. Does not handle null values.
  - LONG
```
public static final Serializer<Long> LONG
```
    Serializes Long into 8 bytes, used mainly for testing. Does not handle null values.
  - LONG_PACKED
```
public static final Serializer<Long> LONG_PACKED
```
    Packs positive LONG, so smaller positive values occupy less than 8 bytes. Large and negative values could occupy 8 or 9 bytes.
  - LONG_PACKED_ZIGZAG
```
public static final Serializer<Long> LONG_PACKED_ZIGZAG
```
    packs Long so small values occupy less than 8 bytes. Large (positive and negative) values could occupy more 8 to 9 bytes. It uses zigzag conversion before packing, number is multiplied by two, with last bite indicating negativity.
  - INTEGER
```
public static final Serializer<Integer> INTEGER
```
    Serializes Integer into 4 bytes, used mainly for testing. Does not handle null values.
  - INTEGER_PACKED
```
public static final Serializer<Integer> INTEGER_PACKED
```
    Packs positive Integer, so smaller positive values occupy less than 4 bytes. Large and negative values could occupy 4 or 5 bytes.
  - INTEGER_PACKED_ZIGZAG
```
public static final Serializer<Integer> INTEGER_PACKED_ZIGZAG
```
    packs Integer so small values occupy less than 4 bytes. Large (positive and negative) values could occupy more 4 to 5 bytes. It uses zigzag conversion before packing, number is multiplied by two, with last bite indicating negativity.
  - BOOLEAN
```
public static final Serializer<Boolean> BOOLEAN
```
  - RECID
```
public static final Serializer<Long> RECID
```
    Packs recid + it adds 3bits checksum.
  - RECID_ARRAY
```
public static final Serializer<long[]> RECID_ARRAY
```
  - ILLEGAL_ACCESS
```
public static final Serializer<Object> ILLEGAL_ACCESS
```
    Always throws IllegalAccessError when invoked. Useful for testing and assertions.
  - BYTE_ARRAY
```
public static final Serializer<byte[]> BYTE_ARRAY
```
    Serializes byte[] it adds header which contains size information
  - BYTE_ARRAY_NOSIZE
```
public static final Serializer<byte[]> BYTE_ARRAY_NOSIZE
```
    Serializes byte[] directly into underlying store It does not store size, so it can not be used in Maps and other collections.
  - CHAR_ARRAY
```
public static final Serializer<char[]> CHAR_ARRAY
```
    Serializes char[] it adds header which contains size information
  - INT_ARRAY
```
public static final Serializer<int[]> INT_ARRAY
```
    Serializes int[] it adds header which contains size information
  - LONG_ARRAY
```
public static final Serializer<long[]> LONG_ARRAY
```
    Serializes long[] it adds header which contains size information
  - DOUBLE_ARRAY
```
public static final Serializer<double[]> DOUBLE_ARRAY
```
    Serializes double[] it adds header which contains size information
  - JAVA
```
public static final Serializer<Object> JAVA
```
    Serializer which uses standard Java Serialization with ObjectInputStream and ObjectOutputStream
  - UUID
```
public static final Serializer<UUID> UUID
```
    Serializers UUID class
  - BYTE
```
public static final Serializer<Byte> BYTE
```
  - FLOAT
```
public static final Serializer<Float> FLOAT
```
  - DOUBLE
```
public static final Serializer<Double> DOUBLE
```
  - SHORT
```
public static final Serializer<Short> SHORT
```
  - BOOLEAN_ARRAY
```
public static final Serializer<boolean[]> BOOLEAN_ARRAY
```
  - SHORT_ARRAY
```
public static final Serializer<short[]> SHORT_ARRAY
```
  - FLOAT_ARRAY
```
public static final Serializer<float[]> FLOAT_ARRAY
```
  - BIG_INTEGER
```
public static final Serializer<BigInteger> BIG_INTEGER
```
  - BIG_DECIMAL
```
public static final Serializer<BigDecimal> BIG_DECIMAL
```
  - CLASS
```
public static final Serializer<Class<?>> CLASS
```
  - DATE
```
public static final Serializer<Date> DATE
```
  - BASIC
```
public static final Serializer<Object> BASIC
```
    Basic serializer for most classes in java.lang and java.util packages. It does not handle custom POJO classes. It also does not handle classes which require access to DB itself.
- Constructor Detail
  - Serializer
```
public Serializer()
```
- Method Detail
  - serialize
```
public abstract void serialize(DataOutput out,
             A value)
                        throws IOException
```
    Serialize the content of an object into a ObjectOutput
    
    Parameters:
    out - ObjectOutput to save object into
    value - Object to serialize
    
    Throws:
    
    IOException - in case of IO error
  - deserialize
```
public abstract A deserialize(DataInput in,
            int available)
                       throws IOException
```
    Deserialize the content of an object from a DataInput.
    
    Parameters:
    in - to read serialized data from
    available - how many bytes are available in DataInput for reading, may be -1 (in streams) or 0 (null).
    
    Returns:
    deserialized object
    
    Throws:
    
    IOException - in case of IO error
  - fixedSize
```
public int fixedSize()
```
    Data could be serialized into record with variable size or fixed size. Some optimizations can be applied to serializers with fixed size
    
    Returns:
    fixed size or -1 for variable size
  - isTrusted
```
public boolean isTrusted()
```
    MapDB has relax record size boundary checking. It expect deserializer to read exactly as many bytes as were writen during serialization. If deserializer reads more bytes it might start reading others record data in store.
    Some serializers (Kryo) have problems with this. To prevent this we can not read data directly from store, but must copy them into separate byte[]. So zero copy optimalizations is disabled by default, and must be explicitly enabled here.
    This flag indicates if this serializer was 'verified' to read as many bytes as it writes. It should be also much better tested etc.
    
    Returns:
    true if this serializer is well tested and writes as many bytes as it reads.
  - equals
```
public boolean equals(A a1,
             A a2)
```
  - hashCode
```
public int hashCode(A a,
           int seed)
```
  - valueArraySerialize
```
public void valueArraySerialize(DataOutput out,
                       Object vals)
                         throws IOException
```
    Throws:
    
    IOException
  - valueArrayDeserialize
```
public Object valueArrayDeserialize(DataInput in,
                           int size)
                             throws IOException
```
    Throws:
    
    IOException
  - valueArrayGet
```
public A valueArrayGet(Object vals,
              int pos)
```
  - valueArraySize
```
public int valueArraySize(Object vals)
```
  - valueArrayEmpty
```
public Object valueArrayEmpty()
```
  - valueArrayPut
```
public Object valueArrayPut(Object vals,
                   int pos,
                   A newValue)
```
  - valueArrayUpdateVal
```
public Object valueArrayUpdateVal(Object vals,
                         int pos,
                         A newValue)
```
  - valueArrayFromArray
```
public Object valueArrayFromArray(Object[] objects)
```
  - valueArrayCopyOfRange
```
public Object valueArrayCopyOfRange(Object vals,
                           int from,
                           int to)
```
  - valueArrayDeleteValue
```
public Object valueArrayDeleteValue(Object vals,
                           int pos)
```
  - getBTreeKeySerializer
```
public BTreeKeySerializer getBTreeKeySerializer(Comparator comparator)
```

Class Serializer<A>

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

CHAR

STRING_XXHASH

STRING

STRING_INTERN

STRING_ASCII

STRING_NOSIZE

LONG

LONG_PACKED

LONG_PACKED_ZIGZAG

INTEGER

INTEGER_PACKED

INTEGER_PACKED_ZIGZAG

BOOLEAN

RECID

RECID_ARRAY

ILLEGAL_ACCESS

BYTE_ARRAY

BYTE_ARRAY_NOSIZE

CHAR_ARRAY

INT_ARRAY

LONG_ARRAY

DOUBLE_ARRAY

JAVA

UUID

BYTE

FLOAT

DOUBLE

SHORT

BOOLEAN_ARRAY

SHORT_ARRAY

FLOAT_ARRAY

BIG_INTEGER

BIG_DECIMAL

CLASS

DATE

BASIC

Constructor Detail

Serializer

Method Detail

serialize

deserialize

fixedSize

isTrusted

equals

hashCode

valueArraySerialize

valueArrayDeserialize

valueArrayGet

valueArraySize

valueArrayEmpty

valueArrayPut

valueArrayUpdateVal

valueArrayFromArray

valueArrayCopyOfRange

valueArrayDeleteValue

getBTreeKeySerializer