Class Transaction.Builder

java.lang.Object

com.loomcache.server.transaction.Transaction.Builder

Enclosing class:

Transaction

public static class Transaction.Builder
extends Object

Fluent builder for constructing transactions.

Usage Example:

Transaction txn = Transaction.builder()
  .ifExists("mykey")
  .thenPut("counter", "1")
  .elsePut("counter", "0")
  .build();

Since:

1.0

Constructor Summary

Constructors

Constructor	Description
Builder()

Method Summary

Modifier and Type	Method	Description
Transaction	build()	Builds and returns the completed transaction.
Transaction.Builder	elseDelete(String key)	Add an ELSE operation: delete a key.
Transaction.Builder	elseDeleteInMap(String mapName, String key)
Transaction.Builder	elseGet(String key)	Add an ELSE operation: get a key's value.
Transaction.Builder	elseGetInMap(String mapName, String key)
Transaction.Builder	elsePut(String key, String value)	Add an ELSE operation: put a key-value pair.
Transaction.Builder	elsePutInMap(String mapName, String key, String value)
Transaction.Builder	ifExists(String key)	Adds a condition: key must exist.
Transaction.Builder	ifExistsInMap(String mapName, String key)
Transaction.Builder	ifNotExists(String key)	Adds a condition: key must not exist.
Transaction.Builder	ifNotExistsInMap(String mapName, String key)
Transaction.Builder	ifValueEquals(String key, @Nullable String expectedValue)	Adds a condition: key's value must equal the expected value.
Transaction.Builder	ifValueEqualsInMap(String mapName, String key, @Nullable String expectedValue)
Transaction.Builder	thenDelete(String key)	Adds a THEN operation: delete a key.
Transaction.Builder	thenDeleteInMap(String mapName, String key)
Transaction.Builder	thenGet(String key)	Adds a THEN operation: get and return a key's value.
Transaction.Builder	thenGetInMap(String mapName, String key)
Transaction.Builder	thenPut(String key, String value)	Adds a THEN operation: put a key-value pair.
Transaction.Builder	thenPutInMap(String mapName, String key, String value)

Methods inherited from class Object

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

Constructor Details

Builder

public Builder()

Method Details

ifExists

public Transaction.Builder ifExists(String key)

Adds a condition: key must exist.

Parameters:

key - the key to check (must not be null)

Returns:

this builder for method chaining

Throws:

NullPointerException - if key is null

ifNotExists

public Transaction.Builder ifNotExists(String key)

Adds a condition: key must not exist.

Parameters:

key - the key to check (must not be null)

Returns:

this builder for method chaining

Throws:

NullPointerException - if key is null

ifValueEquals

public Transaction.Builder ifValueEquals(String key,
 @Nullable String expectedValue)

Adds a condition: key's value must equal the expected value.

Parameters:

key - the key to check (must not be null)

expectedValue - the expected value (can be null)

Returns:

this builder for method chaining

Throws:

NullPointerException - if key is null

ifExistsInMap

public Transaction.Builder ifExistsInMap(String mapName,
 String key)

ifNotExistsInMap

public Transaction.Builder ifNotExistsInMap(String mapName,
 String key)

ifValueEqualsInMap

public Transaction.Builder ifValueEqualsInMap(String mapName,
 String key,
 @Nullable String expectedValue)

thenPut

public Transaction.Builder thenPut(String key,
 String value)

Adds a THEN operation: put a key-value pair.

Parameters:

key - the key to put (must not be null)

value - the value to set (must not be null)

Returns:

this builder for method chaining

Throws:

NullPointerException - if key or value is null

thenDelete

public Transaction.Builder thenDelete(String key)

Adds a THEN operation: delete a key.

Parameters:

key - the key to delete (must not be null)

Returns:

this builder for method chaining

Throws:

NullPointerException - if key is null

thenGet

public Transaction.Builder thenGet(String key)

Adds a THEN operation: get and return a key's value.

Parameters:

key - the key to read (must not be null)

Returns:

this builder for method chaining

Throws:

NullPointerException - if key is null

elsePut

public Transaction.Builder elsePut(String key,
 String value)

Add an ELSE operation: put a key-value pair.

Parameters:

key - the key to put

value - the value to set

Returns:

this builder for chaining

Throws:

NullPointerException - if key or value is null

elseDelete

public Transaction.Builder elseDelete(String key)

Add an ELSE operation: delete a key.

Parameters:

key - the key to delete

Returns:

this builder for chaining

Throws:

NullPointerException - if key is null

elseGet

public Transaction.Builder elseGet(String key)

Add an ELSE operation: get a key's value.

Parameters:

key - the key to read

Returns:

this builder for chaining

Throws:

NullPointerException - if key is null

thenPutInMap

public Transaction.Builder thenPutInMap(String mapName,
 String key,
 String value)

thenDeleteInMap

public Transaction.Builder thenDeleteInMap(String mapName,
 String key)

thenGetInMap

public Transaction.Builder thenGetInMap(String mapName,
 String key)

elsePutInMap

public Transaction.Builder elsePutInMap(String mapName,
 String key,
 String value)

elseDeleteInMap

public Transaction.Builder elseDeleteInMap(String mapName,
 String key)

elseGetInMap

public Transaction.Builder elseGetInMap(String mapName,
 String key)

build

public Transaction build()

Builds and returns the completed transaction.

Returns:

a new immutable Transaction with all configured conditions and operations (never null)