DeltaLWWMap (Babel CRDTs 0.0.7 API)

java.lang.Object
- pt.unl.fct.di.novasys.babel.crdts.generic.CRDT
- - pt.unl.fct.di.novasys.babel.crdts.delta.generic.DeltaBasedCRDT
  - - pt.unl.fct.di.novasys.babel.crdts.delta.implementations.DeltaLWWMap

All Implemented Interfaces:

DeltaCRDT, GenericCRDT
```
public class DeltaLWWMap
extends DeltaBasedCRDT
```
A delta-based map with a last-writer-wins policy (LWW). The map supports generic types implemented as SerializableTypes. It provides methods to put, delete and get for elements. Additionally, it is possible to iterate over the different elements of the map.

Field Summary

Fields
Modifier and Type Field and Description

static pt.unl.fct.di.novasys.network.ISerializer<DeltaLWWMap> serializer
A serializer that serializes the CRDT into (and from) a ByteBuf.
- Fields inherited from class pt.unl.fct.di.novasys.babel.crdts.delta.generic.DeltaBasedCRDT
  state
- Fields inherited from class pt.unl.fct.di.novasys.babel.crdts.generic.CRDT
  type

Fields
Modifier and Type	Field and Description
`static pt.unl.fct.di.novasys.network.ISerializer<DeltaLWWMap>`	`serializer` A serializer that serializes the CRDT into (and from) a ByteBuf.

Constructor Summary

Constructors
Constructor and Description
`DeltaLWWMap(ReplicaID replicaID)` Creates a delta last-writer-wins map with a given replicaID.
`DeltaLWWMap(ReplicaID replicaID, Map<String,SerializableType> initialValues)` Creates a delta last-writer-wins map with a given replicaID and a map of initial values.
`DeltaLWWMap(VVState state)` Creates a delta last-writer-wins map with a given replica state.
`DeltaLWWMap(VVState state, Map<String,SerializableType> initialValues)` Creates a delta last-writer-wins map with a given replica state and a map of initial valeus.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`GenericCRDT`	`copy()` Creates a copy of the CRDT.
`DeltaLWWMap`	`delete(String key)` Deletes the value associated with key.
`DeltaLWWMap`	`generateDelta(VersionVector vv)` Calculates a delta from a given version for the current state
`SerializableType`	`get(String key)` Gets the element associated with the given key.
`Iterator<Map.Entry<String,SerializableType>>`	`iterator()` Returns an iterator of the elements in the map.
`DeltaLWWMap`	`mergeDelta(DeltaBasedCRDT crdt)` Applies a delta to the current state.
`DeltaLWWMap`	`put(String key, SerializableType value)` Puts a value into the map, with a given key.
`void`	`serialize(io.netty.buffer.ByteBuf in)` Serializes the CRDT into a ByteBuf

Methods inherited from class pt.unl.fct.di.novasys.babel.crdts.delta.generic.DeltaBasedCRDT
getReplicaID, getReplicaState

Methods inherited from class pt.unl.fct.di.novasys.babel.crdts.generic.CRDT
getType

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

Methods inherited from interface pt.unl.fct.di.novasys.babel.crdts.generic.GenericCRDT
deserializeDataType, getType

- Field Detail
  - serializer
```
public static pt.unl.fct.di.novasys.network.ISerializer<DeltaLWWMap> serializer
```
    A serializer that serializes the CRDT into (and from) a ByteBuf.
- Constructor Detail
  - DeltaLWWMap
```
public DeltaLWWMap(ReplicaID replicaID)
```
    Creates a delta last-writer-wins map with a given replicaID.
    
    Parameters:
    
    replicaID - the replica identifier
  - DeltaLWWMap
```
public DeltaLWWMap(VVState state)
```
    Creates a delta last-writer-wins map with a given replica state.
    
    Parameters:
    
    state - replica current state
  - DeltaLWWMap
