fdb9fcdc6a
- add link to wikipedia entry for ACID - remove persistent datastructures from Java docs - add links to scaladoc for Map and Vector
60 lines
1.9 KiB
ReStructuredText
60 lines
1.9 KiB
ReStructuredText
|
|
.. _stm-java:
|
|
|
|
#####################################
|
|
Software Transactional Memory (Java)
|
|
#####################################
|
|
|
|
|
|
Overview of STM
|
|
===============
|
|
|
|
An `STM <http://en.wikipedia.org/wiki/Software_transactional_memory>`_ turns the
|
|
Java heap into a transactional data set with begin/commit/rollback
|
|
semantics. Very much like a regular database. It implements the first three
|
|
letters in `ACID`_; ACI:
|
|
|
|
* Atomic
|
|
* Consistent
|
|
* Isolated
|
|
|
|
.. _ACID: http://en.wikipedia.org/wiki/ACID
|
|
|
|
Generally, the STM is not needed very often when working with Akka. Some
|
|
use-cases (that we can think of) are:
|
|
|
|
- When you really need composable message flows across many actors updating
|
|
their **internal local** state but need them to do that atomically in one big
|
|
transaction. Might not be often, but when you do need this then you are
|
|
screwed without it.
|
|
- When you want to share a datastructure across actors.
|
|
|
|
The use of STM in Akka is inspired by the concepts and views in `Clojure`_\'s
|
|
STM. Please take the time to read `this excellent document`_ about state in
|
|
clojure and view `this presentation`_ by Rich Hickey (the genius behind
|
|
Clojure).
|
|
|
|
.. _Clojure: http://clojure.org/
|
|
.. _this excellent document: http://clojure.org/state
|
|
.. _this presentation: http://www.infoq.com/presentations/Value-Identity-State-Rich-Hickey
|
|
|
|
|
|
Scala STM
|
|
=========
|
|
|
|
The STM supported in Akka is `ScalaSTM`_ which will be soon included in the
|
|
Scala standard library.
|
|
|
|
.. _ScalaSTM: http://nbronson.github.com/scala-stm/
|
|
|
|
The STM is based on Transactional References (referred to as Refs). Refs are
|
|
memory cells, holding an (arbitrary) immutable value, that implement CAS
|
|
(Compare-And-Swap) semantics and are managed and enforced by the STM for
|
|
coordinated changes across many Refs.
|
|
|
|
|
|
Integration with Actors
|
|
=======================
|
|
|
|
In Akka we've also integrated Actors and STM in :ref:`agents-java` and
|
|
:ref:`transactors-java`.
|