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
- Alphabetic
- By Inheritance
- LWWMap
- RemovedNodePruning
- ReplicatedDataSerialization
- Serializable
- Serializable
- ReplicatedData
- AnyRef
- Any
- by any2stringadd
- by StringFormat
- by Ensuring
- by ArrowAssoc
- Hide All
- Show All
- Public
- All
Type Members
-
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
- LWWMap → ReplicatedData
Value Members
-
final
def
!=(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
final
def
##(): Int
- Definition Classes
- AnyRef → Any
-
def
+(entry: (String, A))(implicit node: Cluster): LWWMap[A]
Adds an entry to the map
-
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.
- def ->[B](y: B): (LWWMap[A], B)
-
final
def
==(arg0: Any): Boolean
- Definition Classes
- AnyRef → Any
-
final
def
asInstanceOf[T0]: T0
- Definition Classes
- Any
-
def
clone(): AnyRef
- Attributes
- protected[java.lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
- def contains(key: String): Boolean
- def ensuring(cond: (LWWMap[A]) ⇒ Boolean, msg: ⇒ Any): LWWMap[A]
- def ensuring(cond: (LWWMap[A]) ⇒ Boolean): LWWMap[A]
- def ensuring(cond: Boolean, msg: ⇒ Any): LWWMap[A]
- def ensuring(cond: Boolean): LWWMap[A]
-
def
entries: Map[String, A]
Scala API: All entries of the map.
-
final
def
eq(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
-
def
equals(o: Any): Boolean
- Definition Classes
- LWWMap → AnyRef → Any
-
def
finalize(): Unit
- Attributes
- protected[java.lang]
- Definition Classes
- AnyRef
- Annotations
- @throws( classOf[java.lang.Throwable] )
- def formatted(fmtstr: String): String
- def get(key: String): Option[A]
-
final
def
getClass(): Class[_]
- Definition Classes
- AnyRef → Any
-
def
getEntries(): Map[String, A]
Java API: All entries of the map.
-
def
hashCode(): Int
- Definition Classes
- LWWMap → AnyRef → Any
- def isEmpty: Boolean
-
final
def
isInstanceOf[T0]: Boolean
- Definition Classes
- Any
-
def
merge(that: LWWMap[A]): LWWMap[A]
Monotonic merge function.
Monotonic merge function.
- Definition Classes
- LWWMap → ReplicatedData
-
final
def
ne(arg0: AnyRef): Boolean
- Definition Classes
- AnyRef
-
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
- LWWMap → RemovedNodePruning
-
final
def
notify(): Unit
- Definition Classes
- AnyRef
-
final
def
notifyAll(): Unit
- Definition Classes
- AnyRef
-
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
- LWWMap → RemovedNodePruning
-
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
- LWWMap → RemovedNodePruning
-
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 onSystem.currentTimeMillis()
time. The timestamp can for example be an increasing version number from a database record that is used for optimistic concurrency control. -
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 onSystem.currentTimeMillis()
time. The timestamp can for example be an increasing version number from a database record that is used for optimistic concurrency control. -
def
put(node: Cluster, key: String, value: A): LWWMap[A]
Adds an entry to the map
-
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.
- def size: Int
-
final
def
synchronized[T0](arg0: ⇒ T0): T0
- Definition Classes
- AnyRef
-
def
toString(): String
- Definition Classes
- LWWMap → AnyRef → Any
-
final
def
wait(): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
final
def
wait(arg0: Long, arg1: Int): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
-
final
def
wait(arg0: Long): Unit
- Definition Classes
- AnyRef
- Annotations
- @throws( ... )
- def →[B](y: B): (LWWMap[A], B)
Shadowed Implicit Value Members
-
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