final class LWWMap[A] extends ReplicatedData with ReplicatedDataSerialization with RemovedNodePruning

Specialized ORMap with LWWRegister values.

LWWRegister relies on synchronized clocks and should only be used when the choice of value is not important for concurrent updates occurring within the clock skew.

Instead of using timestamps based on System.currentTimeMillis() time it is possible to use a timestamp value based on something else, for example an increasing version number from a database record that is used for optimistic concurrency control.

The defaultClock is using max value of System.currentTimeMillis() and currentTimestamp + 1. This means that the timestamp is increased for changes on the same node that occurs within the same millisecond. It also means that it is safe to use the LWWMap without synchronized clocks when there is only one active writer, e.g. a Cluster Singleton. Such a single writer should then first read current value with ReadMajority (or more) before changing and writing the value with WriteMajority (or more).

For first-write-wins semantics you can use the LWWRegister#reverseClock instead of the LWWRegister#defaultClock

This class is immutable, i.e. "modifying" methods return a new instance.

Annotations
@SerialVersionUID()
Source
LWWMap.scala
Ordering
  1. Alphabetic
  2. By Inheritance
Inherited
  1. LWWMap
  2. RemovedNodePruning
  3. ReplicatedDataSerialization
  4. Serializable
  5. Serializable
  6. ReplicatedData
  7. AnyRef
  8. Any
Implicitly
  1. by any2stringadd
  2. by StringFormat
  3. by Ensuring
  4. by ArrowAssoc
  1. Hide All
  2. Show All
Visibility
  1. Public
  2. All

Type Members

  1. type T = LWWMap[A]

    The type of the concrete implementation, e.g.

    The type of the concrete implementation, e.g. GSet[A]. To be specified by subclass.

    Definition Classes
    LWWMapReplicatedData

