party.iroiro.lock

Class LockedMono.LockedMonoBuilder<T>

java.lang.Object

party.iroiro.lock.LockedMono.LockedMonoBuilder<T>

Type Parameters:

T - the Mono data type

Enclosing class:

LockedMono<R>

public class LockedMono.LockedMonoBuilder<T>
extends Object

A simple builder for fluent locking API

Example:

 Lock lock = new ReactiveLock();

 mono
     .map(t -> operationsRegardlessOfTheLock(t))
     /* Begin the lock scope */
     .as(Lock::begin)
     .map(t -> operationsWithLockAcquired(t))
     .flatMap(s -> operationsWithLockAcquired(s))
     /* Confirm to apply the above two transformations under the lock */
     .with(lock);
 

The above code is actually equivalent to the following code using Lock.withLock(Supplier).

 Lock lock = new ReactiveLock();

 mono
     .map(t -> operationsRegardlessOfTheLock(t))
     /* Begin the lock scope */
     .flatMap(t -> lock.withLock(() ->
         Mono.just(t)
             .map(t -> operationsWithLockAcquired(t))
             .flatMap(s -> operationsWithLockAcquired(s))
     ).next());
 

If you want more complex operators, please just wrap them in flatMap(Function).

Method Summary

Modifier and Type	Method and Description
<S> LockedMono.LockedMonoBuilder<S>	flatMap(Function<T,Mono<S>> flatMapper) Calling Mono.flatMap(Function) of the internal mono, with the lock held
<S> LockedMono.LockedMonoBuilder<S>	map(Function<T,S> mapper) Calling Mono.map(Function) of the internal mono, with the lock held
Mono<T>	with(Lock lock) Transforms the builder into a Mono, with previous transformations gathered into the lock scope with Lock.withLock(Supplier)
Mono<T>	withR(RWLock lock) Transforms the builder into a Mono, with previous transformations gathered into the lock scope with RWLock.withRLock(Supplier)

Methods inherited from class java.lang.Object

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

Method Detail

map

public <S> LockedMono.LockedMonoBuilder<S> map(Function<T,S> mapper)

Calling Mono.map(Function) of the internal mono, with the lock held

Type Parameters:

S - the transformed value type

Parameters:

mapper - the synchronous transforming Function

Returns:

a new LockedMono.LockedMonoBuilder

flatMap

public <S> LockedMono.LockedMonoBuilder<S> flatMap(Function<T,Mono<S>> flatMapper)

Calling Mono.flatMap(Function) of the internal mono, with the lock held

Type Parameters:

S - the transformed value type

Parameters:

flatMapper - the synchronous transforming Function

Returns:

a new LockedMono.LockedMonoBuilder

with

public Mono<T> with(Lock lock)

Transforms the builder into a Mono, with previous transformations gathered into the lock scope with Lock.withLock(Supplier)

Parameters:

lock - the lock

Returns:

a normal Mono with previous locking, transformations and unlocking applied

withR

public Mono<T> withR(RWLock lock)

Transforms the builder into a Mono, with previous transformations gathered into the lock scope with RWLock.withRLock(Supplier)

Parameters:

lock - the reader-writer lock

Returns:

a normal Mono with previous reader-locking, transformations and unlocking applied