Class Transaction

java.lang.Object

com.loomcache.server.transaction.Transaction

public final class Transaction
extends Object

Represents an atomic compare-and-swap transaction (etcd-style mini-transaction).

Structure: A transaction consists of:

• IF: A list of conditions that must all be true (logical AND)
• THEN: Operations to execute if all conditions are met
• ELSE: Operations to execute if any condition fails

Atomicity Guarantee: The transaction is executed atomically: either all THEN operations execute, or all ELSE operations execute, but never both and never partially. This ensures consistency across distributed operations.

Use Case: Suitable for distributed consensus, leader election, version checking, and other scenarios requiring atomic conditional updates across a cluster.

Since:

1.0

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Transaction.Builder	Fluent builder for constructing transactions.
static final record	Transaction.Condition	Condition to evaluate in the IF branch of a transaction.
static enum	Transaction.ConditionType	Types of conditions that can be evaluated in the IF branch.
static final record	Transaction.Operation	Operation to execute in the THEN or ELSE branch of a transaction.
static enum	Transaction.OperationType	Types of operations that can be executed in THEN/ELSE branches.

Method Summary

Modifier and Type	Method	Description
static Transaction.Builder	builder()	Creates a new builder for fluent transaction construction.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

builder

public static Transaction.Builder builder()

Creates a new builder for fluent transaction construction.

Returns:

a new Builder instance