Value Members

  1. final def !=(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  2. final def ##(): Int
    Definition Classes
    AnyRef → Any
  3. def +(entry: (String, A))(implicit node: Cluster): LWWMap[A]

    Adds an entry to the map

  4. def -(key: String)(implicit node: Cluster): LWWMap[A]

    Removes an entry from the map.

    Removes an entry from the map. Note that if there is a conflicting update on another node the entry will not be removed after merge.

  5. def ->[B](y: B): (LWWMap[A], B)
    Implicit
    This member is added by an implicit conversion from LWWMap[A] to ArrowAssoc[LWWMap[A]] performed by method ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc
    Annotations
    @inline()
  6. final def ==(arg0: Any): Boolean
    Definition Classes
    AnyRef → Any
  7. final def asInstanceOf[T0]: T0
    Definition Classes
    Any
  8. def clone(): AnyRef
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  9. def contains(key: String): Boolean
  10. def ensuring(cond: (LWWMap[A]) ⇒ Boolean, msg: ⇒ Any): LWWMap[A]
    Implicit
    This member is added by an implicit conversion from LWWMap[A] to Ensuring[LWWMap[A]] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  11. def ensuring(cond: (LWWMap[A]) ⇒ Boolean): LWWMap[A]
    Implicit
    This member is added by an implicit conversion from LWWMap[A] to Ensuring[LWWMap[A]] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  12. def ensuring(cond: Boolean, msg: ⇒ Any): LWWMap[A]
    Implicit
    This member is added by an implicit conversion from LWWMap[A] to Ensuring[LWWMap[A]] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  13. def ensuring(cond: Boolean): LWWMap[A]
    Implicit
    This member is added by an implicit conversion from LWWMap[A] to Ensuring[LWWMap[A]] performed by method Ensuring in scala.Predef.
    Definition Classes
    Ensuring
  14. def entries: Map[String, A]

    Scala API: All entries of the map.

  15. final def eq(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  16. def equals(o: Any): Boolean
    Definition Classes
    LWWMap → AnyRef → Any
  17. def finalize(): Unit
    Attributes
    protected[java.lang]
    Definition Classes
    AnyRef
    Annotations
    @throws( classOf[java.lang.Throwable] )
  18. def formatted(fmtstr: String): String
    Implicit
    This member is added by an implicit conversion from LWWMap[A] to StringFormat[LWWMap[A]] performed by method StringFormat in scala.Predef.
    Definition Classes
    StringFormat
    Annotations
    @inline()
  19. def get(key: String): Option[A]
  20. final def getClass(): Class[_]
    Definition Classes
    AnyRef → Any
  21. def getEntries(): Map[String, A]

    Java API: All entries of the map.

  22. def hashCode(): Int
    Definition Classes
    LWWMap → AnyRef → Any
  23. def isEmpty: Boolean
  24. final def isInstanceOf[T0]: Boolean
    Definition Classes
    Any
  25. def merge(that: LWWMap[A]): LWWMap[A]

    Monotonic merge function.

    Monotonic merge function.

    Definition Classes
    LWWMapReplicatedData
  26. final def ne(arg0: AnyRef): Boolean
    Definition Classes
    AnyRef
  27. def needPruningFrom(removedNode: UniqueAddress): Boolean

    Does it have any state changes from a specific node, which has been removed from the cluster.

    Does it have any state changes from a specific node, which has been removed from the cluster.

    Definition Classes
    LWWMapRemovedNodePruning
  28. final def notify(): Unit
    Definition Classes
    AnyRef
  29. final def notifyAll(): Unit
    Definition Classes
    AnyRef
  30. def prune(removedNode: UniqueAddress, collapseInto: UniqueAddress): LWWMap[A]

    When the removed node has been removed from the cluster the state changes from that node will be pruned by collapsing the data entries to another node.

    When the removed node has been removed from the cluster the state changes from that node will be pruned by collapsing the data entries to another node.

    Definition Classes
    LWWMapRemovedNodePruning
  31. def pruningCleanup(removedNode: UniqueAddress): LWWMap[A]

    Remove data entries from a node that has been removed from the cluster and already been pruned.

    Remove data entries from a node that has been removed from the cluster and already been pruned.

    Definition Classes
    LWWMapRemovedNodePruning
  32. def put(key: String, value: A)(implicit node: Cluster, clock: Clock[A] = defaultClock[A]): LWWMap[A]

    Adds an entry to the map.

    Adds an entry to the map.

    You can provide your clock implementation instead of using timestamps based on System.currentTimeMillis() time. The timestamp can for example be an increasing version number from a database record that is used for optimistic concurrency control.

  33. def put(node: Cluster, key: String, value: A, clock: Clock[A]): LWWMap[A]

    Adds an entry to the map.

    Adds an entry to the map.

    You can provide your clock implementation instead of using timestamps based on System.currentTimeMillis() time. The timestamp can for example be an increasing version number from a database record that is used for optimistic concurrency control.

  34. def put(node: Cluster, key: String, value: A): LWWMap[A]

    Adds an entry to the map

  35. def remove(node: Cluster, key: String): LWWMap[A]

    Removes an entry from the map.

    Removes an entry from the map. Note that if there is a conflicting update on another node the entry will not be removed after merge.

  36. def size: Int
  37. final def synchronized[T0](arg0: ⇒ T0): T0
    Definition Classes
    AnyRef
  38. def toString(): String
    Definition Classes
    LWWMap → AnyRef → Any
  39. final def wait(): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  40. final def wait(arg0: Long, arg1: Int): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  41. final def wait(arg0: Long): Unit
    Definition Classes
    AnyRef
    Annotations
    @throws( ... )
  42. def [B](y: B): (LWWMap[A], B)
    Implicit
    This member is added by an implicit conversion from LWWMap[A] to ArrowAssoc[LWWMap[A]] performed by method ArrowAssoc in scala.Predef.
    Definition Classes
    ArrowAssoc

Shadowed Implicit Value Members

  1. def +(other: String): String
    Implicit
    This member is added by an implicit conversion from LWWMap[A] to any2stringadd[LWWMap[A]] performed by method any2stringadd in scala.Predef.
    Shadowing
    This implicitly inherited member is shadowed by one or more members in this class.
    To access this member you can use a type ascription:
    (lWWMap: any2stringadd[LWWMap[A]]).+(other)
    Definition Classes
    any2stringadd

Inherited from RemovedNodePruning

Inherited from Serializable

Inherited from Serializable

Inherited from ReplicatedData

Inherited from AnyRef

Inherited from Any

Inherited by implicit conversion any2stringadd from LWWMap[A] to any2stringadd[LWWMap[A]]

Inherited by implicit conversion StringFormat from LWWMap[A] to StringFormat[LWWMap[A]]

Inherited by implicit conversion Ensuring from LWWMap[A] to Ensuring[LWWMap[A]]

Inherited by implicit conversion ArrowAssoc from LWWMap[A] to ArrowAssoc[LWWMap[A]]

Ungrouped