Software Transactional Memory (STM)
Understand how Clojure's STM provides atomic, consistent, isolated, and durable (ACID) transactions for shared state.
Software Transactional Memory (STM) is a free Clojure Functional Programming & JVM Backend Development lesson on CoddyKit — lesson 2 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Clojure Functional Programming & JVM Backend Development learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.
What is Software Transactional Memory?
Imagine a bank transfer: you don't want money to disappear or appear out of thin air. You want the whole operation to succeed or fail completely.
Software Transactional Memory (STM) in Clojure provides a similar guarantee for managing shared, mutable state in concurrent programs.
- It's like a mini-database transaction system for your application's memory.
- Ensures that operations on shared data are "all or nothing."
Why We Need STM
In concurrent programming, multiple parts of your code might try to change the same piece of data at the same time. This can lead to:
- Race conditions: The outcome depends on the unpredictable timing of operations.
- Inconsistent state: Data gets corrupted or partially updated.
STM helps prevent these issues by coordinating access to shared data, ensuring data integrity.
Introducing Clojure's `Ref`s
Clojure's STM manages special data containers called Refs. Unlike regular variables, Refs are designed for transactional updates.
- A
Refholds a value that can be changed, but only within a transaction. - You create a
Refwith an initial value using(ref initial-value).
Think of a Ref as a secure vault for your data that only opens for transactions.
Atomic Updates with `dosync`
To perform operations on Refs, you must wrap them inside a dosync macro.
dosyncdefines a transaction block.- All changes to
Refs insidedosyncare treated as a single, atomic unit. - If any part of the transaction fails, all changes are rolled back.
This ensures your data remains consistent, even with concurrent access.
Modifying `Ref`s: `alter`
Inside a dosync block, you use alter to change the value of a Ref.
(alter a-ref update-fn & args)
update-fnis a function applied to the current value of theRef.& argsare additional arguments passed toupdate-fn.alterwill retry the transaction if a conflict (another transaction modifying the sameRef) is detected.
`dosync` & `alter` in Action
This example demonstrates how `dosync` and `alter` work together. We'll update a `Ref` multiple times within a transaction.
(def balance (ref 100))
(defn deposit [amount]
(dosync
(println "Current balance (inside transaction):" @balance)
(alter balance + amount)
(println "New balance (inside transaction):" @balance)))
(defn -main []
(println "Initial balance:" @balance)
(deposit 50)
(println "Final balance:" @balance))
(-main)`commute` for Independent Changes
Sometimes, the order of operations doesn't matter, like adding to a list or counting. For such operations, use commute instead of alter.
(commute a-ref update-fn & args)
commutemarks an update as "commutative."- This can reduce the chance of transaction retries, improving performance.
- It works best for operations where `(f (f x a) b)` is the same as `(f (f x b) a)`.
`commute` with Multiple Threads
Here's an example where multiple threads concurrently increment a counter using `commute`. This highlights how STM manages shared state safely and efficiently.
(def counter (ref 0))
(defn increment-counter []
(dosync
(commute counter inc)))
(defn -main []
(println "Initial counter:" @counter)
(let [futures (doall (for [_ (range 10)]
(future (dotimes [_ 100] (increment-counter)))))]
(doseq [f futures] @f)) ; Wait for all futures to complete
(println "Final counter:" @counter))
(-main)STM's ACID Guarantees
Clojure's STM provides strong guarantees, often summarized by the ACID acronym:
- Atomicity: All or nothing. A transaction either completes entirely or fails entirely.
- Consistency: Transactions bring data from one valid state to another valid state.
- Isolation: Concurrent transactions appear to execute sequentially, preventing interference.
- Durability: (Less applicable to in-memory STM directly, but implied by successful commit) Once a transaction commits, its changes are permanent.
STM Quick Check
Consider the following Clojure code snippet:
(def data (ref []))
(defn add-item [item]
(dosync
(alter data conj item)))
(add-item 10)
(add-item 20)
(println @data)What is the final output of (println @data)?
STM Recap & Beyond
In this lesson, we explored Clojure's powerful Software Transactional Memory (STM) system.
- We learned about
Refs for managing shared state. - The
dosyncmacro ensures atomic transactions. alterupdatesRefs with conflict detection and retries.commuteoptimizes updates for commutative operations.- STM provides ACID guarantees for robust concurrency.
Next, we'll look at other concurrency primitives like Promises and Futures for asynchronous operations!
Frequently asked questions
Is the “Software Transactional Memory (STM)” lesson free?
Yes — the full text of “Software Transactional Memory (STM)” is free to read here on the web, and the Clojure Functional Programming & JVM Backend Development course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Clojure Functional Programming & JVM Backend Development course, upgrade to CoddyKit PRO.
What will I learn in “Software Transactional Memory (STM)”?
Understand how Clojure's STM provides atomic, consistent, isolated, and durable (ACID) transactions for shared state. You practise Clojure Functional Programming & JVM Backend Development with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.
Do I need any experience to start Clojure Functional Programming & JVM Backend Development?
No prior experience is required. Clojure Functional Programming & JVM Backend Development on CoddyKit is structured for beginners through advanced learners; this is — lesson 2 of 4, so you can start here or from the beginning and move at your own pace.
How long does the “Software Transactional Memory (STM)” lesson take?
Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.
Can I write and run code in this Clojure Functional Programming & JVM Backend Development lesson?
Yes. Every Clojure Functional Programming & JVM Backend Development lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.
All lessons in this course
- Refs, Agents, Atoms for State
- Software Transactional Memory (STM)
- Promises, Futures & Async Operations
- core.async Channels and Go Blocks