```
public DeltaLWWMap(ReplicaID replicaID,
                   Map<String,SerializableType> initialValues)
```
    Creates a delta last-writer-wins map with a given replicaID and a map of initial values.
    
    Parameters:
    
    replicaID - the replica identifier
    
    initialValues - a map of initial values for the CRDT
  - DeltaLWWMap
```
public DeltaLWWMap(VVState state,
                   Map<String,SerializableType> initialValues)
```
    Creates a delta last-writer-wins map with a given replica state and a map of initial valeus.
    
    Parameters:
    
    state - replica current state
    
    initialValues - a map of initial values for the CRDT
- Method Detail
  - copy
```
public GenericCRDT copy()
```
    Description copied from interface: GenericCRDT
    
    Creates a copy of the CRDT. Modifications on the copy don't modify the original.
    
    Returns:
    
    a copy of the CRDT
  - put
```
public DeltaLWWMap put(String key,
                       SerializableType value)
```
    Puts a value into the map, with a given key. The value is only updated if it doesn't exist, or if the timestamp associated with the previous value is older than the current one.
    
    Parameters:
    
    key - key of the value
    
    value - element to be inserted
    
    Returns:
    
    a delta representing the operation in question
  - get
```
public SerializableType get(String key)
```
    Gets the element associated with the given key.
    
    Parameters:
    
    key - key to be searched
    
    Returns:
    
    the value associated with the key or null if it doesn't exist.
  - delete
```
public DeltaLWWMap delete(String key)
```
    Deletes the value associated with key. The value is deleted by associating a null value to the given key.
    
    Parameters:
    
    key - key to be deleted
    
    Returns:
    
    a delta representing the operation in question
  - iterator
```
public Iterator<Map.Entry<String,SerializableType>> iterator()
```
    Returns an iterator of the elements in the map.
    
    Returns:
    
    an iterator of the elements in the map.
  - generateDelta
```
public DeltaLWWMap generateDelta(VersionVector vv)
```
    Description copied from interface: DeltaCRDT
    
    Calculates a delta from a given version for the current state
    
    Specified by:
    
    generateDelta in interface DeltaCRDT
    
    Specified by:
    
    generateDelta in class DeltaBasedCRDT
    
    Parameters:
    
    vv - a version version to calculate the delta from
    
    Returns:
    
    a delta for the current state
  - mergeDelta
```
public DeltaLWWMap mergeDelta(DeltaBasedCRDT crdt)
                       throws CRDTNotValidException
```
    Description copied from interface: DeltaCRDT
    
    Applies a delta to the current state. This method is analogous to a merge of states
    
    Specified by:
    
    mergeDelta in interface DeltaCRDT
    
    Specified by:
    
    mergeDelta in class DeltaBasedCRDT
    
    Parameters:
    
    crdt - a crdt representing the delta
    
    Returns:
    
    the current state
    
    Throws:
    
    CRDTNotValidException - if the crdt passed as argument is invalid
  - serialize
```
public void serialize(io.netty.buffer.ByteBuf in)
               throws IOException
```
    Description copied from interface: GenericCRDT
    
    Serializes the CRDT into a ByteBuf
    
    Parameters:
    
    in - ByteBuf to serialize the CRDT to
    
    Throws:
    
    IOException - if an error occurs while serializing

Fields inherited from class pt.unl.fct.di.novasys.babel.crdts.delta.generic.DeltaBasedCRDT

Fields inherited from class pt.unl.fct.di.novasys.babel.crdts.generic.CRDT

Methods inherited from class pt.unl.fct.di.novasys.babel.crdts.delta.generic.DeltaBasedCRDT

Methods inherited from class pt.unl.fct.di.novasys.babel.crdts.generic.CRDT

Methods inherited from class java.lang.Object

Methods inherited from interface pt.unl.fct.di.novasys.babel.crdts.generic.GenericCRDT

serializer

DeltaLWWMap

DeltaLWWMap

DeltaLWWMap

DeltaLWWMap

copy

put

get

delete

iterator

generateDelta

mergeDelta

serialize